ZUGFeRD

Kurzdefinition

ZUGFeRD (Zentraler User Guide des Forums elektronische Rechnung Deutschland) ist ein hybrides Rechnungsformat. Eine ZUGFeRD-Rechnung ist eine PDF/A-3-Datei mit einem eingebetteten XML-Anhang — Mensch und Maschine lesen dasselbe Dokument.

Das XML basiert auf dem UN/CEFACT-Standard Cross Industry Invoice (CII). Das französische Pendant Factur-X ist technisch identisch zu ZUGFeRD 2.x.

Profile

ZUGFeRD definiert fünf Konformitätsstufen vom rein visuellen PDF bis zur vollständig strukturierten B2B-Rechnung:

Profil	Strukturierungsgrad	Typischer Einsatz
MINIMUM	nur Stammdaten	Buchhaltungs-Kennzahlen
BASIC WL	ohne Positionen	Steuer-/Gesamtbeträge
BASIC	inkl. Positionen	kleine Rechnungen
EN 16931 / COMFORT	EU-Norm-konform	Standard-B2B
EXTENDED	Branchen-Erweiterungen	Komplexe Rechnungen
XRECHNUNG	deutsche CIUS	B2G in Deutschland

Seit ZUGFeRD 2.1 ist das Profil XRECHNUNG Teil der Spezifikation — eine ZUGFeRD-Rechnung kann damit gleichzeitig eine gültige XRechnung sein.

Versionen im Überblick

• ZUGFeRD 1.0 (2014) — veraltet, basiert auf CII in einer älteren Fassung
• ZUGFeRD 2.0 / 2.1 (2019/2020) — EN 16931-konform, kompatibel zu Factur-X 1.0
• ZUGFeRD 2.2 / 2.3 (2022/2024) — aktuelle Versionen, erweiterte Profile

Für die deutsche E-Rechnungspflicht ab 2025 ist mindestens ZUGFeRD 2.x im Profil EN 16931 oder XRECHNUNG relevant.

ZUGFeRD mit der Dokmatiq-API erzeugen

Ein ZUGFeRD-PDF entsteht in zwei Schritten: Rechnungsdaten an die E-Invoicing-API schicken, Ergebnis ist ein PDF/A-3 mit eingebettetem CII-XML.

curl -X POST https://api.dokmatiq.com/v1/einvoice/zugferd \
  -H "Authorization: Bearer $DOKMATIQ_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "EN16931",
    "invoice": {
      "id": "2026-0042",
      "issueDate": "2026-04-17",
      "seller": { "name": "Muster GmbH", "vatId": "DE123456789" },
      "buyer": { "name": "Kunde AG", "vatId": "DE987654321" },
      "lines": [{ "description": "Beratung", "quantity": 8, "unitPrice": 120.0 }]
    }
  }'

Die Rückgabe ist ein application/pdf mit korrekt eingebetteter factur-x.xml (respektive zugferd-invoice.xml bei 1.x).

Abgrenzung: ZUGFeRD vs. XRechnung

• ZUGFeRD ist hybrid (PDF + XML), XRechnung ist eine reine XML-Datei
• ZUGFeRD ist flexibler für B2B, XRechnung ist die verpflichtende Form für B2G in Deutschland
• Eine ZUGFeRD-Rechnung im Profil XRECHNUNG erfüllt beide Welten

Häufige Stolpersteine

1. PDF/A-3 ist Pflicht — ein normales PDF mit XML-Anhang ist keine gültige ZUGFeRD-Rechnung
2. Das eingebettete XML muss den richtigen Dateinamen tragen (factur-x.xml ab 2.1)
3. Das XML muss gegen die offizielle Schematron-Regel validieren — fehlerhafte Codes, unvollständige Steuerangaben oder falsche BT-Felder führen zur Ablehnung beim Empfänger