Skip to content
PATCH /unified/accounting/items/{id}

Path Parameters

idstring
required·

The ID of the resource.

Example: 23423523

Query Parameters

Refer Specifying query parameters in Truto APIs

etagstring

Optional. Business Central needs it for the If-Match header. If left out, it is read from the record automatically.

1 supported
Microsoft Dynamics 365 Business Central
supported
Show Truto-specific parameters
integrated_account_idstring · uuid
required·

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_formatstring

The format of the response.

  • unified returns the response with unified mappings applied.
  • raw returns the unprocessed, raw response from the remote API.
  • normalized applies the unified mappings and returns the data in a normalized format.
  • stream returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.
  • debug returns the final unified result alongside raw remote fetch information. The response is an envelope containing result (identical to unified mode output) and debug (with requestUrl, requestOptions, data, responseHeaders, and for list operations: nextCursor, isLooping, isEmptyResult, resultCount). When the upstream body exceeds 1 MiB, data is replaced by { truto_truncated: true, truto_max_bytes, truto_excerpt }. debug is null for static responses or when truto_skip_api_call=true. An integrated account token that cannot read credentials (the kind the connect flow gives a browser) gets a 403 for debug.

Defaults to unified.

Example: unified
Possible values:
unifiedrawnormalizedstreamdebug
truto_ignore_remote_databoolean

Excludes the remote_data attribute from the response.

truto_enforce_write_schemaboolean

Validates the request body against this method's request_body_schema before the request is sent to the underlying integration. When a field marked required is missing, Truto responds 400 with the missing field names under truto_error_insight.missing_required_body_fields instead of forwarding the call. Only the fields documented in request_body_schema are checked. A body carrying a non-empty remote_data object is forwarded unchecked, because remote_data is merged into the provider request and may already carry the required values. A field the mapping always supplies through its default body is treated as present, and a field that is only conditionally required is reported under truto_error_insight.conditionally_required_body_fields rather than rejected. Some integrations declare fields required on update that the provider only requires on create; check meta/{method} for the resource before enabling this on update calls. If you sent an Idempotency-Key and the request was rejected, use a fresh key when you retry with a corrected body: the idempotency cache is keyed on the integrated account, path and key only — it ignores the query string and the body — so reusing the key replays the rejection. Defaults to false, which forwards the request as-is.

truto_exclude_fieldsstring[]

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_queryRecord<string, any>

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

Request Body

Refer Writing data using Unified APIs

idstring
required·

Only send this to change the item code. The item being updated is identified by the URL.

14 supported
Bexio
supported
Brightpearl
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
Odoo
supported
QuickBooks
supported
Rillet
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
asset_accountstring

Brightpearl nominalCodeStock.

1 supported
QuickBooks
supported
brand_idstring

Brightpearl brandId.

1 supported
Brightpearl
supported
category_codestring

Brightpearl categoryCode.

1 supported
Brightpearl
supported
codestring

Maps to bexio intern_code.

1 supported
Bexio
supported
companystring

Intacct entity.id.

References: CompanyInfo → id
6 supported
ERPNext
supported
FreeAgent
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
Sage Intacct
supported
Zoho Books
supported
currencystring

Three-letter code for the price, e.g. USD.

2 supported1 required
Rillet
required
FreshBooks
supported
descriptionstring

Intacct extendedDescription.

10 supported
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
hsn_code

ERPNext gst_hsn_code. Must be 6 or 8 digits. Required on sites running the India Compliance app.

1 supported
ERPNext
supported
include_in_arr_mrrboolean

Defaults to true.

1 supported
Rillet
supported
interval_monthsinteger

Billing interval. FIXED_RECURRING only.

1 supported
Rillet
supported
item_group

ERPNext item_group.

1 supported
ERPNext
supported
item_typestring

FreeAgent item_type. This mapping always sends one — omit it and Products overwrites the stored type.

Possible values:
HoursDaysWeeksMonthsYearsProductsServicesTrainingExpensesCommentBillsDiscount+ 3 more
1 supported
FreeAgent
supported
HoursDaysWeeksMonthsYearsProductsServicesTrainingExpensesCommentBillsDiscount+ 3 more
namestring

Intacct name.

12 supported1 required
Rillet
required
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
number

BC item number, the human code (max 20 chars). Omit it and BC auto-numbers.

1 supported
Microsoft Dynamics 365 Business Central
supported
price_typestring

Defaults to ONE_TIME. FIXED_RECURRING needs interval_months alongside it.

Possible values:
ONE_TIMEFIXED_RECURRING
1 supported
Rillet
supported
ONE_TIMEFIXED_RECURRING
product_groupstring

Material group.

1 supported
SAP S/4HANA
supported
product_typestring
Possible values:
productservicedigital_service
1 supported
Moneybird
supported
productservicedigital_service
purchase_accountstring

The account code used to record the purchase.

4 supported
Bexio
supported
QuickBooks
supported
Xero
supported
Zoho Books
supported
purchase_pricenumber

The purchase unit price. Sending it marks the item as purchased in Xero.

7 supported
Bexio
supported
ERPNext
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
Xero
supported
Zoho Books
supported
quantitynumber

FreeAgent quantity. FreeAgent merges what you send, but this mapping always sends a quantity — omit it and 1 overwrites the stored value.

6 supported
Bexio
supported
FreeAgent
supported
FreshBooks
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Zoho Books
supported
remote_dataRecord<string, any>

Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

revenue_patternstring

How revenue is recognized. Rillet requires it on a standalone product and rejects it on a bundle.

Possible values:
DAILYEVEN_PERIODPROGRESS
1 supported1 required
Rillet
required
DAILYEVEN_PERIODPROGRESS
sales_accountstring

The account code used to record the sale.

6 supported
Bexio
supported
FreeAgent
supported
Moneybird
supported
QuickBooks
supported
Xero
supported
Zoho Books
supported
skustring

Brightpearl identity.sku. Max 32 characters.

1 supported
Brightpearl
supported
statusstring

archived sets the deletion flag (SAP has no product delete API).

Possible values:
activearchivedactivearchivedactivearchivedactivearchivedactivearchivedactivearchived+ 4 more
9 supported
ERPNext
supported
activearchived
FreshBooks
supported
activearchived
Microsoft Dynamics 365 Business Central
supported
activearchived
QuickBooks
supported
activearchived
Sage Intacct
supported
activearchived
SAP S/4HANA
supported
activearchived
Bexio
supported
Moneybird
supported
Zoho Books
supported
stock_uom

ERPNext stock_uom.

1 supported
ERPNext
supported
sync_tokenstring

QuickBooks version token used for optimistic locking on update. Read it from remote_data.SyncToken on a prior get/list.

1 supported1 required
QuickBooks
required
tax_codestring

BC taxGroupCode.

2 supported
Brightpearl
supported
Microsoft Dynamics 365 Business Central
supported
tax_ratestring

Moneybird tax rate id.

1 supported
Moneybird
supported
tax_ratesstring[]

Wave defaultSalesTaxIds. Replaces the existing set.

1 supported
Wave
supported
typestring

Defaults to PRODUCT. Cannot be changed after creation.

Possible values:
InventoryServiceNon-InventoryPRODUCTBUNDLE
2 supported
Microsoft Dynamics 365 Business Central
supported
InventoryServiceNon-Inventory
Rillet
supported
PRODUCTBUNDLE
unit_pricenumber

The sales unit price. Sending it marks the item as sold in Xero.

11 supported1 required
Rillet
required
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
Xero
supported
Zoho Books
supported
user_idinteger

bexio user id that owns the article.

1 supported
Bexio
supported
vat_rate_typestring
Possible values:
standardreduced
1 supported
Moneybird
supported
standardreduced

Response Body

idstring
required·

The unique identifier for the item

14 supported
Bexio
supported
Brightpearl
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
Odoo
supported
QuickBooks
supported
Rillet
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
asset_accountstring

The ID of the account used to record the asset

1 supported
QuickBooks
supported
companystring

The ID of the company the item belongs to

References: CompanyInfo → id
6 supported
ERPNext
supported
FreeAgent
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
Sage Intacct
supported
Zoho Books
supported
created_atstring · date-time

This represents the date when the item was created

7 supported
ERPNext
supported
FreeAgent
supported
Moneybird
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Zoho Books
supported
descriptionstring

The description of the item

10 supported
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
namestring

The name of the item

11 supported
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
purchase_accountstring

The ID of the account used to record the purchase of the item

4 supported
Bexio
supported
QuickBooks
supported
Xero
supported
Zoho Books
supported
purchase_pricenumber

The purchase price of the item

7 supported
Bexio
supported
ERPNext
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
Xero
supported
Zoho Books
supported
quantitynumber

The quantity of the Item.

6 supported
Bexio
supported
FreeAgent
supported
FreshBooks
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Zoho Books
supported
remote_dataRecord<string, any>

Raw data returned from the remote API call.

sales_accountstring

The ID of the account used to record the sale

6 supported
Bexio
supported
FreeAgent
supported
Moneybird
supported
QuickBooks
supported
Xero
supported
Zoho Books
supported
statusstring

The status of the item. If no clear mapping exists, then raw value is returned

Possible values:
activearchived
9 supported
Bexio
supported
ERPNext
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Zoho Books
supported
unit_pricenumber

The unit price of the item

10 supported
Bexio
supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
Xero
supported
Zoho Books
supported
updated_atstring · date-time

This represents the date when the item was updated

10 supported
ERPNext
supported
FreeAgent
supported
FreshBooks
supported
Moneybird
supported
Microsoft Dynamics 365 Business Central
supported
QuickBooks
supported
Sage Intacct
supported
SAP S/4HANA
supported
Xero
supported
Zoho Books
supported
truto unified accounting items '<resource_id>' \
  -m update \
  -a '<integrated_account_id>' \
  -b '{
  "name": "your_name",
  "description": "your_description",
  "unit_price": 0,
  "purchase_price": 0,
  "sales_account": "your_sales_account",
  "purchase_account": "your_purchase_account",
  "code": "your_code",
  "user_id": 0,
  "asset_account": "your_asset_account",
  "brand_id": "your_brand_id",
  "category_code": "your_category_code",
  "tax_code": "your_tax_code",
  "sku": "your_sku",
  "status": "active",
  "quantity": 0,
  "item_type": "Hours",
  "currency": "your_currency",
  "tax_rate": "your_tax_rate",
  "product_type": "product",
  "vat_rate_type": "standard",
  "type": "Inventory",
  "sync_token": "your_sync_token",
  "price_type": "ONE_TIME",
  "interval_months": 0,
  "revenue_pattern": "DAILY",
  "include_in_arr_mrr": true,
  "company": "your_company",
  "product_group": "your_product_group",
  "tax_rates": [],
  "id": "your_id",
  "remote_data": {}
}' \
  -o json
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

const result = await truto.unifiedApi.update(
  'accounting',
  'items',
  '<resource_id>',
  {
  "name": "your_name",
  "description": "your_description",
  "unit_price": 0,
  "purchase_price": 0,
  "sales_account": "your_sales_account",
  "purchase_account": "your_purchase_account",
  "code": "your_code",
  "user_id": 0,
  "asset_account": "your_asset_account",
  "brand_id": "your_brand_id",
  "category_code": "your_category_code",
  "tax_code": "your_tax_code",
  "sku": "your_sku",
  "status": "active",
  "quantity": 0,
  "item_type": "Hours",
  "currency": "your_currency",
  "tax_rate": "your_tax_rate",
  "product_type": "product",
  "vat_rate_type": "standard",
  "type": "Inventory",
  "sync_token": "your_sync_token",
  "price_type": "ONE_TIME",
  "interval_months": 0,
  "revenue_pattern": "DAILY",
  "include_in_arr_mrr": true,
  "company": "your_company",
  "product_group": "your_product_group",
  "tax_rates": [],
  "id": "your_id",
  "remote_data": {}
},
  { integrated_account_id: '<integrated_account_id>' }
);

console.log(result);
import asyncio
from truto_python_sdk import TrutoApi

truto_api = TrutoApi(token="<your_api_token>")

async def main():
    result = await truto_api.unified_api.update(
        "accounting",
        "items",
        "<resource_id>",
        {
        "name": "your_name",
        "description": "your_description",
        "unit_price": 0,
        "purchase_price": 0,
        "sales_account": "your_sales_account",
        "purchase_account": "your_purchase_account",
        "code": "your_code",
        "user_id": 0,
        "asset_account": "your_asset_account",
        "brand_id": "your_brand_id",
        "category_code": "your_category_code",
        "tax_code": "your_tax_code",
        "sku": "your_sku",
        "status": "active",
        "quantity": 0,
        "item_type": "Hours",
        "currency": "your_currency",
        "tax_rate": "your_tax_rate",
        "product_type": "product",
        "vat_rate_type": "standard",
        "type": "Inventory",
        "sync_token": "your_sync_token",
        "price_type": "ONE_TIME",
        "interval_months": 0,
        "revenue_pattern": "DAILY",
        "include_in_arr_mrr": True,
        "company": "your_company",
        "product_group": "your_product_group",
        "tax_rates": [],
        "id": "your_id",
        "remote_data": {}
},
        {"integrated_account_id": "<integrated_account_id>"}
    )
    print(result)

asyncio.run(main())
curl -X PATCH 'https://api.truto.one/unified/accounting/items/{id}?integrated_account_id=<integrated_account_id>' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "your_name",
  "description": "your_description",
  "unit_price": 0,
  "purchase_price": 0,
  "sales_account": "your_sales_account",
  "purchase_account": "your_purchase_account",
  "code": "your_code",
  "user_id": 0,
  "asset_account": "your_asset_account",
  "brand_id": "your_brand_id",
  "category_code": "your_category_code",
  "tax_code": "your_tax_code",
  "sku": "your_sku",
  "status": "active",
  "quantity": 0,
  "item_type": "Hours",
  "currency": "your_currency",
  "tax_rate": "your_tax_rate",
  "product_type": "product",
  "vat_rate_type": "standard",
  "type": "Inventory",
  "sync_token": "your_sync_token",
  "price_type": "ONE_TIME",
  "interval_months": 0,
  "revenue_pattern": "DAILY",
  "include_in_arr_mrr": true,
  "company": "your_company",
  "product_group": "your_product_group",
  "tax_rates": [],
  "id": "your_id",
  "remote_data": {}
}'
const integratedAccountId = '<integrated_account_id>';

const body = {
  "name": "your_name",
  "description": "your_description",
  "unit_price": 0,
  "purchase_price": 0,
  "sales_account": "your_sales_account",
  "purchase_account": "your_purchase_account",
  "code": "your_code",
  "user_id": 0,
  "asset_account": "your_asset_account",
  "brand_id": "your_brand_id",
  "category_code": "your_category_code",
  "tax_code": "your_tax_code",
  "sku": "your_sku",
  "status": "active",
  "quantity": 0,
  "item_type": "Hours",
  "currency": "your_currency",
  "tax_rate": "your_tax_rate",
  "product_type": "product",
  "vat_rate_type": "standard",
  "type": "Inventory",
  "sync_token": "your_sync_token",
  "price_type": "ONE_TIME",
  "interval_months": 0,
  "revenue_pattern": "DAILY",
  "include_in_arr_mrr": true,
  "company": "your_company",
  "product_group": "your_product_group",
  "tax_rates": [],
  "id": "your_id",
  "remote_data": {}
};

const response = await fetch(`https://api.truto.one/unified/accounting/items/{id}?integrated_account_id=${integratedAccountId}`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(body),
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/unified/accounting/items/{id}"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
    "integrated_account_id": "<integrated_account_id>"
}
payload = {
    "name": "your_name",
    "description": "your_description",
    "unit_price": 0,
    "purchase_price": 0,
    "sales_account": "your_sales_account",
    "purchase_account": "your_purchase_account",
    "code": "your_code",
    "user_id": 0,
    "asset_account": "your_asset_account",
    "brand_id": "your_brand_id",
    "category_code": "your_category_code",
    "tax_code": "your_tax_code",
    "sku": "your_sku",
    "status": "active",
    "quantity": 0,
    "item_type": "Hours",
    "currency": "your_currency",
    "tax_rate": "your_tax_rate",
    "product_type": "product",
    "vat_rate_type": "standard",
    "type": "Inventory",
    "sync_token": "your_sync_token",
    "price_type": "ONE_TIME",
    "interval_months": 0,
    "revenue_pattern": "DAILY",
    "include_in_arr_mrr": True,
    "company": "your_company",
    "product_group": "your_product_group",
    "tax_rates": [],
    "id": "your_id",
    "remote_data": {}
}

response = requests.patch(url, headers=headers, params=params, json=payload)
print(response.json())