Rechnungsimporter

The Rechnungsimporter is a Dolibarr module for importing supplier invoices as PDF files.

It uses Azure Document Intelligence for OCR and invoice data extraction.

The module supports two import methods:

• Manual import: Upload a PDF invoice directly in Dolibarr.
• Automatic import: Receive invoices through the Dolibarr Email Collector and process them automatically.

Features

• PDF invoice import
• OCR and invoice data extraction using Azure Document Intelligence
• Manual invoice upload
• Automatic invoice import through the Email Collector
• Supplier matching using VAT ID or supplier name
• Import job tracking and retry of failed imports

Installation

1. Install the module

Copy the module to:

htdocs/custom/rechnungsimporter/

Then enable the module in:

Setup > Modules/Applications

Search for Rechnungsimporter and activate it.

2. Configure Azure Document Intelligence

Create an Azure Document Intelligence resource in Microsoft Azure.

You need:

• The Azure endpoint URL
• The Azure API key

Enter both values in:

Setup > Modules/Applications > Rechnungsimporter

The module uses Azure Document Intelligence to read the invoice PDF and extract information such as:

• Invoice number
• Invoice date
• Supplier name
• Supplier VAT ID
• Invoice amounts
• Other invoice data

Manual Import

Open the Invoice Importer in Dolibarr and select:

Import Invoice

Upload a PDF invoice and start the import.

The module creates an import job. The job is then processed by the invoice importer worker.

Automatic Import with the Email Collector

The module can also process invoices automatically from email.

First configure the Dolibarr Email Collector and connect it to the mailbox that receives supplier invoices.

The Email Collector must create documents from incoming email attachments.

Configure the collector to use the Rechnungsimporter for PDF invoice attachments.

The general flow is:

Supplier
   |
   v
Email mailbox
   |
   v
Dolibarr Email Collector
   |
   v
Rechnungsimporter
   |
   v
Azure Document Intelligence
   |
   v
Invoice import

Only PDF invoice attachments are processed by the Rechnungsimporter.

The Email Collector provides the PDF to the module. The module creates an import job and sends the invoice to Azure for OCR and data extraction.

Supplier Matching

After OCR, the module tries to find the supplier in Dolibarr.

The supplier reference is determined using two values from the invoice:

1. Supplier VAT ID
2. Supplier name

The VAT ID is used to find the supplier first. If no matching supplier is found, the supplier name is used as the next matching value.

For example:

Invoice
VAT ID: DE123456789
Name: Example GmbH

The module searches the Dolibarr suppliers for a matching VAT ID.

If no VAT ID is available or no supplier is found with that VAT ID, the supplier name is used.

No Supplier Found

If neither the VAT ID nor the supplier name can be matched to an existing Dolibarr supplier, the invoice cannot be linked to a supplier automatically.

In this case, the import job remains without a supplier reference and must be handled manually.

The module does not create a new supplier automatically.

Documentation

More information about the Rechnungsimporter, including configuration and usage details, can be found on the module documentation site.