make_receipt
Make a receipt file from a template, with your own items, and get a 24-hour download link. Call list_templates for a slug first. Set accept_terms to true. items is required (1 to 200): name, qty and unit_price as decimal strings like "4.50", never numbers; subtotal, tax and total are worked out for you. Every other field you leave out (store name and address, date, currency, tax, payment, discounts, extra_lines, messages, barcode) uses the template's sample value, so pass an empty array to clear discounts, extra_lines or messages. format is png (default), jpeg or pdf. An optional logo goes on top: PNG, JPEG or SVG up to 2 MB (a PNG or JPEG at most 2 megapixels, for example 1600×1250; resize a bigger one first), as file_id (from create_upload), url or data_base64; it replaces the template's logo, and header.logo "none" removes the template's logo. Returns url, expires_at, the delivered image size in pixels (for a PDF, the page at 1x), the totals as formatted strings, and notes for anything that was left out or cut. Free within a daily quota counted in documents (see start.md). Make receipts only for lawful purposes, such as replacing a lost receipt, bookkeeping, testing or design mockups. Using a receipt to deceive anyone, including for refunds, expense claims or proof of purchase, is prohibited.
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": {
"template": "<template>",
"accept_terms": "<accept_terms>",
"items": "<items>"
},
"name": "make_receipt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tax | No | Either a rate in percent or a fixed amount, with a label; replaces the template's tax | |
| tip | No | ||
| logo | No | A logo for the top of the receipt: exactly one of file_id, url or data_base64. PNG, JPEG or SVG, up to 2 MB (a PNG or JPEG also at most 2 megapixels, for example 1600×1250); the file's own bytes decide the type, not its name. | |
| items | Yes | What was bought: name, qty and unit_price (decimal strings; a negative price is a refund line), with optional sku and note | |
| paper | No | ||
| format | No | File type of the receipt | png |
| header | No | Seller name, address lines, alignment and logo choice; fields you leave out keep the template's | |
| barcode | No | ||
| payment | No | How it was paid; replaces the template's payment | |
| currency | No | Symbol, decimals (0, 2 or 3) and number format; fields you leave out keep the template's | |
| datetime | No | ||
| messages | No | ||
| sections | No | ||
| template | Yes | Template slug from list_templates | |
| discounts | No | ||
| date_format | No | ||
| extra_lines | No | ||
| time_format | No | ||
| accept_terms | Yes | Must be true: you agree to the acceptable-use policy in this tool's description |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| notes | Yes | ||
| format | Yes | ||
| totals | Yes | ||
| width_px | Yes | ||
| height_px | Yes | ||
| expires_at | Yes |