Skip to main content

Create a plain invoice

POST 

/api/v1/documents/plain-invoice

Create a plain invoice: a PDF invoice for a seller in a country with no e-invoice format (the United States and most of the world). The seller names its own tax on the invoice (tax_label: "Sales tax", "GST"), no VAT number is asked for, and when no line carries tax the page has no tax line at all.

The body is the same Canonical Invoice Model payload POST /invoices takes. number is the seller's own invoice number and is unique per organisation: sending the same invoice again answers the stored one (replayed: true), and a different invoice under a number already used is refused with 409.

This is not an e-invoice. No XML is made, nothing is sent over Peppol or reported to a tax authority, and none of the EN 16931 or Peppol rules is applied. A seller whose country has an e-invoice format (the EU and EEA, the United Kingdom, Switzerland, Australia, New Zealand and the countries GoRoute reports to an authority for) is refused here and uses POST /invoices.

Get the PDF from GET /documents/{document_id}/pdf.

Requestโ€‹

Responsesโ€‹

Successful Response