v1

latestOpenAPI 3.1.02026-07-22733584.5 KB

Invoicing

Create or update an invoice draft

Creates a sales-invoice draft (or updates an existing one via draft_id). Monetary fields are integer cents; VAT rates are basis points (25.5% = 2550); line quantities are decimal strings. Delivery channel is one of maventa_einvoice, email_pdf, or pdf_download. Requires a write-scoped key.

post/invoices

Request body

customer_idstring

Target company. Optional for API keys.

draft_idstring

Existing draft to update; omit to create a new draft.

issue_datestring

YYYY-MM-DD.

delivery_datestring

YYYY-MM-DD.

due_datestring

YYYY-MM-DD.

seller_ibanstring

seller_vat_idstring

terms_daysinteger

Payment terms in days.

notestring

languagestring

delivery_channel'maventa_einvoice' | 'email_pdf' | 'pdf_download'

How the invoice is delivered.

email_subjectstring

Subject line when delivery_channel is email_pdf.

email_messagestring

Email body when delivery_channel is email_pdf.

net_centsinteger

Invoice total net in integer cents.

vat_centsinteger

Invoice total VAT in integer cents.

gross_centsinteger

Invoice total gross in integer cents.

Response

Draft created or updated.

idstring

entity_idstring

statusstring

draftobject