Skip to main content

​
What is Peppol

Peppol (Pan-European Public Procurement Online) is a standardized network that enables businesses to exchange electronic documents, including invoices, securely and seamlessly across borders. By connecting to the Peppol network, you can send legally compliant e-invoices directly to your customers’ accounting systems, reducing manual processing, eliminating paper, and ensuring faster payment cycles. Peppol uses a four-corner model where certified Access Points handle the secure transmission of documents between parties.

​
Setup

Before sending invoices via Peppol, you need to register your invoicing entity with the Peppol network. Navigate to Settings > Invoicing, select the appropriate invoicing entity if you have multiple, enable Peppol, and enter your Peppol credentials. After uploading the required documents, the registration process can take up to 72 hours. Once registered, eligible invoices will be automatically sent via Peppol.
Hyperline transmits invoices using the Peppol BIS Billing UBL Invoice/CreditNote V3 format.

​
Routing in Belgium

By default, Hyperline uses Peppol scheme 0208 and the customer’s enterprise number, derived from their Belgian tax ID without the country prefix. For example, the tax ID BE0543547220 produces the participant ID 0208:0543547220. If the customer uses a different registered participant ID, you can override the inferred value in Peppol participant ID. You can verify a customer’s participant ID in the Peppol Directory.

​
Routing in Germany

By default, Hyperline uses Peppol scheme 9930 and the customer’s German VAT ID. For example, the VAT ID DE987654321 produces the participant ID 9930:DE987654321. If the customer uses a different identifier, such as a Leitweg-ID, enter the complete participant ID in Peppol participant ID. You can verify that the ID is registered and able to receive invoices in the Peppol Directory.
Peppol is a delivery network. The participant ID identifies where to send the invoice; it is separate from the invoice format, such as XRechnung.

​
Test German Peppol delivery

You can use the German federal OZG-RE test recipient to test delivery from Hyperline. You do not need an Invopop account. This tests German public-sector invoicing (B2G); it does not confirm that a particular business customer can receive your B2B invoices.
Use Hyperline test mode and the OZG-RE test environment throughout. Never send test invoices from your production account. Use email addresses controlled by your team: Hyperline can send emails in test mode.
Current limitation: the Hyperline invoice form does not expose the buyer reference required by OZG-RE. Setting the customer’s Peppol participant ID does not also set this reference, and Purchase order is a separate field. You can prepare the test customer yourself, but you cannot currently complete this particular test entirely through the invoice form. Before finalizing, use the in-app chat to resolve the buyer-reference requirement. Do not send the invoice with a generated payment reference in its place.

​
1. Prepare your German invoicing entity

  1. Switch to test mode from the account switcher. See Sandbox and test mode if the option is unavailable.
  2. Open Settings > Invoicing and select your German invoicing entity.
  3. Check your company name, German billing address, VAT number, and contact details. Use your company’s details for sender registration, rather than inventing a VAT number.
  4. Enable Transmit invoices via Peppol and complete the registration using the link shown in Hyperline. Wait until the registration status is Registered.
Your sender must be registered in the test environment even if you have already registered it in production. Generating XRechnung or ZUGFeRD files alone does not enable Peppol transmission.

​
2. Register on the receiving test portal

Create an account for your company on the OZG-RE test portal and activate it using the email you receive. This is a separate account from production OZG-RE. OZG-RE publishes these official test identifiers: A made-up VAT number is not a test destination. This recipient uses a Leitweg-ID, so do not enter either identifier as a VAT number. The German VAT numbers in sample invoices are not a substitute for a registered test receiver.

​
3. Create the test customer in Hyperline

  1. Create a company customer named OZG-RE Peppol test in your test account.
  2. Assign your German invoicing entity and complete the customer’s German billing address. Both the issuing entity and customer must be in Germany for this Hyperline flow.
  3. Open the customer details page, then Information > Edit.
  4. Enable Government affiliated. This selects the German public-sector invoice requirements for Peppol.
  5. Set Peppol participant ID to 0204:99661-WEBSERVICEOZG-28 and save.
  6. Use an internal test mailbox for customer and invoice emails.

​
4. Prepare and send the invoice

  1. From the test customer, click Create Invoice.
  2. Select your German invoicing entity and EUR currency.
  3. Add a line named Peppol delivery test, with quantity 1, net price 100 EUR, and 19% VAT. Check that the totals are 100 EUR net, 19 EUR VAT, and 119 EUR total.
  4. Set a due date and save with Create draft invoice.
  5. Before finalization, confirm that the invoice’s buyer reference is exactly 99661-WEBSERVICEOZG-28. If you cannot set or verify it, keep the invoice in draft and resolve the limitation above. A custom note, purchase order, or Peppol participant ID does not replace it.
  6. Once the reference is confirmed, finalize the invoice. If your account requires approval, complete that approval first. Hyperline then processes the eligible invoice for Peppol transmission automatically.
  7. Keep the invoice number and submission time for checking the result.
See Manage invoices for the invoice creation and approval steps.

​
5. Check the result

Check the invoice’s e-invoicing result in Hyperline. You can also use the invoice list’s E-invoicing filter to find Completed or Failed invoices. An invoice that is awaiting payment is not, by itself, proof of Peppol delivery. For confirmation on the receiving side, consult OZG-RE’s invoice status information for your submission. Its FAQ describes status tracking, but its portal tutorial states that Peppol submissions are processed separately and may not appear in the portal list. If you cannot find the invoice, ask OZG-RE sender support, linked from the tutorial, to confirm the test submission using your sender details, invoice number, submission time, and test receiver ID. Do not upload the invoice manually as proof of Peppol receipt: that would test another delivery channel. The end-to-end test is complete only when you have both successful Hyperline processing and confirmation of receipt with matching contents. If only Hyperline processing is confirmed, record the result as receipt not yet confirmed. No payment is required for this test.

​
Troubleshoot the test

For unresolved Hyperline errors, share the invoice number and displayed error through the in-app chat. See Troubleshoot accounting and e-invoicing sync errors. After testing, use each real customer’s registered Peppol ID and required buyer reference in production. Keep the OZG-RE test identifiers in your test account only.

​
Set a participant ID

To set the Peppol participant ID manually:
  1. Open the customer details page.
  2. Click Edit in the Information section.
  3. Enter the complete participant ID in Peppol participant ID, using the scheme:identifier format.
  4. Save the customer.
This optional value overrides the participant ID that Hyperline would otherwise infer from the customer’s tax ID.

​
Troubleshooting

If a Peppol invoice fails, first verify the participant ID and routing scheme in the Peppol Directory. A valid tax ID is not always the same as a valid Peppol participant ID. For broader accounting and e-invoicing sync issues, see Troubleshoot accounting and e-invoicing sync errors.