Rechnungsimporter

Der Rechnungsimporter ist ein Dolibarr-Modul zum Importieren von Lieferantenrechnungen als PDF-Dateien.

Das Modul verwendet Azure Document Intelligence zur OCR-Erkennung und zum Auslesen der Rechnungsdaten.

Das Modul unterstützt zwei Importwege:

• Manueller Import: Eine PDF-Rechnung direkt in Dolibarr hochladen.
• Automatischer Import: Rechnungen über den Dolibarr Email Collector empfangen und automatisch verarbeiten.

Funktionen

• Import von PDF-Rechnungen
• OCR und Rechnungserkennung über Azure Document Intelligence
• Manueller Rechnungsimport
• Automatischer Rechnungsimport über den Email Collector
• Lieferantenzuordnung über USt-IdNr. oder Lieferantenname
• Verwaltung von Importaufträgen und erneutes Starten fehlgeschlagener Importe

Installation

1. Modul installieren

Kopieren Sie das Modul nach:

htdocs/custom/rechnungsimporter/

Aktivieren Sie das Modul anschließend unter:

Setup > Module/Applications

Suchen Sie nach Rechnungsimporter und aktivieren Sie das Modul.

2. Azure Document Intelligence konfigurieren

Erstellen Sie eine Azure Document Intelligence-Ressource in Microsoft Azure.

Sie benötigen:

• Die Azure-Endpunkt-URL
• Den Azure API-Schlüssel

Tragen Sie beide Werte hier ein:

Setup > Module/Anwendungen > Rechnungsimporter

Das Modul verwendet Azure Document Intelligence, um die PDF-Rechnung zu analysieren und Daten wie folgende auszulesen:

• Rechnungsnummer
• Rechnungsdatum
• Lieferantenname
• USt-IdNr.
• Rechnungsbeträge
• Weitere Rechnungsdaten

Manueller Import

Öffnen Sie den Rechnungsimporter in Dolibarr und wählen Sie:

Rechnung importieren

Laden Sie eine PDF-Rechnung hoch und starten Sie den Import.

Das Modul erstellt einen Importauftrag. Dieser wird anschließend vom Rechnungsimporter-Worker verarbeitet.

Automatischer Import über den Email Collector

Das Modul kann Rechnungen auch automatisch per E-Mail verarbeiten.

Konfigurieren Sie zunächst den Dolibarr Email Collector und verbinden Sie ihn mit dem Postfach, in dem die Lieferantenrechnungen eingehen.

Der Email Collector muss die Anhänge eingehender E-Mails erfassen.

Konfigurieren Sie den Collector so, dass PDF-Rechnungsanhänge an den Rechnungsimporter übergeben werden.

Der Ablauf sieht grundsätzlich so aus:

Lieferant
   |
   v
E-Mail-Postfach
   |
   v
Dolibarr Email Collector
   |
   v
Rechnungsimporter
   |
   v
Azure Document Intelligence
   |
   v
Rechnungsimport

Der Rechnungsimporter verarbeitet nur PDF-Rechnungsanhänge.

Der Email Collector übergibt die PDF-Datei an das Modul. Das Modul erstellt einen Importauftrag und sendet die Rechnung zur OCR-Analyse und Datenerkennung an Azure.

Lieferantenzuordnung

Nach der OCR-Erkennung versucht das Modul, den Lieferanten in Dolibarr zu finden.

Für die Zuordnung werden zwei Werte aus der Rechnung verwendet:

1. USt-IdNr. des Lieferanten
2. Name des Lieferanten

Zuerst wird anhand der USt-IdNr. nach einem passenden Lieferanten gesucht. Wird kein passender Lieferant gefunden, wird anschließend der Lieferantenname verwendet.

Beispiel:

Rechnung
USt-IdNr.: DE123456789
Name: Example GmbH

Das Modul sucht zunächst nach einem Lieferanten mit der angegebenen USt-IdNr.

Ist keine USt-IdNr. vorhanden oder wird kein Lieferant mit dieser USt-IdNr. gefunden, wird nach dem Lieferantennamen gesucht.

Kein Lieferant gefunden

Wenn weder die USt-IdNr. noch der Lieferantenname einem bestehenden Lieferanten in Dolibarr zugeordnet werden können, wird die Rechnung keinem Lieferanten automatisch zugeordnet.

Der Importauftrag bleibt in diesem Fall ohne Lieferantenreferenz und muss manuell bearbeitet werden.

Das Modul legt nicht automatisch einen neuen Lieferanten an.

Dokumentation

Weitere Informationen zum Rechnungsimporter, einschließlich Konfiguration und Verwendung, finden Sie auf der Dokumentationsseite des Moduls.