General
Server Side SDKs
Core API
- Companies
- Invite Links
- Integrations
- Sync
- Jobs
- Passthrough
Unified API
- Accounting
- Accounts
- Bank Accounts
- Bank Transactions
- Bills
- Bill Payments
- Bill Credit Notes
- Contacts
- Company Info
- Currencies
- Documents
- Expenses
- Invoice Credit Notes
- Invoices
- Invoice Payments
- Items
- Journal Entries
- Purchase Orders
- Sales Orders
- Goods Receipt Notes
- Projects
- Tax Rates
- Tracking Categories
- Balance Sheet
- Cash Flow Statements
- Income Statements
Create a journal entry
Add a journal entry.
curl --request POST \
--url https://api.rootfi.dev/accounting/journal_entries \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"document_number": "ROOTFI01",
"posted_date": "2021-09-28T15:00:00.000Z",
"description": "Test Invoice",
"currency_id": "GBP",
"journal_lines": [
{
"account_id": "123456",
"type": "DEBIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
},
{
"account_id": "123456",
"type": "CREDIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
}
]
}
]
}'
{
"data": {
"status": "SUCCESS",
"upload_job_id": "aXI9pUDA5T7E2LS",
"data": [
{
"job_id": "xQm2K441VosP8W4",
"status": "success",
"response": {
"platform_id": "3770712000001649001",
"account_id": "3770712000000000361",
"currency_id": "3770712000000000099",
"document_number": "ROOTFI01",
"description": "journal_desc",
"posted_date": "2023-06-12T00:00:00.000Z",
"amount": 568,
"currency_rate": 12,
"journal_entry_type": "both",
"updated_at": "2023-10-27T00:00:00.000Z",
"journal_lines": [
{
"platform_id": "3770712000001725038",
"journal_entry_id": "3770712000001725026",
"account_id": "3770712000000035001",
"contact_id": "3770712000000080780",
"tax_id": null,
"tracking_category_ids": [
"3770712000000000335_3770712000001122010"
],
"type": "DEBIT",
"description": "Test Description for Journal",
"net_amount": 5,
"tax_amount": null,
"updated_at": null
}
],
"raw_data": {
"platform_id": "1013",
"name": "Test",
"contact_name": "Test",
"contact_type": "CUSTOMER",
"currency_id": "1",
"status": "ARCHIVED"
}
},
"error": null
}
]
},
"request_timestamp": "2023-10-25T13:39:41.201Z",
"response_timestamp": "2023-10-25T13:39:41.201Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}
The Journal Entries are basic records of a company’s financial transactions used to record the debits and credits of each transaction.
curl --request POST \
--url https://api.rootfi.dev/accounting/journal_entries \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"document_number": "ROOTFI01",
"posted_date": "2021-09-28T15:00:00.000Z",
"description": "Test Invoice",
"currency_id": "GBP",
"journal_lines": [
{
"account_id": "123456",
"type": "DEBIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
},
{
"account_id": "123456",
"type": "CREDIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
}
]
}
]
}'
Authorizations
Body
The company ID
The accounting platform’s unique ID for the account associated with the journal entry
The ISO-4217 currency code
Reference number for the journal entry
Memo description of the journal entry
Date of creation of the journal entry
Array of Journal Entry Line items associated with the journal entry
The ID of the account in the accounting platform
The type of the journal line
DEBIT
, CREDIT
The net amount of the journal line
The ID of the contact in the accounting platform
The ID of the tax in the accounting platform
The IDs of the tracking categories in the accounting platform
The description of the journal line
A JSON containing fields that you can directly pass to the accounting platform.
A JSON containing fields that you can directly pass to the accounting platform.
Response
The status of the job.
SUCCESS
, FAILED
, CREATED
, RUNNING
The ID of the job.
The ID of the job.
The status of the job.
success
, failed
The ID that the accounting platform uses to identify this journal entry
The accounting platform’s unique ID for the account associated with the journal entry
The ISO-4217 currency code
Reference number for the journal entry
Memo description of the journal entry
Date of creation of the journal entry
The total amount of the journal entry
Rate between the currency of the payment and the base currency
Type of the journal entry
The date at which the information was updated on the accounting platform
Array of Journal Entry Line items associated with the journal entry
The accounting Platform’s ID for this journal line
The accounting Platform’s ID for this journal entry
The net amount of the journal line
The accounting platform’s unique ID for the account associated with the journal line
The accounting platform’s unique ID for the contact associated with the journal line
The accounting platform’s unique ID for the tax associated with the journal line
The accounting platform’s unique ID for the tracking category associated with the journal line
Type of the journal line. Values are credit
, debit
, unknown
.
DEBIT
, CREDIT
Description of the journal line
The tax amount of the journal line
The last ISO 8601 timestamp that the data was updated at
A JSON containing fields that you can directly pass to the accounting platform.
The raw JSON response we receive from the accounting platform for this journal entry
The time at which the request was received by the server
The time at which the response was sent by the server
The unique ID of the request
curl --request POST \
--url https://api.rootfi.dev/accounting/journal_entries \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"document_number": "ROOTFI01",
"posted_date": "2021-09-28T15:00:00.000Z",
"description": "Test Invoice",
"currency_id": "GBP",
"journal_lines": [
{
"account_id": "123456",
"type": "DEBIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
},
{
"account_id": "123456",
"type": "CREDIT",
"net_amount": 100,
"contact_id": "123456",
"tax_id": "123456",
"tracking_category_ids": [],
"description": "Test Item"
}
]
}
]
}'
{
"data": {
"status": "SUCCESS",
"upload_job_id": "aXI9pUDA5T7E2LS",
"data": [
{
"job_id": "xQm2K441VosP8W4",
"status": "success",
"response": {
"platform_id": "3770712000001649001",
"account_id": "3770712000000000361",
"currency_id": "3770712000000000099",
"document_number": "ROOTFI01",
"description": "journal_desc",
"posted_date": "2023-06-12T00:00:00.000Z",
"amount": 568,
"currency_rate": 12,
"journal_entry_type": "both",
"updated_at": "2023-10-27T00:00:00.000Z",
"journal_lines": [
{
"platform_id": "3770712000001725038",
"journal_entry_id": "3770712000001725026",
"account_id": "3770712000000035001",
"contact_id": "3770712000000080780",
"tax_id": null,
"tracking_category_ids": [
"3770712000000000335_3770712000001122010"
],
"type": "DEBIT",
"description": "Test Description for Journal",
"net_amount": 5,
"tax_amount": null,
"updated_at": null
}
],
"raw_data": {
"platform_id": "1013",
"name": "Test",
"contact_name": "Test",
"contact_type": "CUSTOMER",
"currency_id": "1",
"status": "ARCHIVED"
}
},
"error": null
}
]
},
"request_timestamp": "2023-10-25T13:39:41.201Z",
"response_timestamp": "2023-10-25T13:39:41.201Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}