An e-invoice is an invoice in a form that another system reads without retyping. Pop Dispatch builds the file from an invoice you have already issued. You will be able to choose the format, build the file and hand it to your customer, your advisor or your own sending account.
Before you start #
- The invoice is issued and holds your tax ID and the customer's tax ID where the format needs them. See "Tax ID formats".
- You need the owner or accountant role.
The formats #
| Format | Route name | What it is for |
|---|---|---|
| UBL (EN 16931) | ubl | The European standard invoice in UBL 2.1 XML. Used by many accounting systems in Europe. |
| Peppol BIS Billing 3.0 | peppol | UBL with the Peppol rules, for sending over the Peppol network. |
| CII (EN 16931) | cii | The European standard invoice in UN/CEFACT Cross Industry Invoice XML. |
| Factur-X (XML part) | facturx | The XML that sits inside a Factur-X or ZUGFeRD PDF invoice. Profiles are Minimum, Basic WL, Basic, EN 16931 and Extended. |
| India e-invoice JSON | in-irn | The INV-01 version 1.1 JSON that India's e-invoice system takes to issue an invoice reference number (IRN). |
| Saudi ZATCA | zatca | UBL for the ZATCA e-invoicing system, with the QR payload. |
| Mexico CFDI 4.0 | cfdi | The Mexican electronic invoice, CFDI version 4.0. |
Credit notes build as the matching credit note document, type 381. Invoices are type 380.
Steps #
- Open the invoice.
- Choose the e-invoice format that matches your country or your customer's request.
- Build the file. Pop Dispatch builds it on demand from the invoice as it stands and keeps a copy with the status "built".
- Save the file, or send it through your own account. See "Send e-invoices through your own account".
What you add yourself #
Pop Dispatch builds the file. Three formats need a signing step from an account in your own name:
- Saudi ZATCA: the ZATCA certificate (CSID).
- Mexico CFDI: your digital seal certificate (CSD), applied through your own provider.
- India: the response from the Invoice Registration Portal (IRP), which returns the IRN.
Those steps run with your own account. Pop Dispatch holds no certificate on your behalf and charges for no service.
About the specifications #
The EN 16931, Peppol and Factur-X builders follow the Peppol documentation and the Factur-X 1.07.2 specification. The India, ZATCA and CFDI specification pages could not be read from official sources on 2026-11-04. Check any file you file with the authority against the current official specification, and ask your tax advisor before you go live.
Technical details
- Route:
GET /api/v1/invoices/:id/einvoice?format=ubl|peppol|cii|facturx|in-irn|zatca|cfdi. - Builders live in
core/src/billing/einvoice/:ubl.rs(UBL and Peppol BIS 3.0),cii.rs,facturx.rsandxml.rs. The data model is inmodel.rs. - Built files are stored in
einvoice_documentswith the format, the body, a status (built, sent or failed), a portal reference and an error text. - The Factur-X XML uses the guideline identifier of the profile you choose. The CII builder uses
urn:cen.eu:en16931:2017. - Amounts are whole cents. Quantities carry hundredths.
If something goes wrong #
- The file builds with an empty tax ID: save the tax ID on your business or the customer first.
- The authority rejects a file: read its message, then check the specification and your tax profile. Ask your tax advisor when the message names a tax rule.