Knoten „E-Rechnung aus normalisierten Daten" erstellen

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

Dieser Knoten dient zum Erstellen einer ausgehenden E-Rechnung. Sie können mit diesem Knoten aus der normalisierten Form, also den in einer JSON-Struktur übergebenen Metadaten, eine E-Rechnung in den verschiedenen Formaten erzeugen.

Der Knoten kann folgende E-Rechnungsformate erzeugen:

ZUGFeRD V2.2 (CII)
X-Rechnung V3.0 (CII)
X-Rechnung V3.0 (UBL)
Peppol BIS3 Invoice (UBL)

Ausstehen des Knotens

Der Knoten erwartet Rechnungsdaten im normalisierten agorum-Format. Die JSON-Struktur mit den normalisierten Daten können Sie etwa erstellen, indem Sie ein Mapping-Script schreiben, das die Rechnungsdaten in das normalisierte Format überführt. Weitere Informationen über die internen agorum-Daten, die benötigt werden, finden Sie hier: Normalisierte Daten für die E-Rechnung

Verhaltensweise

Der Knoten überführt die eingehende Struktur der normalisierten Rechnungsdaten in das angegebene E-Rechnungsformat. Für die Verwendung des Knotens sind folgende Daten/Angaben erforderlich:

Eingangsdaten: normalisierte Rechnungsdaten
Format: Angabe des Formats, das erzeugt werden soll: ZUGFeRD V2.2 (CII), X-Rechnung V3.0 (CII), X-Rechnung V3.0 (UBL) oder Peppol BIS3 Invoice (UBL)
PDF-Dokument, wenn die XRechnung als Anhang in das Dokument integriert werden soll (ZUGFeRD)

Optional können Sie Anhänge für die XRechnung-XML-Ausgabe mitgeben, etwa wenn Sie eine Originalrechnung in einem anderen Format oder einen Lieferschein haben, der in kodierter Form in die XML-Daten integriert werden soll.

Der createInvoice-Knoten prüft die eingehenden Daten und konvertiert sie in das angegebene XML-Rechnungsformat (UBL oder CII). Dabei prüft der Knoten, ob die erzeugte Struktur formal korrekt ist. Wenn der Knoten aus den empfangenen Daten keine korrekte XML-Struktur generieren kann, wird eine entsprechende Fehlermeldung ausgegeben, damit die Daten korrigiert werden können.

Wenn der Knoten eine E-Rechnung im ZUGFeRD-Format erstellen soll, integriert er die erzeugten XML-Daten zusätzlich in die angegebene PDF-Datei und konvertiert diese zu einem ZUGFeRD-PDF.

In weiteren Workflowschritten können Sie die erstellten Dokumente weiterverwenden oder am gewünschten Ort ablegen. Die elektronischen Rechnungen können Sie etwa per E-Mail versenden oder über ein Portal an den Rechnungsempfänger übergeben.

Anwendung

Beispiel

Sie können den createInvoice-Knoten in Workflows integrieren, um E-Rechnungen in einem der angegebenen Formate zu erzeugen.

Beispielworkflow mit dem createInvoice-Knoten

In diesem Beispiel wird ein PDF-Dokument an den Knoten übergeben, das als Grundlage für die Erstellung der ZUGFeRD-Rechnung verwendet wird. Der Knoten benötigt weiterhin die normalisierten Metadaten, die hier nicht sichtbar über eine Variable übergeben werden. Die übergebene Datenstruktur muss etwa folgende Form haben:

  "parsedData": {
    "agorum_accounting_document_delivery_postcalcode": "99988",
    "agorum_accounting_document_due_date": "2024-09-24T10: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": 720,
    "agorum_accounting_document_delivery_address": "Lieferstraße 1",
    "agorum_accounting_document_supplier_bic": "DEUTDESS611",
    "agorum_accounting_document_total_discount_amount": 0,
    "agorum_accounting_document_version_id": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "agorum_accounting_document_reference_goods_receipt_notification": "6544565476",
    "agorum_accounting_document_tax_id_2": "S",
    "agorum_accounting_document_tax_id_1": "S",
    "agorum_accounting_document_type_code": "380",
    "agorum_accounting_document_sales_reference": "364-123-454",
    "agorum_accounting_document_addition_discount_list": [],
    "agorum_accounting_document_supplier_country": "DE",
    "agorum_accounting_document_is_credit_note": false,
    "agorum_accounting_document_object_identification": "763454564",
    "agorum_accounting_document_supplier_street": "Vogelsangstraße 22",
    "agorum_accounting_document_supplier_vat_id": "DE198023952",
    "agorum_accounting_document_customer_country": "DE",
    "agorum_accounting_document_date": "2024-09-09T10:00:00.000Z",
    "agorum_accounting_document_currency": "EUR",
    "agorum_accounting_document_item_list": [
      {
        "additionalInformation": [
          {
            "label": "Positionsnummer:",
            "value": "1"
          }
        ],
        "quantity": "4",
        "item_id": "b8f074bf-175a-49b3-8dce-51ee1ecd84b5",
        "tax_rate_currency": "EUR",
        "addition_discount_list": [],
        "description": "Tastatur",
        "net_price": "50",
        "tax_rate": "19",
        "number": "1",
        "unit": "Stück",
        "net_amount": "200",
        "net_amount_currency": "EUR",
        "net_price_currency": "EUR",
        "invoice_currency": "EUR"
      },
      {
        "additionalInformation": [
          {
            "label": "Positionsnummer:",
            "value": "2"
          }
        ],
        "quantity": "6",
        "item_id": "56d8c033-064b-4d8d-b55f-c6c60e290f44",
        "tax_rate_currency": "EUR",
        "addition_discount_list": [],
        "description": "Webcam",
        "net_price": "120",
        "tax_rate": "7",
        "number": "2",
        "unit": "Stück",
        "net_amount": "720",
        "net_amount_currency": "EUR",
        "net_price_currency": "EUR",
        "invoice_currency": "EUR"
      }
    ],
    "agorum_accounting_document_delivery_place": "111222333",
    "agorum_accounting_document_invoice_period_from_date": "2024-06-01T10:00:00.000Z",
    "agorum_accounting_document_function_code": "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0",
    "agorum_accounting_document_contract_reference": "666/111/222",
    "agorum_accounting_document_payment_method": "30",
    "agorum_accounting_document_total_tax_amount_2": 50.4,
    "agorum_accounting_document_supplier_city": "Ostfildern",
    "agorum_accounting_document_total_tax_amount_1": 38,
    "agorum_accounting_document_accounting_cost": "3645723489",
    "agorum_accounting_document_supplier_phone": "+12345856956",
    "agorum_accounting_document_total_net_amount_1": 200,
    "agorum_accounting_document_total_net_amount": 920,
    "agorum_accounting_document_total_discountable_amount": 920,
    "agorum_accounting_document_customer_vat_type": "VAT",
    "agorum_accounting_document_invoice_period_until_date": "2024-12-31T11:00:00.000Z",
    "agorum_accounting_document_delivery_date": "2024-09-30T10:00:00.000Z",
    "agorum_accounting_document_invoice_currency": "EUR",
    "agorum_accounting_document_supplier_vat_type": "VAT",
    "agorum_accounting_document_project_reference": "23345454565",
    "agorum_accounting_document_delivery_note_number": "717458183",
    "agorum_accounting_document_tax_schema_id1": "VAT",
    "agorum_accounting_document_tax_schema_id2": "VAT",
    "agorum_accounting_document_tax_point_date": "2024-09-15T10:00:00.000Z",
    "agorum_accounting_document_supplier_assigned_account_id": "EXT_IDENT_02",
    "agorum_accounting_document_total_add_amount": 0,
    "agorum_accounting_document_order_number": "123-456-789",
    "agorum_accounting_document_customer_state": "Baden-Württemberg",
    "agorum_accounting_document_total_gross_amount": 1008.4,
    "agorum_accounting_document_number": "987654321",
    "agorum_accounting_document_customer_city": "Musterhausen",
    "agorum_accounting_document_payment_iban": "DE26611700760151951100",
    "agorum_accounting_document_supplier_name": "agorum Software GmbH",
    "agorum_accounting_document_customer_street": "Musterstraße 22",
    "agorum_accounting_document_customer_zip": "73760",
    "agorum_accounting_document_note": "Die Bestellung wurde abgeschlossen, da neue Hardware benötigt wird.; Contract date: 2024-09-02; Siehe AGB's",
    "agorum_accounting_document_supplier_zip": "73760",
    "agorum_accounting_document_supplier_mail": "willi.mueller@agorum.com",
    "agorum_accounting_document_supplier_state": "Baden-Württemberg",
    "agorum_accounting_document_buyer_reference_number": "987-654-988",
    "agorum_accounting_document_delivery_state": "Bayern",
    "agorum_accounting_document_tender_reference": "989864757",
    "agorum_accounting_document_customer_name": "Musterfirma GmbH",
    "agorum_accounting_document_customer_vat_id": "DE279075026",
    "agorum_accounting_document_delivery_city": "Lieferhausen"
  }

Nach der erfolgreichen Erstellung und Validierung der XML-Struktur, wird die ZUGFeRD-PDF-Datei für die weitere Verwendung gespeichert.

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
Format	Mit diesem Parameter geben Sie das Format für die zu generierende Rechnung an. Die Angabe ist erforderlich.	zugferd_cii
Eingangsvariable	Über die Eingangsvariable geben Sie ein oder mehrere Dokumente an, die für die Erstellung der E-Rechnung verwendet werden sollen. Wie die Dokumtente verwendet werden, ist abhängig vom Format der E-Rechnung: ZUGFeRD: Ist das Zielformat ZUGFeRD, müssen Sie ein PDF-Dokument angeben, in das die eigentliche XRechnung (XML) als Anhang integriert wird. XML-Rechnungsformat (CII oder UBL): Die angegebenen Dokumente werden als Anhang in die XML-Struktur eingebettet. Dafür werden die Dokumente base64-codiert. Für die Erstellung reiner XRechnungen (nur die XML-Rechnung) ist die Angabe eines Anhangs nicht erforderlich. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen	attachmentDocuments
Datenvariable	Mit der Datenvariable geben Sie an, in welchem Abschnitt im Token die normalisierten Daten für die Erstellung der E-Rechnung enthalten sind. Hierfür geben Sie den Namen der entsprechenden Workflow-Variablen an. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	invoiceData Für ein Beispiel der normalisierten Daten siehe Beipieldaten.
Ausgangsvariable	Mit der Ausgangsvariable geben Sie an, wo das Ergebnis des Knotens gespeichert werden soll. Dabei wird ein Rechnungsdokument erzeugt, welches für weitere Knoten verwendet werden kann. Das Rechnungsdokument ist abhängig vom ausgewählten Format entweder ein PDF-Dokument mit angehängter XML-Datei (ZUGFeRD) oder eine XML-Datei (X-Rechnung) mit den entsprechenden Rechnungsdaten. Wird die Variable leer gelassen überschreibt das Ergebnis die aktuellen Attachments des Workflows (Variable sys_acw_attachments). In der Ausgangsvariable wird stets ein Array hinterlegt, auch wenn nur 1 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.	generatedInvoiceData
Rechte	Siehe Rechte auf Knoten vergeben

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