Create Credit Note

POST /api/autopilot/invoices/{id}/credit-note body — all of it optional.

lines absent credits the whole invoice: the store copies the original's own lines, so a full credit note cannot drift from the document it reverses. lines present makes it partial — a subset, or the same descriptions at reduced amounts — and the store refuses a total that would exceed what is still uncredited.

Amounts stay positive here, as they are on the invoice: TD04 is what says the money goes the other way (see invoice_store's credit-note section), and InvoiceLine refuses a negative price anyway. [] is rejected up front rather than left to the store, because an empty list is a client bug and not a request to credit everything — that is what omitting the field means.

One stored invoice as the API returns it (payload decrypted).

number is NULL until the issue transaction assigns it, so a draft is exactly the row whose status is draft and whose number is unset. total_amount is the imponibile the store computed from the lines, and bollo_applied the builder's verdict on it — both stored plaintext because the live estimate aggregates them in SQL.

credit_note_of is what makes a TD04 legible on its own (AP-090): set, this row is a nota di credito and names the invoice it corrects; NULL on every ordinary document. It is the store's field and never a client's — a credit note is opened through its own route, not by writing this on a draft.

client_label is the same kind of field for an imported row (AP-095): a pre-signup invoice names its customer as the text the user's own export carried, because there is no client record behind it and inventing one would put a half-filled customer — no address, no identifier — in the picker that issues real documents. It is NULL on every invoice that has a client_id.