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 sie 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.

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"
}

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", … },
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	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
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.