Create an invoice
/invoicesCreates a finalized invoice and queues its PDF. Fires the invoice.created webhook.
Numbering. Omit invoice_number to take the next number of the series: the series counter, otherwise
the highest existing number in that series plus one, otherwise 1. An explicit number must be unique
within the series. Numbers are returned zero-padded to three digits.
Amounts. Each product line carries exactly one of price (unit price excluding VAT), total (line total
excluding VAT) or total_incl_vat; the other two are derived. vat_percentage is required on the VAT
invoice types (vat_invoice, preliminary_vat_invoice, credit_vat_invoice) and whenever the seller has a
vat_code; leave it out on non-VAT types.
Seller. Send use_default_seller_info: true to copy the seller block from the business profile (plus
the custom fields of the latest invoice); seller is then prohibited. Otherwise send seller with the fields
that match the business type: companies use company_name and company_code, individual activities use
first_name, last_name and individual_activity_id (company_code and individual_activity_id are
optional). VAT invoice types require seller.vat_code when seller is sent; with the default seller info the
profile's VAT code is copied as it is.
Autorizacija
bearerAuth Business token created in the app under Settings, Integrations, API. The token is scoped to exactly one business, has no expiry and is shown only once. Send it as Authorization: Bearer <token> together with Accept: application/json.
Vieta: header
Užklausos turinys
application/json
TypeScript tipai
Naudokite request body tipą TypeScript kode.
Body of POST /invoices and PUT /invoices/{invoice}. On update every field is replaced with what you send;
always resend invoice_number or the invoice is renumbered.
Atsakymo turinys
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/invoices" \ -H "Content-Type: application/json" \ -d '{ "type": "vat_invoice", "invoice_date": "2026-09-12", "series": "SF", "currency": "EUR", "buyer": { "type": "company" }, "seller": {}, "products": [ { "name": "Consulting", "units": "h", "quantity": 2 } ] }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c", "invoice_type": "regular_invoice", "series": "string", "invoice_number": "string", "invoice_date": "2019-08-24", "pay_until_date": "2019-08-24", "language": "en", "subtotal": 0, "vat": 0, "total_incl_vat": 0, "currency": "string", "payment_status": "not_paid", "notes": "string", "share_link": "http://example.com", "seller": { "business_type": "small_partnership", "first_name": "string", "last_name": "string", "company_name": "string", "company_code": "string", "individual_activity_id": "string", "vat_code": "string", "address": "string", "email": "string", "phone": "string", "custom_fields": [ { "label": "string", "value": "string" } ] }, "buyer": { "type": "company", "first_name": "string", "last_name": "string", "company_name": "string", "company_code": "string", "individual_activity_id": "string", "vat_code": "string", "address": "string", "email": "string", "phone": "string" }, "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "price": 0, "vat_percentage": 0, "quantity": 0, "units": "string" } ], "payment_options": [ { "type": "bank", "bank_account": "string", "bank_name": "string", "routing_or_sort_number": "string", "swift_bic_code": "string", "fields": [ { "label": "string", "value": "string" } ] } ], "created_at": 0, "updated_at": 0 }}