Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > agorum core Module und Plugins > Dokument | E-Rechnung
Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
E-Rechnungen (elektronische Rechnungen) sind Rechnungen in einem strukturierten, maschinenlesbaren Format. Mit dem Plugin Dokument | E-Rechnung empfangen, erkennen, prüfen, lesen und erstellen Sie E-Rechnungen in agorum core und bauen daraus eigene Workflows.
Diese Seite richtet sich an Entwickler und Administratoren. Sie gibt einen Überblick über die Standards und den rechtlichen Rahmen und beschreibt typische Abläufe für eingehende und ausgehende E-Rechnungen.
In Deutschland sind vor allem drei Formate gebräuchlich. Alle beruhen auf der europäischen Norm EN 16931:
Welche Versionen und Profile Dokument | E-Rechnung liest, prüft und erstellt und wie Sie das ZUGFeRD-Profil steuern, beschreibt E-Rechnungsformate, Versionen und Profile.
Die folgenden Punkte geben einen Überblick, Stand Oktober 2026. Sie ersetzen keine steuerliche Beratung.
Ein typischer Eingangsprozess besteht aus den folgenden Schritten. Zu jedem Schritt ist angegeben, welche Funktion des Plugins Sie dafür verwenden.
| Schritt | Was passiert | Umsetzung mit Dokument | E-Rechnung |
|---|---|---|
| 1. Empfangen | Rechnungen kommen per E-Mail, Upload, Portal oder über einen Peppol-Zugangspunkt in agorum core an. | Ablage in einem Eingangsordner, etwa über einen E-Mail-Adapter oder einen Aktiven Ordner. Dokument | E-Rechnung empfängt selbst keine Rechnungen über Peppol; dafür ist ein Zugangspunkt-Anbieter nötig, der die Dateien in agorum core ablegt. |
| 2. Erkennen | E-Rechnungen werden von sonstigen Rechnungen getrennt; das Format wird bestimmt. | check bzw. Knoten E-Rechnung prüfen; Skript check-and-move.js im Aktiven Ordner |
| 3. Prüfen | Die XML wird gegen Schema und Geschäftsregeln geprüft (KoSIT-Validator). Zusätzlich werden Positionsbeträge auf Plausibilität geprüft. | validateInvoice bzw. Knoten E-Rechnung validieren; parse mit validate: true |
| 4. Anzeigen | Die XML-Daten werden in ein lesbares PDF- oder Office-Dokument überführt. | createView bzw. Knoten Dokument aus E-Rechnung erstellen; Kontextmenü E-Rechnung > PDF-Ansicht erzeugen |
| 5. Rückmelden | Bei einer fehlerhaften Rechnung wird der Rechnungssteller informiert und um Korrektur gebeten. | Ausgang false des Validierungsknotens und der Prüfbericht; die Benachrichtigung selbst richten Sie im Workflow ein (siehe Rückmeldung an den Rechnungssteller). |
| 6. Daten übernehmen | Die Rechnungsdaten werden in einheitliche Metadaten überführt und weiterverarbeitet, etwa für Freigabe und Buchung. | parse bzw. Knoten E-Rechnung normalisieren; eingebettete Anhänge werden dabei extrahiert |
| 7. Archivieren | Original, Prüfbericht und Ansicht werden gemeinsam aufbewahrt. | Ablage in agorum core; das Original bleibt unverändert |
Hinweis: parse und der Knoten E-Rechnung normalisieren liefern die normalisierten Daten in einer Variable zurück. Sie werden nicht automatisch als Metadaten am Dokument gespeichert. Wenn Sie die Daten am Dokument brauchen, etwa für eine Suche, speichern Sie sie in einem nachfolgenden Schritt.
Dokument | E-Rechnung bewertet die Rechnung und liefert einen Prüfbericht. Eine automatische Antwort an den Rechnungssteller, etwa eine E-Mail oder eine Peppol-Statusmeldung, versendet das Plugin nicht. Diese Rückmeldung richten Sie im Workflow ein:
Tipp: Weisen Sie Rechnungen mit Formatfehlern zurück und bitten Sie um eine neue Rechnung. Bei reinen Geschäftsregel-Fehlern oder Warnungen kann eine Annahme mit Korrekturbitte genügen. Der Prüfbericht des KoSIT-Validators enthält dazu eine Empfehlung, siehe Mit E-Rechnungen arbeiten.
In diesem Beispielworkflow passiert Folgendes:
Wenn Sie vor der Anzeige und Weiterverarbeitung sicherstellen wollen, dass die Rechnungen gültig sind, bauen Sie eine Prüfung ein:
Der validateInvoice-Knoten prüft die eingehenden E-Rechnungen mit dem KoSIT-Validator (siehe Knoten "E-Rechnung validieren"). Außerdem zeigt der Workflow, dass eine E-Rechnung Dokumente als Anhänge enthalten kann. Der parse-Knoten extrahiert und decodiert diese Anhänge, sodass sie als eigene Dokumente abgelegt werden können.
Ausgehende E-Rechnungen entstehen aus den normalisierten Rechnungsdaten:
Eine Schritt-für-Schritt-Anleitung für beide Ausgangslagen – vorhandene Rechnungsdaten und Neuerfassung – finden Sie in E-Rechnungen erstellen.
Dieser Workflow erhält die normalisierten Daten von außen und erzeugt daraus die E-Rechnung: