XML Profiles

Invio ships with a built‑in XML export profile registry.

Profiles (built‑in):

• ubl21 — UBL 2.1 (PEPPOL BIS Billing 3.0)
• facturx22 — Factur‑X / ZUGFeRD 2.2 (EN 16931)

Admin endpoints

• Admin: GET /api/v1/xml-profiles
• Public: GET /api/v1/public/xml-profiles

Download for a given invoice

• Admin: GET /api/v1/invoices/:id/xml?profile=ubl21|facturx22
• Public: GET /api/v1/public/invoices/:share_token/xml?profile=ubl21|facturx22

Headers

• Content-Type reflects the profile’s media type
• Content-Disposition suggests a filename using the invoice number

PEPPOL settings (optional)

• peppolSellerEndpointId, peppolSellerEndpointSchemeId
• peppolBuyerEndpointId, peppolBuyerEndpointSchemeId
• companyCountryCode and customer.countryCode help populate country contexts

Embedding XML in PDFs

• Toggle embedXmlInPdf in Settings → XML to include the selected profile as a PDF attachment for both admin and public PDF downloads.