typstgenv0.6.2

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.

E-Rechnungspflicht im inländischen B2B-Verkehr
E-Rechnungspflicht im inländischen B2B-VerkehrSeit 2025 müssen Unternehmen E-Rechnungen empfangen können. Papier- und andere Rechnungen sind beim Ausstellen bis Ende 2026 erlaubt, 2027 nur noch bei höchstens 800.000 Euro Vorjahresumsatz; ab 2028 ist die E-Rechnung allgemein Pflicht.01.202507.202501.202607.202601.202707.202701.2028Empfang Pflicht: 01.01.202501.01.2025Empfang PflichtPapier und andere Formate erlaubt: 01.01.2025 – 31.12.202601.01.2025 – 31.12.2026Papier und andere Formate erlaubtnur bis 800.000 € Vorjahresumsatz: 01.01.2027 – 31.12.202701.01.2027 – 31.12.2027nur bis 800.000 € VorjahresumsatzEDI-Verfahren zulässig: 01.01.2025 – 31.12.202701.01.2025 – 31.12.2027EDI-Verfahren zulässigE-Rechnung allgemein Pflicht: 01.01.202801.01.2028E-Rechnung allgemein Pflicht

Quelle: § 27 Abs. 38 UStG; BMF-Schreiben vom 15.10.2024 und 15.10.2025 (Stand 11.10.2026)

Diagrammdaten anzeigen
Daten zu E-Rechnungspflicht im inländischen B2B-Verkehr
EintragArtBeginnEndeNach
Empfang PflichtMeilenstein01.01.2025
Papier und andere Formate erlaubtPhase01.01.202531.12.2026
nur bis 800.000 € VorjahresumsatzPhase01.01.202731.12.2027Papier und andere Formate erlaubt
EDI-Verfahren zulässigPhase01.01.202531.12.2027
E-Rechnung allgemein PflichtMeilenstein01.01.2028nur bis 800.000 € Vorjahresumsatz, EDI-Verfahren zulässig
E-Rechnungspflicht im inländischen B2B-Verkehr
E-Rechnungspflicht im inländischen B2B-VerkehrSeit 2025 müssen Unternehmen E-Rechnungen empfangen können. Papier- und andere Rechnungen sind beim Ausstellen bis Ende 2026 erlaubt, 2027 nur noch bei höchstens 800.000 Euro Vorjahresumsatz; ab 2028 ist die E-Rechnung allgemein Pflicht.01.202507.202501.202607.202601.202707.202701.2028Empfang Pflicht: 01.01.202501.01.2025Empfang PflichtPapier und andere Formate erlaubt: 01.01.2025 – 31.12.202601.01.2025 – 31.12.2026Papier und andere Formate erlaubtnur bis 800.000 € Vorjahresumsatz: 01.01.2027 – 31.12.202701.01.2027 – 31.12.2027nur bis 800.000 € VorjahresumsatzEDI-Verfahren zulässig: 01.01.2025 – 31.12.202701.01.2025 – 31.12.2027EDI-Verfahren zulässigE-Rechnung allgemein Pflicht: 01.01.202801.01.2028E-Rechnung allgemein Pflicht

Quelle: § 27 Abs. 38 UStG; BMF-Schreiben vom 15.10.2024 und 15.10.2025 (Stand 11.10.2026)

Diagrammdaten anzeigen
Daten zu E-Rechnungspflicht im inländischen B2B-Verkehr
EintragArtBeginnEndeNach
Empfang PflichtMeilenstein01.01.2025
Papier und andere Formate erlaubtPhase01.01.202531.12.2026
nur bis 800.000 € VorjahresumsatzPhase01.01.202731.12.2027Papier und andere Formate erlaubt
EDI-Verfahren zulässigPhase01.01.202531.12.2027
E-Rechnung allgemein PflichtMeilenstein01.01.2028nur 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.pdf

3. 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.00

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

Erste Seite einer Rechnung mit Absender, Empfänger, Positionstabelle und Summen; oben rechts ein Platzhalter für das Logo

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.

Edit this page on GitHub · Docs for v0.6.2