---
title: "Configuration"
weight: 20
description: "Complete configuration of the Peppol module: general settings, access point, VAT exemptions and third parties."
source_hash: "19297d3c"
---

# Configuration

The module configuration is found in **Home > Setup > Modules > Peppol**. It is organized in several tabs.

## General settings

The **Settings** tab contains the module's operating options.

![General configuration page of the Peppol module](screenshots/configuration-reglages.webp)

### Free line management

- **Create an item reference for free lines** -- If enabled, the first 16 characters of each free line's description are used as the item reference in the Peppol XML file.

### VAT management

- **Force creation of an XML file without a VAT number** -- Allows generating a Peppol file even if the customer has no intra-Community VAT number. The file then uses the special code `ZZ00000000`. This file is not compliant with the Peppol standard but can be used for internal dematerialization.

### Warnings

- **Disable the warning message for customers without a Peppol ID** -- Removes the alert displayed on invoice cards when the customer has no Peppol identifier.

### Order reference

- **Force assignment of an order reference if empty** -- The Peppol standard requires a purchase order reference. If none of this information exists, this option automatically assigns the value "NA".

### Attachments

- **Embed all PDF files** -- Integrates all PDF files attached to the invoice into the Peppol XML file.
- **Merge all PDFs into a single document** -- Merges the invoice PDF and its attachments into a single file before embedding it in the XML. This option is incompatible with the previous one.
- **Embed all supported attached files** -- Automatically integrates all attached files whose format is allowed by the Peppol BIS 3.0 standard: PDF, PNG, JPEG, CSV, XLSX, ODS. Other formats are ignored.

> **Warning**: the total size of the XML file is limited to about 10 MB depending on the access points.

### Display

- **Add a column in the customer invoice list** -- Displays an additional column with the Peppol status in the customer invoice list.

### Secondary VAT number

If your company has **two VAT numbers** (for example a main Belgian number `BE...` and a Luxembourg number `LU...` linked to a branch), you can declare them as follows:

- **Main VAT number** -- Entered in **Setup > Company > VAT number**. This is the number associated with your Peppol identifier registered in the SMP (network).
- **Secondary VAT number** -- Entered in the Peppol module, **Secondary VAT number** field (e.g. `LU98765432`). Leave empty if you only have one number.

> **Important**: **never** enter two numbers separated by a dash in the main VAT field (e.g. `BE0123456789 - LU98765432`). The module detects this case and uses only the first number, but the good practice is to enter a single number in the main field and configure the second one here.

When a secondary number is configured, a **"Peppol VAT number"** drop-down list automatically appears on customer invoices being edited. It allows you to choose, per invoice, which of the two numbers will be used in the Peppol XML:

- **Main** (default value) -- uses the VAT number from the company card.
- **Secondary** -- uses the secondary VAT number configured here.

> **Peppol routing note**: the choice only changes the VAT number written in the body of the XML. Peppol routing (invoice delivery) remains linked to your main identifier registered in the SMP. This feature is useful for maintaining tax consistency (VAT number matching the regime under which the invoice was issued).

> **Recommendation**: if your company regularly invoices under two different tax regimes with two separate accounting systems, the multi-company Dolibarr approach (one company per legal entity) is generally cleaner and more compliant.

### Email notifications

- **Send an email copy when sending** -- Sends a copy of the XML file to the configured address each time a document is sent to the Peppol access point.
- **Send an email copy when receiving** -- Sends a copy of the XML file to the configured address each time a document is received from the Peppol access point.
- **Email address(es) for sent/received documents** -- Destination addresses for the copies. Several addresses can be separated by semicolons.
- **Email subject and message for sent/received documents** -- Replace the default text of the copies, with variables such as `__REF__`. When left empty, the default text applies. The XML file is always attached.

The variables and sample messages are detailed in [Email copies](/peppol/emails-de-copie).

### Customer notification

- **Send a notification email to the customer after sending** -- Automatically sends an email to the customer to inform them that an invoice has been transmitted to them via the Peppol network.
- **Email template to use** -- Select an existing email template of type "Invoice sending". To create a new one, go to **Setup > Emails > Email templates**.

### Advanced options

- **Enable Peppol file creation on the Dolibarr trigger** -- Activates automatic generation of the XML file when invoices are created via Dolibarr's internal API. This option is reserved for cases where your Dolibarr generates invoices via API.

## Access point configuration

The **Access point configuration** tab allows you to set up the connection to your Peppol provider.

![Peppol access point configuration page](screenshots/configuration-point-acces.webp)

### Provider choice

Select your Peppol access point provider from the drop-down list. Each provider displays its compatibility level:

- **Complete** -- All features are operational
- **Almost complete** -- Main features operational
- **In progress** -- Integration under development
- **Planned** -- Planned but not yet developed

### Connection settings

Depending on the chosen provider, the following fields may appear:

- **Your company's Peppol ID** -- Your Peppol identifier in the format `XXXX:YYYYYYYYYYYYYY` (for example `0208:0000000097`). This identifier is provided to you by your access point.
- **Customer ID** -- Your customer code with the Peppol provider.
- **API key** -- Your connection key to the access point API.
- **API password** -- The password associated with your API key.

### Webhook

- **Enable the incoming webhook** -- Allows your access point to automatically notify your Dolibarr when new documents arrive. Your Dolibarr instance must be reachable from the Internet.
- **Webhook security key** -- Security code provided by your access point.

### Production mode

- **Switch to production mode** -- Switch from test mode (sandbox) to production mode once your tests are conclusive.

### Resending

- **Allow resending a document** -- Allows resending a document already sent to the access point. If this option is disabled, the "Send" button is greyed out after the first sending.

## Connection check

The **Check** tab allows you to test the connection with your Peppol access point. Click the **Connection test** button to verify that the settings are correct.

![Connection test page for the Peppol access point](screenshots/configuration-verification.webp)

## VAT exemptions

The **VAT exemption** tab manages the VAT exemption codes compliant with the Peppol standard (VATEX codes). These codes are used when an invoice line has 0% VAT to indicate the legal reason for the exemption.

![Peppol VAT exemption code management page](screenshots/configuration-vatex.webp)

### Code categories

Codes are classified by tax category:

- **K** -- Intra-Community supply (VATEX-EU-IC)
- **AE** -- Reverse charge (VATEX-EU-AE)
- **G** -- Export outside the EU (VATEX-EU-G)
- **O** -- Not subject to VAT (VATEX-EU-O)
- **E** -- General exemptions (articles 132, 143, 148, 151 of Directive 2006/112/EC)

Codes specific to France are also available (franchise in base, CGI articles).

### Dictionary management

Click the dictionary link to enable, disable or modify the exemption codes. Only active codes appear in the drop-down list of the invoice form.

## Third parties without a Peppol identifier

The **Third parties** tab displays the list of all customers and suppliers that do not yet have a Peppol identifier configured. Individuals are excluded from this list.

![Page listing third parties without a Peppol identifier](screenshots/configuration-tiers.webp)

### Individual assignment

For each third party with an intra-Community VAT number, click the **PeppolFinder** button to look up its identifier in the Peppol directory and assign it automatically.

### Mass assignment

1. Check the relevant third parties in the list
2. Click the **Mass assignment** button
3. The system automatically looks up the Peppol identifier of each selected third party via its VAT number
4. A detailed report displays the results: identifiers found, third parties not found, possible errors

## Import configuration

The **Import configuration** section in the Settings tab allows you to configure the behavior when importing supplier invoices:

- **Transfer the annotation to the supplier invoice** -- Copies the annotation field from the import to the created invoice.
- **Destination field** -- Choose between the private note and the invoice label.
- **Delay between each import (ms)** -- Adjust the delay between batch imports to avoid overloading the server (default: 500 ms).

## Automatic sending (Cron)

The **Auto send** tab configures the scheduled task for automatically sending invoices to the Peppol network.

![Peppol automatic sending configuration page](screenshots/configuration-cron.webp)

> **Warning**: the scheduled task must also be enabled in **Home > Setup > Scheduled tasks** of Dolibarr for automatic sending to work.

### General settings

- **Automatically send invoices to PEPPOL** -- Activates automatic sending of validated invoices that have an XML file and a customer with a Peppol identifier.
- **Email address for the execution report** -- If filled in, a report email is sent after each cron execution.
- **Send the report only on error** -- Limits sending the report to executions that include errors.

### Sending filters

- **Do not send invoices created before this date** -- Format YYYY-MM-DD. Invoices prior to this date are ignored.
- **Exclude paid invoices** -- Invoices already paid are not sent automatically.
- **Delay before sending (hours)** -- Number of hours to wait after invoice validation before sending it (default: 24). This delay allows correcting possible errors.

### Limits

- **Maximum number of invoices per execution** -- Limits the number of invoices processed per cron execution to avoid timeouts (default: 50).

### Time restrictions

- **Sending start time** -- Sending only takes place after this time. Leave empty for no restriction.
- **Sending end time** -- Sending only takes place before this time. Leave empty for no restriction.

### Automatic retry

- **Enable automatic retry of invoices in error** -- Invoices whose sending failed are automatically resent.
- **Retry delay (hours)** -- Number of hours to wait before retrying an invoice in error (default: 24).
- **Maximum number of attempts** -- Maximum number of resend attempts for an invoice in error (default: 3).
