Update transaction
Update a transaction’s status, reference ID, and tax amount. For draft transactions, also update line items, discounts, currency, and transaction date.
Partial updates
This endpoint only updates the fields you provide; omitted fields are left unchanged.Draft-only fields
These fields can only be updated while the transaction is indraft status, and updating any of them re-runs the tax calculation:
line_items— provide the full list. It replaces the existing line items entirely; there are no partial line-item updates. Use it to add, remove, or edit line items.discount_amount,vendor_discount_amountcurrencytransaction_date
currency we do not support returns 422, as on create, and so does a value containing a NUL character (\u0000).
Once a transaction is finalized, attempting to update any of these returns 400. To edit them, first move the transaction back to draft with { "status": "draft" }, make your changes, and re-finalize.Body
Update transaction request model.
Response
Successful Response
Transaction response model.
Amount of tax collected to be reported, filed, and remitted. Defaults to tax_amount if provided, otherwise the tax recorded as collected on the transaction, otherwise tax_calculation.tax_amount. The collected tax can differ from tax_calculation.tax_amount, e.g. after a finalized transaction is recalculated, or on a credit limited to its parent's remaining tax
"100"
Amount of discount applied to the vendor in the transaction. Most of the time, you should use the discount_amount field instead. Unlike discount_amount, this discount is funded by the vendor and typically does not reduce the taxable base of the transaction. Amount is expressed in the currency of the transaction and in denominations of the smallest unit of the currency, such as cents for USD. e.g: "100" would be 100 cents or $1.00 in a USD transaction.
"100"
Date and time for the tax calculation. Timezone is required for better accuracy. Use the ISO 8601 format. e.g: 2024-03-15T12:00:00Z. If not provided, the current UTC date and time will be used.
"2024-03-15T12:00:00Z"