🔒 Create credit note V3

post

https://{xentralId}.xentral.biz/api/v3/creditNotes

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: creditNote:create.

Create a new credit note.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

address

object

required

project

documentDate

date

Date of the document. Current date is used when omitted.

language

string

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

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.

customFields

documentAddress

object

The recipients postal address of the document. If not provided, the address of the business partner will be used.

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

VAT ID of the business partner. Defaults to the VAT ID of the address when omitted.

deliveryTerms

string

Delivery terms for the document. Defaults to the delivery terms of the address when omitted.

internalComment

string

Internal comment for the document

printSettings

object

editor

object

Editor information

costCenter

string

length ≤ 255

Cost center for the document

financials

object

sales

object

Sales information

lineItems

array of objects

List of line items for the credit note. Entries are either product line items (no type, or type: product) or intermediate line items (type naming the intermediate type). Array order defines placement: an intermediate entry is anchored to the product entry preceding it in the array.

lineItems

deliveryDate

date | null

Delivery date for the credit note.

debtStatus

object

deviatingDebtorAccountNumber

string

length ≤ 32

Deviating debtor account number for accounting purposes.

customerOrderNumber

string

length ≤ 255

Purchase order number provided by the customer, typically used in a B2B context.

documentNumber

string

length ≤ 64

Custom document number to assign to the credit note. By default, the document number is generated by Xentral when the credit note is released. Providing this field overrides that default: the supplied number is used and the credit note is created as released immediately (no separate actions/release call needed). Intended for use cases where the document number originates from an external system (e.g. Amazon VCS mirroring credit notes from Amazon's own number range). The number must be unique across all credit notes.

invoice

Reference to an invoice to link the credit note to. The link is reference-only — the invoice's line items are not copied and its status is not changed (the source invoice will not be automatically cancelled). Used for mirroring external credit notes that originate from an existing invoice.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

403

Forbidden

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

201Create a new credit note.

400Failed validation

429Too Many Requests