create_ar_invoice

ch.zeno-works/zeno · Verify this server

Create an outgoing (sales) invoice as a **draft** — nothing is booked yet (accountant role). A draft changes no ledger balance, gets no invoice number and appears in no VAT return; it exists so it can be edited. Posting happens later, at ``POST …/ar/invoices/{invoice_id}/issue``. Body: ``issue_date`` (required), ``counterparty_id`` (the customer — required before it can be issued), ``currency``/``language``, ``due_date`` (filled from the customer's payment terms when omitted), ``doc_type`` (``invoice``, the default — a ``credit_note`` draft can never be issued: credit an issued invoice with ``POST …/ar/invoices/{invoice_id}/credit-note`` instead), and ``lines``: each line carries ``quantity``, ``unit_price``, a revenue ``account_code`` and a ``vat_code_id`` (the id from ``GET …/gl/vat-codes``; a line without one declares no VAT). Totals, per-line net/VAT/gross and discounts are computed server-side — do not send them. Returns the created invoice with its lines and computed totals. Check ``GET …/ar/invoices/{invoice_id}/readiness`` for what still blocks issuing.