---
title: "Importing a supplier invoice"
weight: 110
description: "Receiving and importing supplier invoices via the Peppol network in Dolibarr."
source_hash: "5a02db4c"
---

# 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](/peppol/tache-planifiee-peppol).

### 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

### Recommended workflow

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.
