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
Items
Create Items
Add an item.
POST
/
accounting
/
items
curl --request POST \
--url https://api.rootfi.dev/accounting/items \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"name": "Rootfi Test Item",
"description": "Rootfi Test Item",
"type": "INVENTORY",
"code": "1234567890",
"quantity_on_hand": 0,
"bill_item": {
"account_id": "123456",
"unit_price": 100
},
"invoice_item": {
"account_id": "123456",
"unit_price": 100
}
}
]
}'
{
"data": {
"status": "SUCCESS",
"upload_job_id": "xQm2K441VosP8W4",
"data": [
{
"job_id": "aXI9pUDA5T7E2LS",
"status": "success",
"response": {
"platform_id": "3770712000001690001",
"name": "Toy Car",
"description": "Test Item description",
"type": "INVENTORY",
"code": "I02",
"quantity_on_hand": 12,
"bill_item": {
"account_id": "3770712000000076060",
"description": "Bill Item Description",
"unit_price": 10
},
"invoice_item": {
"account_id": "3770712000000000388",
"description": "Invoice Item Description",
"unit_price": 11
},
"is_bill_item": true,
"is_invoice_item": true,
"status": "ACTIVE",
"updated_at": "2023-11-01T00:00:00.000Z",
"raw_data": {
"platform_id": "123456",
"nominal_code": "Rootfi 01",
"name": "Test Account",
"description": "Test Description",
"category": "LIABILITY",
"sub_category": "Long Term Liabilities",
"status": "ACTIVE"
}
},
"error": null
}
]
},
"request_timestamp": "2021-09-28T15:00:00.000Z",
"response_timestamp": "2021-09-28T15:00:00.000Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}
The Items Data Model is designed to simplify the management and retrieval of item-related information across various accounting platforms.
curl --request POST \
--url https://api.rootfi.dev/accounting/items \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"name": "Rootfi Test Item",
"description": "Rootfi Test Item",
"type": "INVENTORY",
"code": "1234567890",
"quantity_on_hand": 0,
"bill_item": {
"account_id": "123456",
"unit_price": 100
},
"invoice_item": {
"account_id": "123456",
"unit_price": 100
}
}
]
}'
Authorizations
Body
application/json
Create items
Response
200 - application/json
The response is of type object
.
curl --request POST \
--url https://api.rootfi.dev/accounting/items \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"company_id": 1,
"data": [
{
"name": "Rootfi Test Item",
"description": "Rootfi Test Item",
"type": "INVENTORY",
"code": "1234567890",
"quantity_on_hand": 0,
"bill_item": {
"account_id": "123456",
"unit_price": 100
},
"invoice_item": {
"account_id": "123456",
"unit_price": 100
}
}
]
}'
{
"data": {
"status": "SUCCESS",
"upload_job_id": "xQm2K441VosP8W4",
"data": [
{
"job_id": "aXI9pUDA5T7E2LS",
"status": "success",
"response": {
"platform_id": "3770712000001690001",
"name": "Toy Car",
"description": "Test Item description",
"type": "INVENTORY",
"code": "I02",
"quantity_on_hand": 12,
"bill_item": {
"account_id": "3770712000000076060",
"description": "Bill Item Description",
"unit_price": 10
},
"invoice_item": {
"account_id": "3770712000000000388",
"description": "Invoice Item Description",
"unit_price": 11
},
"is_bill_item": true,
"is_invoice_item": true,
"status": "ACTIVE",
"updated_at": "2023-11-01T00:00:00.000Z",
"raw_data": {
"platform_id": "123456",
"nominal_code": "Rootfi 01",
"name": "Test Account",
"description": "Test Description",
"category": "LIABILITY",
"sub_category": "Long Term Liabilities",
"status": "ACTIVE"
}
},
"error": null
}
]
},
"request_timestamp": "2021-09-28T15:00:00.000Z",
"response_timestamp": "2021-09-28T15:00:00.000Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}