Update Expenses
/unified/accounting/expenses/{id}
Path Parameters
The ID of the resource.
23423523Query Parameters
Refer Specifying query parameters in Truto APIs
Show Truto-specific parameters
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79dThe format of the response.
unifiedreturns the response with unified mappings applied.rawreturns the unprocessed, raw response from the remote API.normalizedapplies the unified mappings and returns the data in a normalized format.streamreturns 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.debugreturns the final unified result alongside raw remote fetch information. The response is an envelope containingresult(identical to unified mode output) anddebug(withrequestUrl,requestOptions,data,responseHeaders, and for list operations:nextCursor,isLooping,isEmptyResult,resultCount). When the upstream body exceeds 1 MiB,datais replaced by{ truto_truncated: true, truto_max_bytes, truto_excerpt }.debugisnullfor static responses or whentruto_skip_api_call=true. An integrated account token that cannot read credentials (the kind the connect flow gives a browser) gets a403fordebug.
Defaults to unified.
unifiedunifiedrawnormalizedstreamdebug
Excludes the remote_data attribute from the response.
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.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=nameQuery parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=barRequest Body
Refer Writing data using Unified APIs
Bank or card the expense was paid from (QBO AccountRef).
3 supported1 required
Required alongside exchange_rate for a foreign-currency expense; bexio rejects the write with 'base_currency_amount is invalid' otherwise.
1 supported
Check number, when paid by check.
1 supported
Intacct entity.id.
5 supported1 required
The contact the expense was made to.
7 supported1 required
Zoho currency_id
9 supported2 required
DualEntry custom field values.
1 supported
FreeAgent ec_status. This mapping always sends one — omit it and Non-EC overwrites the stored status.
Non-ECEC GoodsEC ServicesEC VAT MOSSReverse Charge
1 supported
Non-ECEC GoodsEC ServicesEC VAT MOSSReverse ChargeId of the Intacct employee claiming the expense. Required by Intacct.
1 supported
Coupa end-date.
1 supported
Rate to the company base currency.
3 supported
Coupa expense-category on every line, by id. Coupa requires one on each expense line; set it per line to vary it.
1 supported
Coupa foreign-currency on every line, by code. Coupa requires one on each expense line.
1 supported
Intacct lines. Each maps account (glAccount), description, quantity, unit_price and total_line_amount, and needs an expense_type (Intacct expenseType), which Intacct requires on every line. Each line also carries a date, which this mapping takes from transaction_date. A line's tracking_categories entry named location or department sets that Intacct dimension. On update Intacct appends these to the expense report.
4 supported
Account NUMBER to charge. Required.
Sent as expense_description.
The unique identifier for line items
Used when description is absent.
Defaults to 1.
bexio tax id.
Used as the rate when unit_price is absent.
The type of the line item
Sent as rate. Falls back to total_line_amount, which is right only at quantity 1.
Sent as both Intacct memo and description. Intacct requires description as the expense report's reason for expense.
8 supported
Coupa title.
1 supported
1 supported
Payment method id.
1 supported
Record status to create it in.
draftpostedarchived
1 supported
draftpostedarchivedAny 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.
activearchived
1 supported
activearchivedQuickBooks version token used for optimistic locking on update. Read it from remote_data.SyncToken on a prior get/list, or omit it and we fetch it.
1 supported
Sent inside FreshBooks' amount money object.
9 supported2 required
Intacct createdDate. Omit it to leave the stored date untouched.
9 supported2 required
Id of the FreeAgent user claiming the expense. Omit it to leave the claimant untouched.
1 supported
Response Body
The unique identifier for expenses
9 supported
The company of the expense
4 supported
The contact of the expense
6 supported
This represents the date when the expense was created
7 supported
The currency of the expense
8 supported
The exchange rate of the expense
3 supported
The line items of the expense
4 supported
The account of the line item
The description of the line item
The unique identifier for line items
The name of the line item
The quantity of the line item
The tax rate of the line item
The total line amount of the line item
The type of the line item
The unit price of the line item
The memo of the expense
8 supported
Raw data returned from the remote API call.
The total amount of the expense
8 supported
The transaction date of the expense
8 supported
This represents the date when the expense was updated
6 supported
truto unified accounting expenses '<resource_id>' \
-m update \
-a '<integrated_account_id>' \
-b '{
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"remote_data": {}
}' \
-o jsonimport Truto from '@truto/truto-ts-sdk';
const truto = new Truto({
token: '<your_api_token>',
});
const result = await truto.unifiedApi.update(
'accounting',
'expenses',
'<resource_id>',
{
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"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",
"expenses",
"<resource_id>",
{
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"remote_data": {}
},
{"integrated_account_id": "<integrated_account_id>"}
)
print(result)
asyncio.run(main())curl -X PATCH 'https://api.truto.one/unified/accounting/expenses/{id}?integrated_account_id=<integrated_account_id>' \
-H 'Authorization: Bearer <your_api_token>' \
-H 'Content-Type: application/json' \
-d '{
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"remote_data": {}
}'const integratedAccountId = '<integrated_account_id>';
const body = {
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"remote_data": {}
};
const response = await fetch(`https://api.truto.one/unified/accounting/expenses/{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/expenses/{id}"
headers = {
"Authorization": "Bearer <your_api_token>",
"Content-Type": "application/json",
}
params = {
"integrated_account_id": "<integrated_account_id>"
}
payload = {
"transaction_date": "your_transaction_date",
"total_amount": 0,
"currency": "your_currency",
"memo": "your_memo",
"contact": "your_contact",
"exchange_rate": 0,
"base_currency_amount": 0,
"line_items": [],
"company": "your_company",
"account": "your_account",
"check_number": "your_check_number",
"payment_method_id": 0,
"record_status": "draft",
"custom_fields": [],
"user": "your_user",
"ec_status": "Non-EC",
"status": "active",
"sync_token": "your_sync_token",
"remote_data": {}
}
response = requests.patch(url, headers=headers, params=params, json=payload)
print(response.json())