Credit note
o2c_create_credit_noteRaise a credit note: the universal downward correction. Pricing errors, short-pay resolution, goodwill — anything past draft is corrected downward this way and only this way (INV-11). A credit note has its own open balance: apply it to invoices like a payment, or refund it. Standalone credits (no invoice reference) are allowed but the reason is mandatory and it will be read back. Effects: credit note raised as unapplied credit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customer_id": "<customer_id>",
"amount": "<amount>",
"kind": "<kind>",
"reason": "<reason>"
},
"name": "o2c_create_credit_note"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | What kind of correction this is. Returns and write-offs have their own commands. | |
| amount | Yes | Credit amount, tax-inclusive. In cents (integer minor units) — 1250 means $12.50. | |
| reason | Yes | Why. Mandatory — this is money. | |
| invoice_id | No | The invoice being corrected, when there is one. An existing invoice id. | |
| customer_id | Yes | Whose balance this relieves. An existing customer id. |