🔒 Create invoice V3

post

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

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: invoice:create.

Create a new invoice.

Recent Requests

Log in to see full request history

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

array of objects

List of tags associated with the document. New tags will be automatically created if they do not exist.

tags

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

deliveryTerms

string

Delivery terms for the document

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

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.

customerOrderNumber

string

length ≤ 255

Customer order number / reference.

deliveryDate

date

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.

lineItems

array of objects

List of line items for the invoice.

lineItems

Headers

accept

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