PDF2Peppol API for developers

Send Documents to Peppol Without XML

PDF2Peppol API lets developers send sales invoices and credit notes to the Peppol network by simply uploading a PDF. No UBL/XML generation. No complex Peppol mapping. No weeks spent programming invoice schemas.

Upload the PDF invoice or PDF credit note, let Peppox convert the document data, verify the result, confirm it, and send it to Peppol through a simple API workflow.

Create an integrator account View API workflow

✓ PDF invoice upload ✓ PDF credit note upload ✓ Sales invoices and credit notes ✓ No XML programming ✓ Built for developers

Developer workflow PDF → Peppol Invoices and credit notes supported

1 Upload PDF

2 Check data

3 Confirm

4 Send to Peppol

Stop coding complex XML

Peppol E-Invoicing Should Not Take Weeks to Implement

Building Peppol invoice and credit note sending from scratch usually means understanding UBL, invoice type codes, credit note type codes, Peppol BIS Billing rules, XML validation, PDF attachments, customer identifiers, VAT fields, correction logic, refund logic and Access Point integration.

With Peppox PDF2Peppol, you can avoid most of this complexity. Your application sends a PDF invoice or a PDF credit note to Peppox, and the API guides you through a simple verification and sending workflow.

❌

Without PDF2Peppol

Build UBL/XML generation manually
Map every invoice field yourself
Handle sales invoices and credit notes separately
Build correction and refund document logic
Attach the original PDF correctly
Debug Peppol validation errors
Spend days or weeks on implementation

✅

With Peppox PDF2Peppol

Send the PDF invoice through a simple API
Send the PDF credit note through the same workflow
Let Peppox prepare the document data
Check extracted information before sending
Confirm the document when it is correct
Send to Peppol with one final API call
Integrate faster and more securely

Discover Peppox PDF2Peppol API in Video

See how to send PDF invoices and credit notes to Peppol without coding XML.

Designed for integrators

Create One Integrator Account, Then Connect Your Customers

PDF2Peppol is built for software developers, SaaS platforms, ERP providers, billing tools, accounting platforms and integrators who need to send Peppol invoices and credit notes for multiple customers.

First, you create an integrator account. Then, for each company, customer or end user, you create a linked company account. Each linked company receives a unique supplier_id.

This supplier_id identifies the company in the API and allows Peppox to send invoices and credit notes with the correct supplier information.

Create your integrator account

Integrator structure

Integrator account Your developer or platform account

↓

Linked company account Your customer, company or end user

↓

supplier_id used in the API

Simple API workflow

From PDF to Peppol in Four API Calls

Peppox gives developers a clear API process: upload the PDF invoice or PDF credit note, check the converted data, confirm that the information is correct, and send the document to Peppol.

1

Upload the PDF

Send a sales invoice or credit note PDF to Peppox. The API accepts a PDF file, base64 content, or a PDF URL.

POST https://api.peppox.com/pdf2peppol/add/

2

Check converted data

Retrieve the document information prepared by Peppox and verify the customer, totals, lines, document type, invoice or credit note data and Peppol readiness.

GET https://api.peppox.com/pdf2peppol/check/

3

Confirm the document

When your application or user confirms that the invoice or credit note information is correct, mark the document as verified.

POST https://api.peppox.com/pdf2peppol/confirm/

4

Send to Peppol

Send the confirmed invoice or credit note to the Peppol workflow. Peppox handles the final document generation and sending process.

POST https://api.peppox.com/pdf2peppol/send/

Developer-friendly process

One PDF Invoice or Credit Note Can Become a Peppol Document

Your application does not need to generate the Peppol XML itself. You only send the PDF and use the API to control each step before the invoice or credit note is delivered.

📄 User selects or provides a PDF invoice or credit note

📤 Your app sends the PDF to Peppox

🔎 Peppox prepares and returns the document data

✅ Your app confirms the information

🚀 Peppox sends the document to Peppol

PDF Invoice or credit note

→

API Upload and check

→

Confirm Validate data

→

Peppol delivery

API examples

Simple Endpoints for Fast Invoice and Credit Note Integration

The PDF2Peppol API is designed to be easy to integrate into existing software. Your main parameters are the supplier_id, the document type, and the PDF source. Use it for both sales invoices and credit notes.

1. Upload a PDF invoice

Send the invoice PDF as a file, as base64, or with a PDF URL.

curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
  -F "supplier_id=YOUR_SUPPLIER_ID" \
  -F "document_type_code=380" \
  -F "pdf_file=@invoice.pdf"

Use 380 for a sales invoice.

2. Upload a PDF credit note

Send a credit note, correction document or refund document using the same endpoint.

curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
  -F "supplier_id=YOUR_SUPPLIER_ID" \
  -F "document_type_code=381" \
  -F "pdf_file=@credit-note.pdf"

Use 381 for a credit note.

3. Check converted information

Retrieve the converted document data and check if the invoice or credit note is ready for Peppol.

curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"

The response includes document header, buyer information, lines, totals, readiness checks and the PDF link.

4. Confirm the document

Confirm that the invoice or credit note information is correct before sending.

curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
  -d "supplier_id=YOUR_SUPPLIER_ID" \
  -d "queue_guid=QUEUE_GUID"

This step gives your application full control before the final Peppol sending.

5. Send to Peppol

Send the confirmed invoice or credit note to the Peppol workflow.

curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
  -d "supplier_id=YOUR_SUPPLIER_ID" \
  -d "queue_guid=QUEUE_GUID"

Peppox handles the document generation and sending workflow.

Flexible PDF input

Send the PDF the Way Your Application Works

You can integrate PDF2Peppol in multiple ways depending on your software architecture. The same logic can be used for PDF invoices and PDF credit notes.

📎 PDF file upload

Upload the PDF directly from your application using multipart/form-data.

🔐 PDF base64

Send the PDF content as base64 when your application already stores the document internally.

🔗 PDF URL

Provide a secure PDF URL and let Peppox retrieve the document for processing.

🧾 Sales invoice

Use document type code 380 to send a standard sales invoice to your customer through Peppol.

↩️ Credit note

Use document type code 381 to send a credit note, correction document or refund document through Peppol.

🔑 supplier_id

Each linked company receives a supplier_id used to identify the correct sender in the API.

Fast Peppol implementation

Build Peppol Invoice and Credit Note Sending Into Your App Without Becoming a Peppol XML Expert

PDF2Peppol is made for developers who want to deliver Peppol sending quickly without spending days, weeks or months building XML logic, invoice validation rules, credit note rules and attachment workflows.

1 Create an integrator account

2 Create linked company accounts

3 Use supplier_id in the API

4 Send PDF invoices and credit notes

Start integrating PDF2Peppol

Who is it for?

PDF2Peppol Is Built for Software Teams and Integrators

If your software already generates PDF invoices or PDF credit notes, PDF2Peppol helps you add Peppol sending without rebuilding your entire invoicing engine.

ERP developers

Add Peppol invoice and credit note sending to your ERP without developing a complete UBL/XML generation module.

SaaS billing platforms

Let your users send their PDF invoices and credit notes to Peppol through your platform with a simple API workflow.

Accounting tools

Convert existing PDF invoice and credit note flows into Peppol-ready workflows with verification and confirmation steps.

Custom business software

If your application already creates invoices or credit notes as PDF files, you can add Peppol delivery faster.

Secure and controlled

Verification Before Sending Gives You Control

PDF2Peppol is not a blind upload-and-send process. The API includes a verification step so your application can check the converted invoice or credit note information before sending anything to Peppol.

Your user or your system can review key information such as document number, buyer details, document lines, totals, document type, credit note data and readiness checks before confirming the document.

✓ supplier_id identifies the correct company

✓ Check endpoint before final sending

✓ Confirmation required before sending

✓ Supports invoice workflows

✓ Supports credit note workflows

✓ Original PDF remains linked to the document

FAQ

Frequently Asked Questions

Do I need to generate Peppol XML?

No. The goal of PDF2Peppol is to let your application send a PDF invoice or credit note and use Peppox to prepare the Peppol workflow.

Can I send credit notes?

Yes. PDF2Peppol supports credit notes. Use document type code 381 for credit notes and document type code 380 for sales invoices.

Can I send both invoices and credit notes with the same API?

Yes. The same PDF2Peppol workflow can be used for invoices and credit notes. You only change the document type code.

What is supplier_id?

The supplier_id identifies the linked company account that sends the document through Peppox.

Can I check the data before sending?

Yes. The check endpoint returns the converted document data and readiness checks before the document is sent.

Can I upload the PDF by URL?

Yes. The add endpoint can accept a PDF file, base64 PDF content, or a PDF URL.

Who should use this API?

Developers, SaaS platforms, ERPs, invoicing tools and integrators that want to add Peppol sending quickly.

PDF to Peppol made simple

Start Sending PDF Invoices and Credit Notes to Peppol With a Simple API

Stop spending time building complex invoice XML generation. Create your Peppox integrator account, connect your customers, use their supplier_id, and send invoices or credit notes to Peppol from PDF.

Create an integrator account View API examples