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