Introduction
‼️ Peppol is available for Belgium companies.
For other e-invoicing requirements, please contact your Qargo Account Manager.
This article explains how to configure and use the Peppol integration in Qargo, from initial module setup and profile configuration to processing and sending invoices, and troubleshooting e-invoices. It is intended for Qargo Admin and Super Admin users and provides step-by-step guidance to ensure invoices are correctly processed and sent.
Module Configuration (Qargo Admin only)
Enable integration under CONFIGURATION>Integrations
Toggle on option 'sync incoming invoices'
Toggle on option 'sync customer peppol information' and Qargo will automatically scan Peppol database and update fields in the profile.
B2BRouter: enable/disable the automatic creation, updates of invoices, and automatic forwarding. If disabled, even if the routing mapping gave an outcome other than 'manual review', the user will still have to approve it.
Once enabled, new fields will display in the company and subcontractor profiles
Peppol identifier override (number)
Peppol Identifier found (toggle)
RECEIVE Peppol (drop down)
SEND Peppol (drop down)
If new fields do not immediately show, navigate to CONFIGURATION>Additional fields and enable the Peppol settings from the Customer/subcontractor options.
‼️ 'Sync customer Peppol information' will be performed once when the integration is first enabled. If a new company is added, Peppol details will be automatically updated during the next sync. Sending and/or receiving invoices will not work until the new company details are validated in the Peppol sync.
Users can manually enter the following fields in the company profile to send/receive invoices right away.
Peppol availability - Toggle on
Peppol Sender settings = Allowed
Configure Task
Once the Peppol integration is enabled, the 'Send to Peppol' task should automatically be included.
Configure document attachments for Peppol
Configure which document types are automatically attached when sending invoices via Peppol — directly from the task configuration UI, without requiring manual parameter editing.
Supported attachment types include:
proof of delivery
invoice
credit note
other order documents.
CONFIGURE document attachments at task level (Super Admin)
NAVIGATE to CONFIGURATION > Tasks.
SELECT Send to Peppol from the Invoices task list.
OPEN the Contact panel within the task configuration.
SELECT the document types to attach from the attachment configuration fields. Qargo will auto-suggest relevant document types based on the types already configured for the task.
SAVE the configuration.
Once configured, the selected document types will be automatically included each time the task runs. No manual parameter entry is required.
📚 Existing task configurations have been automatically migrated to use the new document attachment format. No manual action is needed for tasks that were previously configured with the include_cmr parameter.
Override document attachments per company
Where a specific customer does not need to receive certain document types (for example, a customer who does not require proof of delivery), the attachment configuration can be overridden at the company level.
CONFIGURE a company-level attachment override
NAVIGATE to the company profile.
SCROLL to the Tasks section and expand Create invoice tasks.
SELECT the Send to Peppol task.
TOGGLE Override for this company on.
SELECT the document types to include or exclude for this company using the attachment configuration fields.
SAVE the override.
📚 Qargo will automatically skip the Peppol task for non-BE companies. The Skip task override on individual company profiles can also be used to exclude specific companies from Peppol processing entirely.
Select attachments manually when triggering from the UI
When triggering a Peppol integration action directly from the interface (rather than through automated task execution), an attachment selection modal is displayed — similar to the existing email contact task flow.
SELECT attachments manually
TRIGGER the integration action from the relevant invoice or document.
REVIEW the attachment interface that appears, showing document types suggested based on the task configuration.
SELECT or deselect document types as needed for this specific transmission.
CONFIRM to send.
Limitations
Limitation | Details |
PDF only | Qargo's Peppol access point supports PDF file attachments only. Non-PDF files such as images will not be transmitted even if selected. |
File size | Total file size (invoice + all attachments) should not exceed 100MB. Oversized transmissions will fail. |
Recipient opt-in required | Recipients must have opted in to receive the specific document types you are attaching. If a document type is not supported by the recipient, the invoice will fail. Contact the recipient's Peppol provider to review their document opt-in settings. |
‼️ Where there is a 'Required document' (CMR/POD) included with the 'send to Peppol' task, a minimum of one document (CMR/POD or other order document) per order is required. Invoices with multiple orders will fail if any order is missing a required document.
Configure a Company profile to SEND invoices
📚 Qargo will automatically skip the Peppol task for non-BE companies. Users can also set the 'Skip task' override on specific company profiles. This will restrict the Peppol task for the company where the override is applied.
To successfully send invoices via the Peppol network, company profiles associated to the Sales Invoice or Sales Credit Note, must have some fields configured.
Make sure the company linked to the sales invoice or sales credit note has one of the relevant fields filled in.
Company Registration Number (aka ondernemingsnummer) if the company is registered on the Peppol network with this identifier
VAT Number if the company is registered on the Peppol network with this identifier
Peppol Identifier Override can be used if the Peppol identifier is not based on VAT/Company ID, or if it’s a non-Belgian identifier.
Note that the identifier has the follow format
<scheme>:<identifierwhich needs to be a valid Peppol scheme and identifier.
Once the integration is active, Qargo will automatically scan the Peppol database and update data fields:
Peppol Identifier found (toggle)
Peppol settings = Allowed/Not_Allowed
ALLOWED - Company can send/receive documents over Peppol integration. System will use Peppol ID and route invoices and credit notes via Peppol Network. Requires valid Peppol Receiver ID to be entered
NOT_ALLOWED - Company is not considered 'Peppol-enabled'. System will block Peppol delivery and revert to standard method (email, portal or another alternative e-invoicing format). Prevents sending via Peppol even if ID is present
Once the main sync is complete any new companies will be updated during the next daily sync with the Peppol database.
To process invoices immediately users can manually update the fields.
Peppol Identifier found - set toggle to ON.
'RECEIVE Peppol' settings = ALLOWED
Peppol identifier (number): This field is an OVERRIDE field and should be left BLANK unless the company is using an alternate identifier, for instance a DUNS number. Qargo will automatically scan Peppol database for the associated identifier.
Peppol identifier found (toggle): Toggle ON to ensure invoices are received. Qargo will set this automatically on sync, confirming the company Peppol registration is valid and active.
SEND Peppol settings (drop down): Set to ALLOWED; authorises this company to SEND invoices into Qargo. Qargo will set this automatically on sync.
RECEIVE Peppol (drop down): Set to ALLOWED; authorises this company to RECEIVE invoices, when sent via Qargo. Qargo will set this automatically on sync.
‼️ Send / Receive Peppol Not Allowed will restrict any Peppol activity; sending or receiving invoices will not be supported.
📚 Peppol ID is derived from company information. Qargo confirms Peppol activation and updates 'Peppol Availability' toggle to ON. ID Fields ARE NOT updated automatically.
Manually update 'Peppol Identifier' field if using an alternate number (ie: DUNS) to override company or VAT number.
Example: Main billing address is head office - uses company VAT number as Peppol identifier. To bill a regional office directly, that location may use an alternate number, ie: DUNS number as their Peppol identifier.
Custom options
🧰 Custom fields may require activation under 'CONFIGRUATION>Additional fields'. Once configured, the fields should be available to add to the invoice.
Customisation options include adding:
Customer reference numbers (additional field - activation required)
Purchase order numbers (additional field - activation required)
Include document attachments (proof of delivery, CMR, credit note, and other document types)
‼️ Supports PDF attachments only. Total file size (invoice + attachments) should not exceed 100MB; oversized transmissions may result in failed tasks.
Recommendations for Recipients
To ensure smooth handling of Peppol invoices and avoid common issues:
Activate Peppol reception: Confirm that your Peppol provider has invoice reception enabled.
Configure appropriately: Regularly review Peppol settings in both your tool and Qargo to ensure compatibility.
Validate tools: Use an updated and fully functional Peppol solution to render invoices and attachments correctly. Following these best practices will significantly reduce errors and disruptions in invoice exchange.
Sales Invoice Workflow
The Sales Invoice workflow allows you to send invoices through the Peppol network following these steps:
Create Invoice: Create your Qargo Sales invoice following your existing business process.
Generate pdf of invoice
Post invoice: Post invoice task as part of the invoice workflow
Note: 'Send to accounting' task must be complete before invoice/credit note can be sent to Peppol.
The invoice MUST be in a POSTED status in accounting before sending to Peppol.
There is a hard-coded check to verify this happens.
Submit to Peppol: Submit invoice to Peppol using the 'Send Peppol Task'
• Use the regular 'Send invoice task' to generate and send a proforma invoice for approval before completing the 'Send to Peppol' task.
🎉 Once this task completes you have successfully sent over the invoice via Peppol 🎉
Troubleshooting
Qargo uses the same error message handling for Peppol invoices.
Navigate to the Errors view by clicking on the icon in the top right corner
Use the filter on the NAME column to filter specifically for a Task type
TIP: type 'peppol' into the search field to see associated tasks
Correct the error based on the message and re-trigger
General 1st step for all troubleshooting:
Check that all the correct Peppol fields are enabled on the company profile:
Peppol Identifier found - toggle is ON
Send/Receive Peppol settings - set to ALLOWED
Non-BE company peppol failed. If using Quick Actions and updating the invoices in bulk, any companies that are not in Belgium will be skipped, as these companies do not have the same Peppol requirements.
Resolution: View the batch of records being updated in bulk and verify any non-BE companies or subcontractors. Manually send invoice using the 'Send invoice task'.
Invoice not posted. The invoice is not yet in a posted state in the accounting software, therefore the 'Send to Peppol task' did not successfully complete.
Resolution: Update the invoice status to Posted and re-trigger the task.
Company doesn't accept invoices. The company or subcontractor profile isn't enabled for Peppol, and/or the Peppol settings are not updated; or set to Not_Allowed.
Resolution: Check the company and/or subcontractor profile. Under the general information make sure the Peppol settings are set to ALLOWED and that the Peppol Identifier found is toggled ON. Error: Invoices set to 'Peppol receiving – not allowed' This error indicates that the recipient has been configured to block Peppol invoice reception. To resolve this:
Adjust the Peppol settings in the recipient's profile: Set 'Peppol receiving' to 'Allowed.'
Resend the invoices using the 'Send to Peppol' feature in Qargo.
Invoice with attachments fail. As part of the Peppol registration, companies opt-in to receive specific document types, ie: CMR / POD, etc. If a document which is unsupported is included with the invoice, the invoice will fail. There is also a file size restriction - 100MB max is recommended.
Resolution:
Check the file size, for both invoice & embedded attachments is less than 100MB.
Contact the company and request a Peppol review. Advise them to review Peppol 'document opt-in' and enable the specific document type. Retrigger 'Send Peppol task' once enabled.
If the task previously used the include_cmr JSON parameter and is now failing unexpectedly, verify that the attachment configuration has been correctly migrated in CONFIGURATION > Tasks > Send to Peppol. Contact Qargo support if the configuration appears blank or incorrect after migration.
Issues with Viewing Peppol Invoice Attachments
Peppol invoices are XML files that may include attachments. If a recipient reports that they cannot see attachments, the issue is likely on their end. Attachments in Peppol invoices must be accessed and rendered using the recipient's Peppol provider tool or interface. To resolve visibility issues:
Recipients should use their Peppol solution's functionality to locate and view attachments embedded within the XML files.
If attachments remain unviewable, the recipient should consult their Peppol provider's documentation or support resources for further guidance.
Error: The recipient does not accept Peppol invoices
When this error occurs, it indicates the recipient’s Peppol participant configuration is not set up to receive invoices, or reception is not activated. This setting is managed by the recipient's Peppol provider or access point. Here’s what needs to be done:
The recipient must enable Peppol invoice reception within their Peppol provider’s interface. Without activation, the recipient cannot accept the invoice even if it’s correctly sent from Qargo.