Create an invoice
bearerAuthAuthorizationBearer <token>API key as Bearer token
application/json- body
Exactly one of contact_id or contact_external_id is required. Issued documents are numbered by the same gapless per-(company, series, year) allocator the app uses (ADR-0208); the series defaults to BRV. Non-RON documents carry the BNR T-1 reference rate for issue_date unless a positive exchange_rate is supplied — when the rate cannot be obtained the request fails with 422 EXCHANGE_RATE_UNAVAILABLE, never a silent rate of 1.
type?string"INVOICE""PROFORMA""QUOTE""RECEIPT""CREDIT_NOTE"direction?string"ISSUED""ISSUED""RECEIVED"series?stringNumbering series; defaults to BRV for issued documents.
contact_id?stringuuidcontact_external_id?stringYour own identifier for the contact, resolved through the external reference map (source api, entity contact). Used only when contact_id is absent; unknown → 404 CONTACT_NOT_FOUND.
length <= 255company_id?stringIssuing legal entity. Optional when the organization has a single active company; required (422) when it has several.
uuidproject_id?stringissue_date*stringdatedue_date*stringdatecurrency?string"RON"exchange_rate?numberRON per 1 unit of currency. Omit to have the BNR T-1 reference rate fetched server-side (recommended). A supplied value is persisted as-is; ignored for RON.
0 < valuevat_type?stringVAT regime of the document. When omitted it is derived from the contact: RO → TAXABLE; EU (non-RO) with a VAT number → INTRA_COMMUNITY (reverse charge, UBL category AE); EU without VAT number → TAXABLE; non-EU → EXPORT. Only TAXABLE carries line VAT.
"TAXABLE""REVERSE_CHARGE""INTRA_COMMUNITY""EXPORT""VAT_EXEMPT""NON_TAXABLE""MARGIN"vat_exemption_reason?stringLegal mention printed and emitted for non-TAXABLE regimes.
length <= 500notes?stringitems*array<>OK
application/json- response
data*error*nullcurl -X POST "https://example.com/invoices" \ -H "Content-Type: application/json" \ -d '{ "issue_date": "2019-08-24", "due_date": "2019-08-24", "items": [ { "description": "string", "quantity": 0, "unit_price": 0 } ] }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "string", "direction": "string", "series": "string", "number": 0, "status": "string", "contact_id": "string", "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf", "currency": "string", "exchange_rate": "string", "vat_type": "TAXABLE", "vat_exemption_reason": "string", "subtotal": "string", "vat_total": "string", "total": "string", "paid_amount": "string", "credited_amount": "string" }, "error": null}