Rechnungen mit ZUGFeRD
Rechnungs-JSON in ein PDF/A-3 mit eingebettetem XML verwandeln, mit dem Mustang-Validator prüfen und sehen, was bei falschen Daten passiert.
English version: Tutorial in English
Seit 2025 müssen Unternehmen E-Rechnungen empfangen können; ausstellen müssen sie sie spätestens ab 2028.
Quelle: § 27 Abs. 38 UStG; BMF-Schreiben vom 15.10.2024 und 15.10.2025 (Stand 11.10.2026)
Diagrammdaten anzeigen
| Eintrag | Art | Beginn | Ende | Nach |
|---|---|---|---|---|
| Empfang Pflicht | Meilenstein | 01.01.2025 | ||
| Papier und andere Formate erlaubt | Phase | 01.01.2025 | 31.12.2026 | |
| nur bis 800.000 € Vorjahresumsatz | Phase | 01.01.2027 | 31.12.2027 | Papier und andere Formate erlaubt |
| EDI-Verfahren zulässig | Phase | 01.01.2025 | 31.12.2027 | |
| E-Rechnung allgemein Pflicht | Meilenstein | 01.01.2028 | nur bis 800.000 € Vorjahresumsatz, EDI-Verfahren zulässig |
Quelle: § 27 Abs. 38 UStG; BMF-Schreiben vom 15.10.2024 und 15.10.2025 (Stand 11.10.2026)
Diagrammdaten anzeigen
| Eintrag | Art | Beginn | Ende | Nach |
|---|---|---|---|---|
| Empfang Pflicht | Meilenstein | 01.01.2025 | ||
| Papier und andere Formate erlaubt | Phase | 01.01.2025 | 31.12.2026 | |
| nur bis 800.000 € Vorjahresumsatz | Phase | 01.01.2027 | 31.12.2027 | Papier und andere Formate erlaubt |
| EDI-Verfahren zulässig | Phase | 01.01.2025 | 31.12.2027 | |
| E-Rechnung allgemein Pflicht | Meilenstein | 01.01.2028 | nur bis 800.000 € Vorjahresumsatz, EDI-Verfahren zulässig |
Eine ZUGFeRD-Rechnung ist ein PDF/A-3, das dieselben Angaben zusätzlich als XML trägt (UN/CEFACT CII, Profil EN 16931). Umsatzsteuerlich ist das XML der führende Teil.
typstgen erzeugt das XML aus denselben JSON-Daten, aus denen die Rechnungsvorlage das PDF setzt. Vorher rechnet es Positionen, Steuer je Kategorie und Summen nach; weichen die Zahlen im JSON ab, bricht der Build ab, sonst zeigte das PDF etwas anderes als das XML. Abgedeckt sind Normal- und ermäßigter Satz, 0 %, steuerbefreit mit Begründung und Reverse Charge.
Keine Rechtsberatung
Fristen nach Stand 11.10.2026: § 27 Abs. 38 UStG, BMF-Schreiben vom 15.10.2024 und 15.10.2025. Prüfen Sie den aktuellen Stand oder fragen Sie Ihre Steuerberatung.
Eine Rechnung als ZUGFeRD erzeugen und prüfen
1. Dokument. Zwei Zeilen: Vorlage laden, Daten übergeben. Das Paket liegt im Repository
typst-business-templates unter packages/local/business-templates/0.1.0, package_path in
typstgen.toml zeigt darauf.
#import "@local/business-templates:0.1.0": invoice
#invoice(data: json("/rechnung.json"), company: json("/company.json"))2. Übersetzen. --zugferd und --company erzeugen das XML aus denselben Daten und betten es
als factur-x.xml ein.
$ typstgen compile rechnung.typ --pdf-standard a-3b \
--creation-timestamp 1737500000 \
--zugferd rechnung.json --company company.json
rechnung.pdf3. Prüfen. Mustang prüft das PDF/A-3 und das XML gegen EN 16931.
$ java -jar Mustang-CLI-2.26.0.jar --action validate --source rechnung.pdf
… Parsed PDF:valid XML:valid … Profile:urn:cen.eu:en16931:2017 Version:2 … Errors:[]4. Wenn die Daten nicht stimmen. Alle Probleme auf einmal, jeweils mit dem Feld, das sie behebt:
error: ZUGFeRD invoice:
recipient.address.country: unknown country, set recipient.address.country_code (ISO 3166-1, e.g. "DE")
items[0]: unit "Kisten" has no UN/ECE code, set items[0].unit_code (e.g. "C62")
items[1]: total 1.00 does not match quantity × unit price = 11200.00Das Ergebnis ist ein gültiges ZUGFeRD-PDF im Profil EN 16931; veraPDF meldet PDF/A-3b-konform. Geprüft wurden außerdem gemischte Steuersätze, Reverse Charge und eine steuerbefreite Rechnung.

Rechnung aus dem Beispiel „it-consultant“; die Beispielfirma hat kein Logo.
Vor dem Versand prüfen
Prüfen Sie Rechnungen vor dem Versand mit einem Validator wie Mustang. Nachschlagen (englisch): E-invoices; dort steht auch XRechnung für öffentliche Auftraggeber.
Weiter: Archivieren, prüfen und signieren.