Send a draft invoice back
Records an approver’s decision not to let a draft be issued. reason is required: the person who wrote the invoice sees it and can change the invoice and ask again. The draft stays editable and no approval is written, so it simply cannot be issued.
Not available to API keys, for the same reason as POST /invoices/{invoice_id}/approve.
Authorizations
Portal API key minted in portal Settings → API access. Scope read or write; pinned to one company. Send as Authorization: Bearer lac_sk_....
Path Parameters
Body
Why the invoice is not approved. Shown to the person who wrote it and recorded in the audit trail.
1Material revision returned with the draft the person reviewed.
^[0-9a-f]{64}$Stable key for this exact return decision.
8 - 256Company id. Omit when using an API key.
Response
The draft, sent back with the reason on it.
One sales invoice, sales draft, or purchase invoice. Amounts are integer cents; interior fields beyond the stable ones vary by status.
invoice, credit_note Live allocated payment amount in integer cents.
Amount still outstanding in integer cents.
True only when this issued Maventa invoice has one queued intent, no provider attempt or id, no payment or earlier correction, and an active original journal. The write route repeats these checks under the outbound and journal locks.
Customer-facing seller name captured for this invoice.
Registered legal seller name captured for this invoice.
Seller Business ID captured for this invoice.
Payment account captured for this invoice.
Partner seller profile id; empty for the tenant's own sale.
False for a partner sale. Such an invoice is excluded from this company's journal, VAT facts, receivables, aging, and overdue controls.
Delivery state of the partner's bookkeeping PDF copy.
not_required, no_contact_email, pending, sending, sent, failed, ambiguous Latest partner-copy delivery error.
Whether the exact issued PDF is registered as retained evidence.
Canonical evidence-document id for the issued PDF.
SHA-256 of the exact bytes returned by the PDF endpoint.
^[0-9a-f]{64}$Size of the retained PDF in bytes.
Where this draft stands with its approver, for a company whose invoice_approval_policy is required. Meaningful only while the row is a draft; an issued invoice carries an empty value because approval no longer applies to it. Changing a draft resets this to none: the approval was for the invoice as written.
none, awaiting, approved, rejected Who asked for approval.
Stable identity of the current approval request.
^[0-9a-f]{32}$Which approver approved it or sent it back.
Why an approver did not approve it.
Who created the draft; this person cannot decide it.
Material sales invoice revision that approve or return must echo.
^[0-9a-f]{64}$Material revision that was returned. A new request needs a different current revision.
^[0-9a-f]{64}$Current commercial/source review revision of a purchase invoice; accounting-only coding is excluded.
verify, approve, returned, approved, ready_for_payment, payment_in_progress, paid, source_unavailable, payment_details_missing Whether this person may perform the next purchase review action.
Whether a retained supplier-invoice source document is available; explicit receipt/supporting attachments do not qualify.
An invoicing counterparty (the customer you invoice), with e-invoice routing and per-party defaults. Rates in basis points (25.5% = 2550).