Update invoice V3

patch

https://{xentralId}.xentral.biz/api/v3/invoices/{id}

This endpoint requires the following scopes: invoice:update.

Update an invoice. Line items can be written inline through lineItems: an entry with an id updates, an entry without one creates, an entry with deleted: true deletes. The response body carries the updated line items and tags, so an inline-created line item comes back with its new id.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

address

object

The business partner the document is issued to. Re-pointing it to a different partner re-derives every partner-dependent value from the new partner: documentAddress, project, language, taxation, tax rates, payment method and terms, VAT ID, delivery terms, shipping method, preferred warehouse, sales representative, editor, and the line item discounts. Line item prices and the document currency are deliberately kept unchanged, so negotiated prices survive the change. Fields sent in the same request take precedence over the derived values; a project sent alongside also replaces the one the new partner would bring, and the project-dependent values derive from it. Passing the id the document already has has no effect. Write-protected documents are rejected.

documentDate

date

Date of the document

documentAddress

object

The recipients postal address of the document

project

The project associated with the document. Set to null to remove project association.

internalDesignation

string

length ≤ 255

Internal designation, might be displayed in the letterhead

bodyIntroduction

string

Introduction text for the body of the document

bodyOutroduction

string

Outroduction text for the body of the document

vatId

string

length ≤ 255

VAT ID of the business partner

deliveryTerms

string

Delivery terms for the document

internalComment

string

Internal comment for the document

language

string

Language of the document in an ISO-639-1 format.

printSettings

object

Print settings for the document

editor

object

Editor information

tags

customFields

array of objects

Custom field values for the document. Only custom fields configured for this document in your Xentral instance are accepted here; the customField1 to customField40 keys exist on line items only. Listed keys are written, keys that are not listed are left untouched. Pass value: null to clear a single field.

customFields

costCenter

string

length ≤ 35

Cost center for the document

financials

object

sales

object

Sales information

shippingMethod

object

Reference to the shipping method used for this document. Defaults to the address, project or company shipping method when omitted.

dunningSettings

object

dunningSetManually

boolean

Indicates whether dunning values are manually set.

dunningManualSettings

object | null

Manual dunning settings. Only applicable when dunningSetManually is true.

masterReferenceNumber

string

length ≤ 255

Master reference number for the invoice.

lineItems

array of objects

length ≤ 100

Line items to write together with the invoice. An entry with an id updates that product line item of this invoice (only the provided fields), an entry without an id creates a new line item appended at the end, and an entry with deleted: true deletes the referenced line item. Line items not included in the list are left unchanged - only an explicit deleted entry removes one. Intermediate line items (ids prefixed with il-) can be updated inline as well, limited to their name and description; creating or deleting them requires the dedicated line-item endpoints.

lineItems

customerOrderNumber

string

length ≤ 255

Customer order number / reference.

deliveryDate

date | null

Delivery date of the order the invoice is associated with.

useAlternativeDocumentTitle

boolean

Indicates if the alternative document title should be used.

deviatingDebtorAccountNumber

string

length ≤ 32

Deviating debtor account number for accounting purposes.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

403

Forbidden

404

Not Found

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Update an invoice. Line items can be written inline through lineItems: an entry with an id updates, an entry without one creates, an entry with deleted: true deletes. The response body carries the updated line items and tags, so an inline-created line item comes back with its new id.

400Failed validation

409Problem occurred

429Too Many Requests