E-Rechnungspflicht 2027: ZUGFeRD aus JSON erzeugen

Ab 1. Januar 2027 müssen Unternehmen mit mehr als 800.000 € Vorjahresumsatz Rechnungen an andere inländische Unternehmen als E-Rechnung ausstellen, ab 2028 alle, von wenigen Ausnahmen abgesehen. ZUGFeRD erfüllt das: ein gewöhnliches PDF, das die Rechnungsdaten zusätzlich als XML enthält. Dieser Leitfaden nennt die Fristen aus dem Gesetz und den Schreiben des Bundesfinanzministeriums (BMF) und zeigt, wie Sie mit einer einzigen Anfrage aus JSON eine gültige ZUGFeRD-Rechnung erzeugen.

Die Fristen

Ausgenommen sind Kleinbetragsrechnungen bis 250 €, Fahrausweise, Rechnungen von Kleinunternehmern nach § 19 UStG und Umsätze, die nach § 4 Nr. 8 bis 29 UStG steuerfrei sind. Rechnungen an Privatkunden sind nicht betroffen, und EDI ist mit Zustimmung des Empfängers bis Ende 2027 weiter möglich.

Das jüngste BMF-Schreiben vom 15. Oktober 2026 ergänzt Einzelheiten, lässt die Fristen aber unverändert. Verbände haben eine Verschiebung gefordert; am 7. November 2026 hat sich an der Rechtslage nichts geändert.

Was als E-Rechnung zählt

• Das Format muss der europäischen Norm EN 16931 entsprechen. Das gilt für XRechnung und für ZUGFeRD ab Version 2.0.1, ausgenommen die Profile MINIMUM und BASIC-WL (BMF-Schreiben vom 15. Oktober 2024, Rn. 25 und 30).
• Ein reines PDF ist keine E-Rechnung, egal wie es erzeugt wurde. Alle Pflichtangaben müssen im XML-Teil stehen.
• Eine Datei, die an der Schemaprüfung scheitert, gilt als sonstige Rechnung, nicht als E-Rechnung. Prüfen Sie also, was Sie versenden.
• Der Versand per E-Mail ist zulässig. Ein bestimmtes Netz oder eine Plattform ist nicht vorgeschrieben; den Weg vereinbaren Sie mit Ihrem Kunden.

ZUGFeRD aus JSON erzeugen

Sie senden die Rechnung als Daten: Verkäufer, Käufer, Positionen mit Menge, Nettopreis und Steuersatz. Wir berechnen die Positionen, die Steueraufschlüsselung und die Summen und liefern eine PDF/A-3-Datei mit dem EN-16931-XML darin (Factur-X 1.0, derselbe Standard wie ZUGFeRD 2.x).

curl https://api.pagenull.dev/v1/invoices \
  -H "Authorization: Bearer $PAGENULL_API_KEY" \
  -H "Content-Type: application/json" \
  -o INV-2026-0142.pdf \
  -d '{
  "invoice": {
    "number": "INV-2026-0142",
    "issueDate": "2026-11-03",
    "dueDate": "2026-11-17",
    "buyerReference": "PO-7781",
    "seller": {
      "name": "Northwind Studio EOOD",
      "address": {
        "line1": "12 Example Street",
        "city": "Sofia",
        "postcode": "1000",
        "country": "BG"
      },
      "vatId": "BG123456789"
    },
    "buyer": {
      "name": "Acme Robotics EOOD",
      "address": {
        "line1": "1 Vitosha Blvd",
        "city": "Sofia",
        "postcode": "1000",
        "country": "BG"
      }
    },
    "lines": [
      {
        "description": "API integration, October",
        "quantity": 12,
        "unit": "HUR",
        "unitPrice": "85.00",
        "vatRate": 20
      },
      {
        "description": "PDF template design",
        "quantity": 1,
        "unitPrice": "340.00",
        "vatRate": 20
      }
    ],
    "payment": {
      "iban": "BG80BNBG96611020345678"
    }
  }
}'

Bleiben Sie beim Standardprofil EN16931. BASIC gehört ebenfalls nicht zu den Profilen, die das BMF ausschließt. Verwenden Sie für deutsche Rechnungen nicht MINIMUM: Das BMF schließt es aus. Alle Felder stehen im Factur-X- und ZUGFeRD-Leitfaden (auf Englisch).

Mit "language": "de-DE" erscheinen Zahlen und Datumsangaben im deutschen Format. Für deutsche Beschriftungen speichern Sie Ihre eigene Vorlage.

Die Datei prüfen

Mustang, der kostenlose Open-Source-Validator aus der ZUGFeRD-Community, prüft den PDF/A-Teil und das XML gegen die offiziellen Regeln. Wir veröffentlichen einen Prüflauf mit dem unveränderten Bericht, damit Sie dieselbe Prüfung an Ihrer eigenen Datei durchführen können:

java -jar Mustang-CLI-2.26.0.jar --action validate --source RE-2027-0001.pdf

Öffentliche Auftraggeber

Viele Behörden verlangen XRechnung und eine Leitweg-ID, eingereicht über ihr eigenes Portal. Die Leitweg-ID tragen wir in buyerReference ein, XRechnung-Dateien erzeugen wir aber nicht. Fragen Sie die Behörde, welche Formate sie annimmt.

Länder, in denen unsere Datei nicht reicht

In Deutschland darf eine Factur-X/ZUGFeRD-Datei per E-Mail verschickt werden. Viele andere Länder schreiben ein bestimmtes Netz oder ein staatliches System vor, und wir sind an keines davon angebunden. Wer dort an Unternehmen fakturiert, braucht dafür einen passenden Anbieter.

XRechnung und UBL, die reinen XML-Formate, erzeugen wir ebenfalls nicht, und wir versenden, empfangen oder archivieren keine Rechnungen. Peppol-Zugang, staatliche Plattformen und die Aufbewahrung sind eigene Dienste.

Ihre Kopie aufbewahren

Wir speichern nichts: weder die Daten noch das XML oder das PDF. Rechnungen müssen Sie jahrelang aufbewahren. Archivieren Sie also die Datei, die wir Ihnen zurückgeben, oder lassen Sie sie mit deliverTo direkt in Ihren eigenen Speicher hochladen.