PDF to UBL Transformation API Reference
Convert a PDF invoice into a UBL 2.1 XML document, fully compliant with the EN 16931 standard and ready for transmission over the Peppol network. UBL (Universal Business Language) is the OASIS XML standard used by Peppol BIS Billing 3.0 and is the mandated e-invoicing syntax in Norway, Denmark, Sweden, Singapore, Australia, New Zealand, and across the broader Peppol ecosystem.
This is an experimental feature. AI can make mistakes. Always double-check the result before submitting it to tax authorities.
https://api.invoicexml.com/v1/transform/to/ubl
Code Example
curl -X POST https://api.invoicexml.com/v1/transform/to/ubl \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "language=en"
Try it out online, no coding required
Upload a PDF and get a compliant invoice back instantly, right in your browser.
Request
| Parameter | Type | Description |
|---|---|---|
| file * | binary | The invoice file to process. |
| language | string | Language for PDF labels and date formatting. Values: en, de, fr. Defaults to en. |
Content-Type: multipart/form-data
The source and target formats are part of the endpoint path, and everything else (syntax, declared profile, specification identifier) is read from the document itself, so there is nothing more to configure.
Headers
| Header | Value |
|---|---|
| Authorization * | Bearer YOUR_API_KEY |
| Content-Type | multipart/form-data |
Response
200 Converted invoice
Returns the UBL 2.1 XML document.
Frequently Asked Questions
What is UBL 2.1?
UBL (Universal Business Language) 2.1 is an OASIS XML standard for electronic business documents. It is one of the two official syntaxes of the European EN 16931 e-invoicing standard and is the native XML format of the Peppol network.
Is the output Peppol BIS Billing 3.0 compliant?
Yes. The generated UBL 2.1 XML conforms to the Peppol BIS Billing 3.0 specification. It is validated against EN 16931 business rules and Peppol-specific constraints before delivery.
Which countries require Peppol UBL invoicing?
Peppol UBL invoicing is mandatory for public sector B2G in Norway, Denmark, Sweden, Finland, Singapore, Australia, and New Zealand. The Netherlands, Belgium, and Italy are rapidly expanding Peppol adoption to B2B transactions.
How does UBL differ from CII?
Both UBL and CII are valid EN 16931 syntaxes. UBL 2.1 is the format of Peppol BIS Billing 3.0, use it when transmitting over the Peppol network. CII is used by ZUGFeRD and Factur-X hybrid PDFs, which are more common in Germany and France.
Can I submit the output directly to a Peppol access point?
Yes. The generated UBL 2.1 document is a standards-compliant XML file ready for submission to any Peppol-certified access point. You may also pass it to your ERP or accounting system that supports UBL import.