Peppol API Integration SolutionsConnect your existing software to the Peppol network in a few steps
API, XML, PDF - Choose the integration method that suits your needs
Solution 1: XML UBL Sending via API
For developers and technical systems
How it works?
- 1.Generate an XML UBL 2.1 file compliant with Peppol BIS 3 standard
- 2.Send it via our REST API or via file upload through our interface (supports uploading multiple files in a zip)
- 3.We automatically send to the Peppol network
Advantages
- Full control over data
- No conversion, native format
- 100% automated processing
Resources to create your Peppol UBL file
Solution 2: JSON + PDF Sending
For simple and fast integration
How it works?
- 1.Send your invoice data in structured JSON
- 2.Attach the PDF for invoice visualization
- 3.We automatically generate Peppol XML UBL
- 4.Automatic sending to Peppol network with PDF attached
Advantages
- Simpler than XML UBL
- Presentation PDF included
- Automatic conversion to UBL
- Ideal for modern APIs
Solution available now This solution allows developers to simply send a JSON object with invoice data, without having to generate complex XML UBL.
Limitation: This solution is limited to mandatory Peppol BIS 3 fields only. For advanced profiles with custom fields, XML UBL sending (Solution 1) is required.
Solution 3: AI PDF Conversion
For structured invoice PDFs
How it works?
- 1.Upload your invoices in PDF format
- 2.Our 100% local AI analyzes your PDF invoice
- 3.Data pre-encoded by AI is ready to be verified
- 4.You send your invoice in XML format with your PDF attachment and retrieve the XML file for archiving
Advantages
- Easy and fast
- 100% local AI (your data never leaves our European servers)
- GDPR compliance guaranteed
- Support for all invoice formats
Requirements for optimal processing
To ensure accurate extraction, your PDFs must meet these criteria:
- Text format (no scanned images) - max 40 lines and short descriptions
- Clear structure with all mandatory fields visible (number, date, due date, delivery, customer VAT number, supplier information only at bottom...)
- Well-formatted items table with distinct columns (reference, description, quantity, unit price, % discount, % VAT)
More complex PDFs
For more complex PDFs (+40 lines, non-standard structures, specific formats), it is possible through custom development and using your own commercial AI with OpenAI-compatible API.
Using your own AI is at your own expense, risk and responsibility. Converting a PDF requires significant computing power and consumes many tokens, resulting in significant costs.
Custom Development
Custom integration for your ERP or business software
Using SAP, Microsoft Dynamics, Sage or a proprietary ERP? We develop a custom format conversion service to send your invoices to Peppol.
- Analysis of your format and development of conversion to Peppol UBL
- Testing, training and dedicated support
2026 Deadline: Limited Places
Limited capacity. We process projects on a first-come, first-served basis. Contact us quickly to secure your compliance before the deadline.
Secure your Peppol compliance before the legal deadline
Frequently Asked Questions about Peppol Box API
Everything you need to know about our integration services
Is data sent with the API stored on Peppol Box?
No, your data is confidential. API services handle document transit without storing them. You must retain documents sent and received via our API in your own systems in accordance with legal obligations.
Does Peppol Box API offer a test environment?
Yes, the APIs and interfaces allow you to set a test mode flag that does not send the document to the Peppol network. This allows you to test your integration safely before going into production.
Is support for using the API included in the price?
Our services are very clear and easy to use, they should not require complex support. However, we can offer you a paid technical support service according to your specific technical needs.
What data formats are supported by the API?
Our API supports several formats:
- XML UBL 2.1: Native Peppol format (recommended)
- JSON: Simple format for developers
- PDF: With AI conversion to UBL (custom service)
How long does API integration take?
Integration time depends on your existing system:
- XML UBL Sending: 1-2 days if you already generate XML UBL
- JSON Sending: 2-5 days for basic integration
- Complete integration (sending + receiving): 1-2 weeks
- Complex ERPs: 2-4 weeks with support
How does the document limit work?
Your subscription includes a document quota valid for maximum one year. There is no overage billing.
When you approach your limit, the system automatically warns you in advance to invite you to subscribe to a new annual plan.
Once the limit is reached, you must take a new plan which will also be valid for one year.
Is API documentation available?
Yes, the Peppol Box API is an easy-to-use REST API following OpenAPI/Swagger standards. Complete interactive documentation is available upon account creation with ready-to-use code examples.
What happens if I exceed my plan?
The system automatically warns you when you approach your annual limit. To continue sending and receiving documents, you must subscribe to a new higher annual plan.
The system warns you in advance to allow you to move to a higher plan. If you do not subscribe to the higher service in time, you will no longer be able to send or receive documents on the Peppol network.
What is meant by "document" in plan counting?
A "document" corresponds to each transaction made via the API, whether sending or receiving. Counting is done per operation, not per unique invoice.
Counting examples:
- • If you send the same invoice 3 times = 3 documents
- • If you receive or download the same invoice twice = 2 documents
- • Each send or receive counts individually in your annual quota
How does VAT calculation work in Peppol BIS Billing 3?
The Peppol BIS Billing 3 (EN16931) standard requires a specific VAT calculation method that is done in two steps:
Step 1: Calculate the net amount of each line
- • Line net amount = Quantity × Unit price excl. VAT
- • Apply any discounts
- • Round the line net amount to 2 decimals
Step 2: Calculate VAT by rate (at invoice level)
- • Sum all net amounts of lines with the same VAT rate
- • VAT by rate = (Sum of net amounts) × VAT rate
- • Round the result to 2 decimals
- • Total incl. VAT = Total excl. VAT + Sum of all VAT
VAT is NOT calculated line by line. It is only calculated at invoice header level on the sum of net amounts grouped by rate. This avoids cumulative rounding errors and is mandatory according to EN16931.
B2B Invoices: This standard applies to invoices between professionals. If your POS software calculates in VAT-inclusive amounts, you must adapt it to calculate in VAT-exclusive amounts for professionals.
Is there a plan for integrators?
No, the Peppol Box offer is intended for each end customer individually.
How it works for integrators
- • Each customer is billed individually by Flexina
- • Each customer has their own document quota
- • Registration on the Peppol network must be done via Peppol Box services
For developers: You must provide in your software the ability for your customers to configure the Peppol Box API and enter their own credentials.
Have more questions?
Contact our team