Zum Inhalt

E-Rechnung erstellen (ZUGFeRD-Standard)

Der Service-Task „E-Rechnung erstellen (ZUGFeRD-Standard)“ bettet vorbereitete Rechnungsdaten als XML-Datei factur-x.xml in ein bestehendes Rechnungs-PDF ein. Das Ergebnis ist eine PDF/A-3b-Datei mit Factur-X-/ZUGFeRD-Metadaten im Profil EN 16931, die ein Empfänger sowohl lesen als auch maschinell verarbeiten kann. Die Rechnungsdaten müssen bereits in der ZUGFeRD-Struktur vorliegen; das visuelle PDF wird in einem vorherigen Schritt erzeugt.

Der Service ist der letzte Schritt einer dreiteiligen Kette: Rechnungsbeträge berechnen (calc-invoice) ermittelt die Summen, Rechnungsdaten in ZUGFeRD-Struktur umwandeln (map-invoice-to-zugferd) liefert die XML-Struktur, dieser Service bettet sie ein. Wer alles in einem Schritt möchte, nutzt Komplette E-Rechnung (Berechnung + PDF + ZUGFeRD) (complete-e-invoice).

Technischer Name prio_generateEInvoice · Kategorie im Dialog „Service-Task auswählen“: Rechnungen & E-Rechnung


Wann wird dieser Service verwendet?

  • Eigene Rechnungsvorlage behalten: Die Musterfirma GmbH erzeugt ihre Rechnung mit einer eigenen HTML-Vorlage über PDF erstellen aus Template und macht daraus im nächsten Schritt eine E-Rechnung.
  • Rechnungen an öffentliche Auftraggeber und Unternehmen: Schulungs- und Beratungsrechnungen werden als E-Rechnung verschickt, wie es seit 2025 im B2B-Bereich schrittweise verpflichtend wird.
  • Getrennte Kontrolle: Zwischen Berechnung, Abbildung und Einbettung liegt eine Benutzeraufgabe „Rechnung prüfen“, bevor die endgültige Datei entsteht.

Eingabe

Feld Typ Pflicht Bedeutung
invoiceData Objekt ja Rechnungsdaten in der ZUGFeRD-/CII-Struktur mit kleingeschriebenen Elementnamen (exchangeddocumentcontext, exchangeddocument, supplychaintradetransaction …), wie sie Rechnungsdaten in ZUGFeRD-Struktur umwandeln als app_zugferd_data liefert. Ein Präfix app_ an Schlüsseln wird entfernt. XML-Attribute werden als { "x_attributes": { "currencyID": "EUR" }, "x_value": "119.00" } angegeben; Listen werden zu wiederholten Elementen.
invoicePDFDocument Datei-Objekt ja Das visuelle Rechnungs-PDF {referenceId, filename, contentType}. Der filename wird zum Dateinamen des Ergebnisses.
{
  "invoiceData": rechnung.app_zugferd_data,
  "invoicePDFDocument": rechnung.app_invoice_pdf
}

Fehlt invoiceData, bricht der Schritt mit Invalid input parameters: invoiceData. Ensure all parameters are defined and not null. ab. Welches Profil oder welche Richtlinie (etwa urn:cen.eu:en16931:2017) im XML steht, kommt aus invoiceData; der Service ändert daran nichts.


Ausgabe

Das Ergebnis ist ein Datei-Objekt mit dem Namen des Eingabe-PDFs:

{
  "referenceId": "01JC…",
  "filename": "RE-2026-0231.pdf",
  "contentType": "application/pdf"
}

Die Datei enthält das unveränderte Erscheinungsbild der Eingabe sowie den Anhang factur-x.xml (Beziehung Alternative, Beschreibung „Factur-X Rechnung“), PDF/A-3b-Kennzeichnung und sRGB-Ausgabeabsicht. In den Dokumenteigenschaften stehen Titel Rechnung <Rechnungsnummer>, als Autor der Name des Verkäufers (sellertradeparty.name, sonst „Pantarey“), Ersteller „Pantarey E-Rechnung“. Mit einem Ergebnispfad wie e_rechnung_pdf steht die Datei den folgenden Schritten zur Verfügung.


Fehler und Verhalten

  • Der Service wirft bei ungültiger Dateireferenz, fehlendem invoiceData und wenn das PDF nicht geladen werden kann, etwa weil es verschlüsselt ist. Mit Fehler-Randereignis läuft der Vorgang dort weiter, sonst ist er fehlgeschlagen und der Prozessverantwortliche erhält die Fehler-Mail, siehe Fehler.
  • Der Inhalt des XML wird nicht gegen das ZUGFeRD-Schema geprüft. Unvollständige oder falsch benannte Daten erzeugen trotzdem eine Datei, die ein Empfänger dann ablehnt. Die Vollständigkeit wird durch die vorherigen Schritte sichergestellt.
  • Der Service ergänzt nur Ausgabeabsicht, Metadaten und Anhang. Ob das visuelle PDF selbst PDF/A-tauglich ist (eingebettete Schriften, keine Transparenz-Probleme), hängt von der Vorlage ab.
  • Keine externen Dienste; die zentrale Wiederholung greift nur bei vorübergehenden Fehlern und spielt hier praktisch keine Rolle. Zeitgrenze 900 Sekunden.
  • Im Dry Run wird der Service nicht aufgerufen; es wird eine Mock-Ausgabe aus dem Katalog verwendet.

Beispiel

Die Musterfirma GmbH stellt eine Schulungsrechnung. Der Datensatz rechnung enthält nach den vorherigen Schritten app_zugferd_data (aus Rechnungsdaten in ZUGFeRD-Struktur umwandeln) und app_invoice_pdf (aus PDF erstellen aus Template, Dateiname RE-2026-0231.pdf).

Auszug aus app_zugferd_data:

{
  "exchangeddocumentcontext": {
    "guidelinespecifieddocumentcontextparameter": { "id": "urn:cen.eu:en16931:2017" }
  },
  "exchangeddocument": {
    "id": "RE-2026-0231",
    "typecode": "380",
    "issuedatetime": {
      "datetimestring": { "x_attributes": { "format": "102" }, "x_value": "20261110" }
    }
  },
  "supplychaintradetransaction": {
    "applicableheadertradeagreement": {
      "sellertradeparty": {
        "name": "Musterfirma GmbH",
        "postaltradeaddress": {
          "postcodecode": "86150",
          "lineone": "Maximilianstraße 12",
          "cityname": "Augsburg",
          "countryid": "DE"
        }
      }
    }
  }
}

Input-Ausdruck des Schritts „E-Rechnung erzeugen“:

{
  "invoiceData": rechnung.app_zugferd_data,
  "invoicePDFDocument": rechnung.app_invoice_pdf
}

Ergebnispfad: e_rechnung_pdf

Ausgabe: { "referenceId": "01JC…", "filename": "RE-2026-0231.pdf", "contentType": "application/pdf" }. Der nächste Schritt schreibt die Datei in den Rechnungsdatensatz und versendet sie mit E-Mail senden (Microsoft Graph).


Häufige Fragen

Der Empfänger meldet, die Rechnung sei keine gültige E-Rechnung.

Der Service prüft die Daten nicht. Häufige Ursachen: Schlüssel in invoiceData nicht kleingeschrieben, Pflichtangaben fehlen, Summen stimmen nicht mit den Positionen überein. Die Summen gehören in Rechnungsbeträge berechnen, die Struktur in Rechnungsdaten in ZUGFeRD-Struktur umwandeln.

Kann der Dateiname des Ergebnisses festgelegt werden?

Nicht in diesem Service. Das Ergebnis heißt wie das Eingabe-PDF. Der Name wird daher beim Erzeugen des PDFs gesetzt, etwa über Dateiname festlegen in PDF erstellen aus Template.

Erzeugt der Service eine XRechnung?

Nein. Der Service setzt kein eigenes Profil; das Profil steht in invoiceData. Standardmäßig liefern die vorherigen Schritte das Profil EN 16931 (ZUGFeRD 2.x „EN 16931“).


Nächster Schritt

Komplette E-Rechnung (Berechnung + PDF + ZUGFeRD): Berechnung, PDF und Einbettung in einem Schritt.