invoice_debit_note
[REQUIRES APPROVAL] Issues a numbered debit note that raises what an issued ('sent' or 'paid') invoice is owed: an extra charge, or a price or tax correction. It is numbered from the debit note series and adds amount_cents (or a decimal STRING amount), tax at the invoice's rate inside, in its currency; a 'paid' invoice goes back to 'sent' until the rest is paid. Refuses a draft (change its lines instead), a cancelled invoice, an invoice with no lines, another currency, and a paid invoice with no payment recorded (record it first with invoice_payment_record); every refusal names the call to send. Never deleted: undo one with a credit_note. An agent's call parks for approval. Nothing is sent. NEXT: invoice_read.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | No | The amount as a decimal STRING ("25.00") instead of amount_cents — never convert units yourself. | |
| reason | No | Why the customer owes more, as the debit note prints it (max 500). | |
| currency | No | Must be the invoice's own currency; omit it to use that currency. | |
| debit_kind | No | What the debit note is for. Omit it for additional_charge. | |
| invoice_id | No | The invoice the debit note raises (invoice_list shows ids); its invoice_number works too. | |
| occurred_at | No | Epoch milliseconds the debit note takes effect. Omit it for now. | |
| amount_cents | No | The amount the debit note adds, in integer CENTS. | |
| invoice_number | No | Alias of invoice_id — the invoice's own number. |