Receiving invoices via Peppol
The Peppol module allows you to automatically receive supplier invoices transmitted via the Peppol network and import them into Dolibarr.
The process takes place in two steps:
- Retrieval: Invoices are downloaded from the access point
- Import: Invoices are converted into Dolibarr supplier invoices
Retrieving invoices
Automatic retrieval
The scheduled task automatically retrieves new invoices. See Peppol scheduled task.
Manual retrieval
- Go to Billing > Peppol Import
- Click the Refresh button
- The module queries the access point and downloads the new invoices
Import list
Go to Billing > Peppol Import to see all received invoices.
Displayed columns
| Column | Description |
|---|---|
| Reference | Internal import identifier |
| File | Name of the received XML file |
| Supplier | Supplier name (if identified) |
| Invoice | Link to the created supplier invoice |
| Status | Processing status |
| Date | Reception date |
Possible statuses
| Status | Description | Action |
|---|---|---|
| Draft | Invoice received, not processed | Import |
| Validated | Import successful, invoice created | View the invoice |
| Error | Import failed | Fix and retry |
| Cancelled | Import manually cancelled | - |
Importing invoices
Individual import
- Click the import reference to open the card
- Check the information extracted from the XML
- Click Import to create the supplier invoice
Mass import
- In the import list, check the invoices to import
- Select Import via ScanInvoices in the actions menu
- Confirm the import
The mass import uses a progressive system that:
- Processes invoices one by one
- Displays progress in real time
- Allows pausing or cancelling
- Automatically resumes in case of a temporary error
Automatic processing
During import, the module automatically performs:
1. Supplier identification
The module looks up the supplier by:
- Peppol identifier (
peppol_idfield of the third party) - Intra-Community VAT number
- SIRET/SIREN (for French suppliers)
- Company name
If the supplier is not found, it can be created automatically with the information from the XML.
2. Supplier invoice creation
The supplier invoice is created with:
- Supplier reference (original invoice number)
- Invoice date
- Due date
- Invoice lines with:
- Description
- Quantity
- Unit price
- VAT rate
- Totals
3. File attachment
The original XML file and the PDF (if available) are attached to the supplier invoice.
4. Annotations (optional)
If configured, the module can add annotations:
- In the invoice's private note
- Or in the invoice label
Configuration in Setup > Modules > Peppol > Settings:
- Enable annotations: Yes/No
- Annotation target: Private note or Label
Import card
The import card details the information extracted from the XML:
Supplier information
- Company name
- Complete address
- VAT number
- Peppol identifier
Invoice information
- Invoice number
- Issue date
- Due date
- Currency
Invoice lines
- Description of each line
- Quantity and unit price
- VAT rate
Totals
- Total excluding VAT
- Total VAT per rate
- Total including VAT
Files
- Original XML (downloadable)
- Attached PDF if available
Error management
Common errors
| Error | Cause | Solution |
|---|---|---|
| Supplier not identified | No match found | Create the supplier manually and reimport |
| Duplicate invoice | Same supplier reference already exists | Check whether the invoice has already been imported |
| XML parsing error | Malformed XML file | Contact the supplier |
| Product/Service not found | Unknown item reference | Create the item or modify the mapping |
Error handling
- Open the import card in error
- See the detailed error message
- Fix the problem (create supplier, etc.)
- Click Reimport
Rejecting a supplier invoice
If an invoice received via Peppol is incorrect, you can reject it directly from the supplier invoice card in Dolibarr (not from the Peppol import card):
- Open the relevant supplier invoice (it must be in Validated status)
- Click the Reject via Peppol button in the action bar
- Enter the rejection reason (mandatory)
- Confirm
The module then automatically:
- Notification to the access point: the supplier is informed of the rejection via the Peppol network (if the access point supports this feature)
- Status change to Abandoned: the supplier invoice moves to "Abandoned" status in Dolibarr with the rejection reason
- Traceability: an event is created in the invoice history with the rejection details
- Import update: the Peppol import record moves to "Cancelled" status
Warning: the button only appears if the invoice is in Validated status, is linked to a Peppol import and you have the necessary rights (Peppol: Write + Supplier invoices: Create).
Warning: not all access points support rejection. If your access point does not handle it, a warning message will inform you.
Receipt confirmation
After a successful import, the module can confirm receipt to the access point. This confirmation:
- Tells the supplier that its invoice has been received
- Removes the invoice from the access point's queue
The confirmation is automatic on import.
Best practices
Organization
- Process pending imports regularly
- Check imported invoices before accounting validation
- Configure email notifications to be alerted of new receipts
Supplier matching
To facilitate automatic identification:
- Fill in the Peppol identifier of your regular suppliers
- Check that the VAT numbers are correct
- Use consistent company names
Recommended workflow
- Retrieval: Automatic via scheduled task (daily)
- Verification: Consult the import list
- Import: Mass import of valid invoices
- Validation: Verification and validation of the created supplier invoices
- Accounting: Integration into the usual accounting process
Access rights
To access the Peppol import, the user must have the following rights:
- Peppol: Import
- Third parties: Read and Create
- Suppliers: Read
- Supplier invoices: Read and Create
- Products: Read
- Services: Read
These rights are automatically checked when accessing the page.