Skip to main content
POST
Create or update an invoice draft

Authorizations

Authorization
string
header
required

Portal API key minted in portal Settings → API access. Scope read or write; pinned to one company. Send as Authorization: Bearer lac_sk_....

Body

application/json

Input for creating or updating a sales-invoice draft. All money in integer cents; dates YYYY-MM-DD.

customer
object
required

An invoicing counterparty (the customer you invoice), with e-invoice routing and per-party defaults. Rates in basis points (25.5% = 2550).

lines
object[]
required
customer_id
string

Target company. Optional for API keys.

draft_id
string

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

seller_profile_id
string

Active partner id from GET /seller-profiles. The partner becomes the legal seller and payee, its own invoice-number series is used, and the sale does not post to this company's ledger. The tenant's Maventa connection remains the technical e-invoice transport.

issue_date
string

YYYY-MM-DD.

delivery_date
string

YYYY-MM-DD.

due_date
string

YYYY-MM-DD.

seller_iban
string

Tenant-owned payment account for an ordinary invoice. Ignored when seller_profile_id is set.

seller_vat_id
string
seller_contact
string

Seller contact printed on the invoice.

buyer_reference
string

Buyer reference printed on the invoice.

terms_days
integer

Payment terms in days.

note
string
language
string
delivery_channel
enum<string>

How the invoice is issued. maventa_einvoice is sent over the e-invoice network (POST /invoices/{invoice_id}/send). pdf_download is finalized and delivered by you (POST /invoices/{invoice_id}/finalize). email_pdf is a deprecated alias that is still accepted but transmits nothing — LAC never emails an invoice. Use pdf_download.

Available options:
maventa_einvoice,
email_pdf,
pdf_download
email_subject
string
deprecated

Stored on the draft as a note. No email is ever sent from it.

email_message
string
deprecated

Stored on the draft as a note. No email is ever sent from it.

net_cents
integer

Invoice total net in integer cents.

vat_cents
integer

Invoice total VAT in integer cents.

gross_cents
integer

Invoice total gross in integer cents.

Response

Draft created or updated.

id
string
entity_id
string
status
string
draft
object
customer
object

An invoicing counterparty (the customer you invoice), with e-invoice routing and per-party defaults. Rates in basis points (25.5% = 2550).