Create invoice
crunch_create_invoiceCreate a draft sales invoice for a client with dated line items, VAT rates, payment terms and bank account details. The invoice stays a draft until you issue it.
Instructions
Create a draft sales invoice for a client: date, lines (description, unit price excluding VAT, quantity, VAT rate), payment terms and the bank account to be paid into. Crunch's API only supports GBP. The invoice stays a draft until crunch_issue_invoice. Look up the client (crunch_list_clients), VAT rates (crunch_list_vat_types for=invoices) and bank account first.
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": {
"client_id": "<client_id>",
"issued_date": "<issued_date>",
"items": "<items>"
},
"name": "crunch_create_invoice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Note printed on the invoice (see crunch_get_default_invoice_note) | |
| extra | No | Additional raw SalesInvoiceDto fields, using Crunch's own field names (advanced). Merged last. | |
| items | Yes | Invoice lines | |
| dry_run | No | Preview: return the request that would be sent (for an update, the fields that would change) without sending it | |
| due_date | No | Due date (YYYY-MM-DD); worked out from the payment terms when omitted | |
| client_id | Yes | Customer to invoice (see crunch_list_clients; create one with crunch_create_client) | |
| reference | No | Your reference | |
| attachments | No | Up to 5 files to attach | |
| issued_date | Yes | Invoice date (YYYY-MM-DD) | |
| line_item_type | No | SIMPLE (default) or DETAILED lines | |
| purchase_order | No | The customer's purchase order number | |
| send_reminders | No | Have Crunch email the customer payment reminders (true needs CRUNCH_ALLOW_EMAIL=true) | |
| bank_account_id | No | Bank account the customer should pay into, shown on the invoice (see crunch_list_bank_accounts) | |
| payment_terms_days | No | Payment terms in days, for example 28 |