---
title: "Usage"
weight: 30
description: "User guide for the Peppol module: sending invoices, receiving, tracking, mass actions and directory search."
source_hash: "92181450"
---

# Usage

## Preparing a third party for Peppol

Before sending an invoice via Peppol, the recipient third party must have a Peppol identifier.

### Specific Peppol identifier

On a third party's card, a **Specific Peppol identifier** field allows entering an identifier in the format `XXXX:YYYYYYYYYYYYYY`. This identifier takes precedence over the intra-Community VAT number.

### Search via PeppolFinder

The **PeppolFinder** tool looks up a third party's Peppol identifier in the public Peppol directory.

1. Open the third party's card
2. Click the **PeppolFinder** button
3. The module queries the Peppol directory using the VAT number or the third party's name
4. The results display the Peppol identifier, name, country and accepted document types
5. Click **Choose this identifier** to assign it to the third party

![Searching for a Peppol identifier via PeppolFinder](screenshots/utilisation-peppol-finder.webp)

If the name found in the Peppol directory differs from the name stored in Dolibarr, a warning is displayed with the option to update the third party's name.

### Third party check

From a third party's card, the **Check** button verifies that the information is complete and compliant with Peppol requirements: name, address, zip code, city, country and VAT number.

The **Check (public directory)** button queries the Peppol directory directly to confirm that the third party is registered.

## Sending a customer invoice

### XML file generation

When you validate a customer invoice, the module automatically generates an XML file in UBL format compliant with the Peppol BIS Billing 3.0 standard. This file is attached to the invoice in the linked documents.

> **Warning**: if the invoice does not pass the compliance checks (VAT, addresses, rounding), an error message details the problems to fix.

### Compliance checks

Before generating the XML file, the module checks:

- **Your company** -- VAT number, address, zip code, city and country filled in
- **The customer** -- Name, address, zip code, city, country and VAT number (or Peppol identifier)
- **The invoice** -- Reference, date, presence of lines, non-empty descriptions
- **Amounts** -- Rounding consistency (maximum 2 decimals on line totals), match between the sum of the lines and the invoice total (tolerance of 0.02 EUR)
- **The bank account** -- Presence of an IBAN if a bank account is linked to the invoice
- **Contacts** -- If billing or delivery contacts are linked, their addresses must be complete

### Sending to the access point

1. Open the validated customer invoice
2. Click the **Peppol: Send** button
3. Confirm the sending in the dialog window
4. The module transmits the XML file to your Peppol access point

![Peppol send button on a customer invoice](screenshots/utilisation-envoi-facture.webp)

A confirmation message displays the unique identifier (UUID) of the document in the Peppol network.

> **Warning**: fees may apply depending on your contract with your Peppol provider.

### Regenerating the XML file

If you need to correct an invoice and regenerate the XML file, use the **Regenerate XML** button available in the Peppol Tracking tab of the invoice or in the export list.

## Tracking a sent invoice

### Peppol Tracking tab

Each customer invoice has a **Peppol Tracking** tab that displays the complete history of the document in the Peppol network.

![Peppol tracking tab on a customer invoice](screenshots/utilisation-suivi-peppol.webp)

The displayed information includes:

- The access point used
- The Peppol identifier of the document (UUID)
- The document status in the network (pending, in progress, confirmed)
- The sending and confirmation dates

Click **Peppol: Status** to refresh the document status from your access point.

The **Refresh from AP** button queries the access point directly to get the most recent document status.

### Column in the invoice list

If the option is enabled in the [configuration](/peppol/configuration), a **Peppol Status** column appears in the customer invoice list for quick tracking of all your sends.

## Batch sending

### Mass actions

From the customer invoice list, you can perform mass actions on several invoices at the same time:

1. Check the invoices to process
2. Choose the desired action from the drop-down menu:
   - **Send to PEPPOL** -- Sends all selected invoices to the access point
   - **Create a ZIP with all Peppol files** -- Downloads an archive containing the Peppol XML files of the selected invoices

A report is displayed at the end of the operation indicating the number of invoices sent successfully, in error or ignored (already sent, not validated or without an XML file).

## Peppol export list

The **Peppol Export** page, accessible via the menu **Billing > Customer invoices > Peppol Export**, displays the list of all invoices sent via the Peppol network.

![List of invoices exported via Peppol](screenshots/utilisation-liste-exports.webp)

This page allows you to:

- View the sending history with the sending date and status
- **Refresh status** of several documents in a single operation
- **Regenerate XML** of several invoices
- **Resend to the access point** documents already sent (if the option is enabled in the configuration)
- **Refresh pending invoices** to check their status with the access point

## Receiving supplier invoices

### Import list

The **Peppol AP Import** page, accessible via the menu **Billing > Supplier invoices > Peppol AP Import**, displays the documents available on your Peppol access point.

![List of supplier invoices available on the Peppol access point](screenshots/utilisation-liste-imports.webp)

### Viewing a received document

Click a document in the list to display its details: supplier, amount, invoice lines and source XML file. You can download the attached PDF if the supplier included it in the Peppol file.

### Creating the supplier invoice

From a received document's card, create the corresponding supplier invoice in Dolibarr. The module pre-fills the information from the XML file: supplier, reference, date, lines and amounts.

If the option is enabled in the [configuration](/peppol/configuration), the annotation entered on the import is transferred to the private note or the label of the created supplier invoice.

### Confirmation and rejection

For received documents, you can:

- **Confirm receipt** -- Signals to the supplier that the document has been received and processed (automatic on import)
- **Reject the invoice via Peppol** -- From the Dolibarr supplier invoice card (not from the import card), a **Reject via Peppol** button allows rejecting the invoice. See [Rejecting a supplier invoice](/peppol/import-facture-fournisseur#refus-dune-facture-fournisseur) for details

### Import via ScanInvoices

If the ScanInvoices module is installed, an **Import (ScanInvoices)** button allows automatically analyzing the received documents via optical character recognition.

## Peppol history

The **Peppol (History)** page, accessible via the menu **Tools > Peppol (History)**, displays a global history of all Peppol exchanges (sends and receipts).

## Credit notes

The module supports sending credit notes via Peppol. The generated XML file is a credit note type compliant with the Peppol BIS Billing 3.0 standard.

> **Warning**: if the credit note does not reference the original invoice, a warning is displayed. It is recommended to always link the credit note to the source invoice for better traceability in the Peppol network.

## Specific fields on the invoice

The module adds fields on the invoice card:

- **Delivery date** -- Delivery date of the invoiced goods or services, used in the Peppol file
- **Customer order reference** -- The customer's order reference (BuyerReference in the Peppol file)
- **VAT exemption code** -- VATEX code to select when the invoice includes zero-rated lines

## Service period (start and end dates)

On invoice lines, Dolibarr allows entering a service duration, with a start date and an end date (the input form offers these dates on service-type lines). These dates are included in the Peppol file in two places:

- at the level of each line (BT-134 and BT-135), with the dates entered on that line
- at the document level (BT-73 and BT-74), with the earliest start date and the latest end date of all lines

This period allows the recipient to spread the expense over its accounting periods, for example for a subscription spanning two years. The document period is calculated automatically; there is nothing more to enter than the usual dates on the lines.

A few details:

- if no line has a date, no period is added to the file
- only one of the two dates is enough: the period is then issued with that single bound
- a line whose start date is later than the end date is ignored for the period calculation, and the reason is traced in the Dolibarr log

## Rights and permissions

The module defines four permission levels:

| Permission | Description |
|------------|-------------|
| Read | Viewing Peppol objects |
| Create/Modify | Sending invoices and modifying Peppol settings on third parties |
| Delete | Deleting Peppol objects |
| Import | Access to importing supplier invoices from the access point |

Permissions are configurable from **Home > Setup > Users > Permissions**.
