A receipt for every payment
Payment receipts are issued per payment, partial payments included: the receipt operations of invoices and expenses accept an optional payment_id, and their MCP tools return the receipt number. Document PDFs show the issuer's IBAN only with bank payment methods and use a 9 pt base size by default. Two operations and two MCP tools updated.
15 October 2026 — Every active payment of an invoice or an expense has its own receipt, partial payments and advances included. The receipt shows the invoice as it stood right after that payment: the payments up to it, the amount collected and the amount still pending.
Receipts
- Choose the payment — Download the receipt PDF of a payment
and Download the receipt PDF of an expense payment
accept the optional query parameter
payment_id, the ID of a payment of that invoice or expense. Without it you get the receipt of the most recent active payment. - From the first payment — an invoice does not have to be fully paid to have a receipt: an advance already has one. A reversed payment has no receipt.
- Number and file name — each receipt is numbered
JC-(sales) orJP-(expenses), followed by the invoice number and the last six characters of the payment ID, for exampleJC-F-2026-014-282633.Content-Dispositionnames the filejustificante-<number>.pdf. - Errors —
422when the invoice or expense has no active payments or whenpayment_idis a reversed payment (business_rule_violationfor invoices,receipt_not_availablefor expenses, withsubcodeno_active_paymentsorpayment_reversed), and404resource_not_foundwhenpayment_idis not a payment of that invoice or expense. - MCP tools —
get_invoice_payment_receiptandget_purchase_invoice_payment_receiptacceptpayment_idand returnreceipt_numbertogether with the PDF.
The receipt follows the company's PDF branding (logo, colour, font and base size), writes the amount in words and is issued in the company's invoice language. It is not an invoice and carries no VERI*FACTU data.
Calls without payment_id keep working and return the receipt of the latest payment.
Document PDFs
- The issuer's IBAN appears only when the payment method is a bank transfer or a direct debit, or when the document has no payment method.
- Companies that have not chosen a base font size get their PDFs at 9 pt.
Updated endpoints2
| Endpoint | Description |
|---|---|
GET/v1/invoices/{invoice}/payment-receipt | Download the receipt PDF of a payment |
GET/v1/purchase_invoices/{purchase_invoice}/payment-receipt | Download the receipt PDF of an expense payment |