Documents
Overview
The Documents Data Model simplifies the handling of document documents across various accounting platforms, providing a standardised approach to accessing and managing document-related information.
- 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
anddocument_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 Document
After 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
Property | Type | Description |
---|---|---|
platform_id | string | The Platform’s ID for the document |
file_name | string | Name of the document that was used on the accounting platform |
file_type | string | The file type of the document as given by the accounting platform. Formatted as a MIME Type |
file_size | float | The file size of the document in bytes |
document_type_id | string | The platform ID of the document type with which this document is linked to |
document_type | enum | The 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_uploaded | boolean | A value to verify that RootFi has uploaded the document to it’s servers |
updated_at | date | The date at which the information was updated on the accounting platform |