Skip to main content
  • Unified document properties: The model unifies essential document details, such as file name, file type, file size, and platform ID, making it easier to work with documents from different platforms.
  • Document type association: Documents can be linked to specific document types (e.g., bills, invoices, expenses) using the document_type_id and document_type properties, facilitating easy retrieval and organisation of documents.
  • File metadata: The model includes file type (MIME Type) and file size properties, enabling developers to handle documents appropriately and ensure compatibility with their applications.
  • Document upload status: When you request for a document to be downloaded, RootFi will download the document then cache the document on to its servers so future calls to download the document will be faster. The document_uploaded property indicates whether RootFi has uploaded the document to its servers.
Downloading the DocumentAfter initially syncing the documents data document_uploaded will be false for all the documents. To download the document you must call the Download Documents API. This API will download the document and return a temporary download_url. Subsequent calls to download the document will be faster as the document will be cached on RootFi’s servers.

​
Properties Supported

PropertyTypeDescription
platform_idstringThe Platform’s ID for the document
file_namestringName of the document that was used on the accounting platform
file_typestringThe file type of the document as given by the accounting platform. Formatted as a MIME Type
file_sizefloatThe file size of the document in bytes
document_type_idstringThe platform ID of the document type with which this document is linked to
document_typeenumThe name of the data model with which this document is linked. Values are: BILLS, INVOICES, EXPENSES, BILL_CREDIT_NOTES, INVOICE_CREDIT_NOTES, PURCHASE_ORDERS, SALES_ORDERS, JOURNAL_ENTRIES
document_uploadedbooleanA value to verify that RootFi has uploaded the document to it’s servers
updated_atdateThe date at which the information was updated on the accounting platform
{
  "platform_id": "3770712000000085065_3770712000000080327",
  "document_type_id": "3770712000000080327",
  "file_name": "Documents.csv",
  "file_type": "text/csv",
  "file_size": 254.8828125,
  "document_type": "INVOICES",
  "document_uploaded": false,
  "updated_at": "2021-03-03T10:00:00.000Z"
}