Knoten „E-Rechnung normalisieren“ verwenden

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins agorum core electronic invoicing. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Interne ID: agorum.electronic.invoicing.parse

Dieser Knoten verarbeitet elektronische Rechnungen (E-Rechnungen) und wandelt die XML-Rechnungsdaten in ein normalisiertes Format um, das in agorum core über Metadaten verwendet werden kann. Der Knoten unterstützt und verarbeitet Daten aus verschiedenen XRechnungsformaten:

XRechnung im UBL-Format (Universal Business Language)
XRechnung im CII-Format (Cross Industry Invoice)

Aussehen des Knotens

Verhaltensweise

Der Knoten liest die übergebenen E-Rechnungsdaten und ordnet die eingelesenen Rechnungsdaten den normalisierten Metadaten in agorum core zu. Bei Bedarf erstellt der Knoten einen temporären Ordner für die Rechnungsanhänge, also andere Dateien, die die Rechnungs-XML-Datei in kodierter Form enthalten kann.

Hinweis: agorum core electronic invoicing liest und übernimmt ausschließlich die Daten aus den XML-Dateien. Die Daten werden nicht verändert. Plausibilitätsprüfungen können auf etwaige Unstimmigkeiten in den Daten hinweisen, diese aber nicht verändern.

Der Knoten führt rudimentäre logische Prüfungen der Rechnungsdaten durch. Diese Prüfungen führen lediglich zu einer Information über das Ergebnis der Prüfung. Sie haben keinen Einfluss auf die Rechnungsdaten oder die Fortsetzung des Workflows. Aktuell werden folgende Prüfungen durchgeführt:

Für die Einzelpositionen:

Wenn ein Netto-Einzelpreis vorhanden ist, ist auch ein Netto-Gesamtpreis vorhanden?
Wenn ein Brutto-Einzelpreis vorhanden ist, ist auch ein Brutto-Gesamtpreis vorhanden?
Wenn die Menge größer 1 ist, entspricht der berechnete Gesamt-Netto- bzw. Gesamt-Brutto-Betrag der Summe der Einzelbeträge mit einer Karenz von 1 Cent?

Für den Gesamtbetrag:

Wenn eine Umsatzsteuer von mehr als 0 Prozent angegeben ist, ist der Brutto-Betrag ungleich dem Netto-Betrag?

Anwendung

Beispiel

Sie können den Workflow-Knoten dazu verwenden, die E-Rechnungsdaten einzulesen und in das normalisierte Format zu überführen. In diesem Beispielworkflow wird anschließend eines der mitgelieferten Dokumententemplates verwendet, um das Dokument darzustellen. Es handelt sich bei dieser Anzeige des Dokuments also nicht um die Darstellung des Rechnungsausstellers, sondern um eine Möglichkeit zur Anzeige der XRechnung in einem frei gewählten Darstellungsformat.

Beispielworkflow mit dem parse-Knoten

Das Ergebnis der Verarbeitung mit dem parse-Knoten hat in diesem Beispiel folgende Struktur:

{
  "tempFolder": [
  ],
  "attachmentDocuments": [
  ],
  "parsedData": {
  },
  "format": "zugferd_cii"
}

Wenn Sie zusätzlich den Parameter Datenvariable Rechnungsdaten angeben, würde das Ergebnis zusätzlich die Original-XML-Daten konvertiert in einer JSON-Struktur enthalten, hier mit dem Variablennamen rawDataJsonPresentation.

Ergebnis	Beschreibung	Beispiel
tempFolder	UUID des temporären Ordners für die Rechnungsanhänge	"tempFolder": [ "ae324430-6f63-11ef-bd0a-02420a0a000e" ]
attachmentDocuments	UUIDs der Rechnungsanhänge. Die Rechnungsanhänge werden mit dem Metadatum Ursprung geschrieben. Darüber wird das Quelldokument, also die XML-Rechnung, angegeben.	"attachmentDocuments": [ "ae3c0830-6f63-11ef-bd0a-02420a0a000e" ]
parsedData	Normalisierte Rechnungsdaten.	"parsedData": { "agorum_accounting_document_due_date": "2024-07-02T10:00:00.000Z", "agorum_accounting_document_total_tax_rate_1": 19, "agorum_accounting_document_total_tax_rate_2": 7, "agorum_accounting_document_total_net_amount_2": 5409.84, "agorum_accounting_document_version_id": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0", … },
rawDataJsonPresentation	Original-Rechnungsdaten aus der XML-Rechnung (konvertiert von XML nach JSON).	"rawDataJsonPresentation": { "rsm:CrossIndustryInvoice": { "rsm:ExchangedDocumentContext": { "ram:GuidelineSpecifiedDocumentContextParameter": { "ram:ID": "urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.3" } }, "~xmlns:a": "urn:un:unece:uncefact:data:standard:QualifiedDataType:100", "~xmlns:rsm": "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100", … },
format	Format der E-Rechnung. Die möglichen Werte sind: xrechnung_cii xrechnung_ubl zugferd_cii	"format": "zugferd_cii"

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Eingangsvariable	Mit diesem Parameter geben Sie das Dokument an, welches für die Generierung der normalisierten Daten verwendet werden soll. Wenn Sie die Variable leer lassen, werden automatisch die Anhänge des Workflows genommen. Diese Anhänge sind in der internen Variable sys_acw_attachments vorhanden. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.
Datenvariable Rechnungsdaten	Mit diesem Parameter geben Sie an, unter welchem Wert (Namen) die Arbeitsdaten für den Knoten im Token enthalten sind. Die Daten beinhalten die normalisierten Daten der Rechnung. Sie können die Daten der Datenvariable in anderen Knoten, wie dem Erstellen einer Ansicht, weiterverwenden. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	parsedData
Roh-Daten	Mit diesem Parameter geben Sie an, wo im Token die originalen Rechnungsdaten, die Roh-Daten für die normalisierte Form, enthalten sind. Diese Daten sind die Original-XML-Daten in konvertierter JSON-Form. Sie können die Daten der Datenvariable Rechnungsdaten in anderen Knoten weiterverwenden, etwa in einem Skript-Knoten. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	rawDataJsonPresentation
Ausgangsvariable	Mit diesem Parameter geben Sie an, wo das Ergebnis des Knotens gespeichert werden soll. Dabei werden ein oder mehrere Dokumente erzeugt, welche für weitere Knoten verwendet werden können. Bei den Dokumenten handelt es sich um die übertragenen Anhänge der XML-Rechnung. Wenn Sie die Variable leer lassen, überschreibt das Ergebnis die aktuellen Attachments des Workflows (Variable sys_acw_attachments). In der Ausgangsvariable wird stets ein Array hinterlegt, auch wenn nur ein Eintrag vorhanden ist. Ist das Ergebnis des Knotens leer, so ist das Array ein leeres Array: [] Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	attachmentDocuments
Rechte	Siehe Rechte auf Knoten vergeben

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.