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:

  1. Retrieval: Invoices are downloaded from the access point
  2. 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

  1. Go to Billing > Peppol Import
  2. Click the Refresh button
  3. 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

  1. Click the import reference to open the card
  2. Check the information extracted from the XML
  3. Click Import to create the supplier invoice

Mass import

  1. In the import list, check the invoices to import
  2. Select Import via ScanInvoices in the actions menu
  3. 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:

  1. Peppol identifier (peppol_id field of the third party)
  2. Intra-Community VAT number
  3. SIRET/SIREN (for French suppliers)
  4. 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

  1. Open the import card in error
  2. See the detailed error message
  3. Fix the problem (create supplier, etc.)
  4. 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):

  1. Open the relevant supplier invoice (it must be in Validated status)
  2. Click the Reject via Peppol button in the action bar
  3. Enter the rejection reason (mandatory)
  4. 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

  1. Process pending imports regularly
  2. Check imported invoices before accounting validation
  3. Configure email notifications to be alerted of new receipts

Supplier matching

To facilitate automatic identification:

  1. Fill in the Peppol identifier of your regular suppliers
  2. Check that the VAT numbers are correct
  3. Use consistent company names
  1. Retrieval: Automatic via scheduled task (daily)
  2. Verification: Consult the import list
  3. Import: Mass import of valid invoices
  4. Validation: Verification and validation of the created supplier invoices
  5. 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.