Update Payable accounting fields

Allowed Scopes: experimental:accounting:update

Updates accounting fields for one Payable with optimistic locking.

The user associated with the token must have the Controller role in the company. Otherwise, the request fails with a 403 and the CONTROLLER_ROLE_REQUIRED error code.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

The ID of the Payable

Body Params
number
required

The current version of the Payable to update.

string

Description to apply to the Payable.

uuid

Account payable to apply to the Payable.

date

Date in the YYYY-MM-DD format.

lineItems
array of objects
length ≥ 1

Complete replacement for the payable line items. To preserve a line returned by GET /v1/payables/{id}, map financial.grossAmount.amount to grossAmount, expenseAccount.id to expenseAccountId, vatAccount.id or reverseChargeAccount.id to taxAccountId, costCenterId directly, and analyticalProperties fieldId/valueId pairs to analyticalFieldValues; use null only when an account or cost center should remain unassigned. A null taxAccountId is not a tax-exempt, zero-rated, or reverse-charge treatment; changing tax treatment requires the matching company tax account ID. Gross amounts must sum to the payable amount. Tax amounts are recalculated from taxAccountId, clearing manual VAT adjustments.

lineItems
amortisation
object

Prepaid-expense amortisation period to apply to the Payable.

Headers
string

ID of the company the request acts on. Required with an organisation-level token; not needed with a company-level token.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json