ZeRechnung
Sprache: Deutsch
Diese Übersetzung wurde noch nicht von Muttersprachlern geprüft. Korrektur vorschlagen

Beispiele

Beispiele, Schritt für Schritt

Jedes Beispiel ist ein vollständiges Go-Programm, das unverändert läuft. Es erstellt eine echte E-Rechnung, prüft sie anhand der Regeln des Landes und liest sie anschließend wieder ein. Die Tests des Repositorys führen jedes Programm aus und prüfen, dass es genau das ausgibt, was diese Seite zeigt.

Beispiel 1

Eine Münchner Bäckerei beliefert ein Wirtshaus

ZUGFeRDEN 16931LeistungszeitraumUSt 7 % und 19 %

Die Backstube Brandl in Giesing liefert jeden Morgen frische Brezn, Kaisersemmeln, Bauernbrot und Auszogne an das Gasthaus Zur Isarlust. Am Monatsende stellt sie eine Sammelrechnung über alle Lieferungen des Monats. Ihr Warenwirtschaftssystem erzeugt die Rechnung schon als PDF; ZeRechnung bettet das XML ein und macht daraus eine ZUGFeRD-Rechnung, die das Gasthaus seit 2025 als E-Rechnung empfangen muss.

Backwaren tragen den ermäßigten Steuersatz von 7 %, die zwei Brezenständer aus Edelstahl, die das Gasthaus dazugekauft hat, den Regelsteuersatz von 19 %.

  1. Das PDF der Rechnung lesen

    Ausgangspunkt ist das PDF, das die Software ohnehin erzeugt, am besten ein PDF/A-3. ZeRechnung ändert seine Bytes nicht: Es hängt das XML mit einer inkrementellen Aktualisierung an.

    Go
    pdf, err := os.ReadFile("rechnung.pdf")
    if err != nil {
    	log.Fatal(err)
    }
  2. Verkäufer und Käufer beschreiben

    Nach § 14 UStG nennt die Rechnung Namen und Anschrift beider Parteien und die Steuernummer oder die Umsatzsteuer-Identifikationsnummer des Verkäufers. Die Backstube gibt beide an: die Steuernummer des Finanzamts München (BT-32) und die USt-IdNr (BT-31).

    Go
    backstube := invoice.Party{
    	Name:              "Backstube Brandl GmbH",
    	VATID:             "DE812746359",
    	TaxRegistrationID: "143/158/40273",
    	Address: invoice.Address{
    		Line1:       "Tegernseer Landstraße 61",
    		PostCode:    "81541",
    		City:        "München",
    		CountryCode: "DE",
    	},
    }
    isarlust := invoice.Party{
    	Name:  "Gasthaus Zur Isarlust GmbH",
    	VATID: "DE293618476",
    	Address: invoice.Address{
    		Line1: "Ohlmüllerstraße 12", PostCode: "81541", City: "München", CountryCode: "DE",
    	},
    }
  3. Leistungszeitraum und Pflichtangaben

    Eine Sammelrechnung gibt statt eines Lieferdatums den Leistungszeitraum an (BG-14): hier den ganzen Oktober. Die Angaben zum Handelsregister stehen in einer Notiz mit dem Code REG, die Zahlungsbedingungen in BT-20.

    Go
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:        invoice.ProfileEN16931,
    	Number:         "RE-2026-1031",
    	TypeCode:       invoice.TypeCommercialInvoice,
    	IssueDate:      invoice.NewDate(2026, time.November, 2),
    	Currency:       "EUR",
    	BuyerReference: "KÜCHE",
    	Seller:         backstube,
    	Buyer:          isarlust,
    	InvoicingPeriod: invoice.Period{
    		Start: invoice.NewDate(2026, time.October, 1),
    		End:   invoice.NewDate(2026, time.October, 31),
    	},
    	Notes: []invoice.Note{
    		{SubjectCode: "REG", Content: "Amtsgericht München, HRB 214587. Geschäftsführerin: Theresa Brandl."},
    	},
    	PaymentMeans: []invoice.PaymentMeans{{
    		TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "DE89370400440532013000",
    	}},
    	PaymentTerms: []invoice.PaymentTerms{{
    		Description: "Zahlbar innerhalb von 14 Tagen ohne Abzug.",
    		DueDate:     invoice.NewDate(2026, time.November, 16),
    	}},
    }
  4. Die Positionen erfassen

    Jede Position hat eine Menge, eine Einheit (UN/ECE-Code: H87 für Stück), einen Nettopreis und ihren Steuersatz. Die Backwaren eines Monats stehen in einer Position je Sorte.

    Go
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{Name: "Laugenbrezn, frisch gebacken"},
    	Quantity: d("1200"), UnitCode: "H87", NetPrice: d("0.62"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Kaisersemmeln"},
    	Quantity: d("800"), UnitCode: "H87", NetPrice: d("0.48"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "3", Item: invoice.Item{Name: "Bauernbrot, Roggenmischbrot 2 kg"},
    	Quantity: d("60"), UnitCode: "H87", NetPrice: d("5.90"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "4", Item: invoice.Item{Name: "Auszogne (Schmalznudeln)"},
    	Quantity: d("150"), UnitCode: "H87", NetPrice: d("1.80"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "5", Item: invoice.Item{Name: "Brezenständer aus Edelstahl, 12 Haken"},
    	Quantity: d("2"), UnitCode: "H87", NetPrice: d("89.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
    }}
  5. Die ZUGFeRD-Rechnung erzeugen

    Calculate berechnet Positionsbeträge, Summen und die Aufschlüsselung nach Steuersätzen, mit exakten Dezimalzahlen. Auto ergänzt für einen Verkäufer in Deutschland die Prüfung, ob das Profil eine E-Rechnung im Sinne des BMF ist. Eine ungültige Rechnung wird abgelehnt: Create gibt dann die Befunde zurück und schreibt nichts.

    Go
    out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
    	Calculate: true,
    	Validate:  &validate.Options{Auto: true},
    })
    if err != nil {
    	log.Fatal(err)
    }
    if err := os.WriteFile("RE-2026-1031.pdf", out, 0o644); err != nil {
    	log.Fatal(err)
    }
  6. Das Ergebnis lesen und prüfen

    Das erzeugte PDF lässt sich wie jede empfangene Rechnung lesen. Check prüft den PDF-Container, die XMP-Metadaten und das XML mit denselben Regeln.

    Go
    back, att, err := zerechnung.Read(out)
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel, "·", att.Relationship)
    fmt.Println("Leistungszeitraum:", back.InvoicingPeriod.Start, "bis", back.InvoicingPeriod.End)
    for _, vat := range back.VATBreakdown {
    	fmt.Printf("USt %s %% auf %s €: %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
    }
    fmt.Println("Netto:", back.Totals.TaxBasisTotal, "€ · Brutto:", back.Totals.GrandTotal, "€")
    
    report, _, err := zerechnung.Check(out, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println("Fehler:", len(report.Errors()))

Was das Programm ausgibt

go run .
factur-x.xml · EN 16931 · Alternative
Leistungszeitraum: 2026-10-01 bis 2026-10-31
USt 7 % auf 1752.00 €: 122.64 €
USt 19 % auf 178.00 €: 33.82 €
Netto: 1930.00 € · Brutto: 2086.46 €
Fehler: 0
Das vollständige Programm
main.go
package main

import (
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Das PDF der Rechnung lesen
	pdf, err := os.ReadFile("rechnung.pdf")
	if err != nil {
		log.Fatal(err)
	}

	// Verkäufer und Käufer beschreiben
	backstube := invoice.Party{
		Name:              "Backstube Brandl GmbH",
		VATID:             "DE812746359",
		TaxRegistrationID: "143/158/40273",
		Address: invoice.Address{
			Line1:       "Tegernseer Landstraße 61",
			PostCode:    "81541",
			City:        "München",
			CountryCode: "DE",
		},
	}
	isarlust := invoice.Party{
		Name:  "Gasthaus Zur Isarlust GmbH",
		VATID: "DE293618476",
		Address: invoice.Address{
			Line1: "Ohlmüllerstraße 12", PostCode: "81541", City: "München", CountryCode: "DE",
		},
	}

	// Leistungszeitraum und Pflichtangaben
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:        invoice.ProfileEN16931,
		Number:         "RE-2026-1031",
		TypeCode:       invoice.TypeCommercialInvoice,
		IssueDate:      invoice.NewDate(2026, time.November, 2),
		Currency:       "EUR",
		BuyerReference: "KÜCHE",
		Seller:         backstube,
		Buyer:          isarlust,
		InvoicingPeriod: invoice.Period{
			Start: invoice.NewDate(2026, time.October, 1),
			End:   invoice.NewDate(2026, time.October, 31),
		},
		Notes: []invoice.Note{
			{SubjectCode: "REG", Content: "Amtsgericht München, HRB 214587. Geschäftsführerin: Theresa Brandl."},
		},
		PaymentMeans: []invoice.PaymentMeans{{
			TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "DE89370400440532013000",
		}},
		PaymentTerms: []invoice.PaymentTerms{{
			Description: "Zahlbar innerhalb von 14 Tagen ohne Abzug.",
			DueDate:     invoice.NewDate(2026, time.November, 16),
		}},
	}

	// Die Positionen erfassen
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{Name: "Laugenbrezn, frisch gebacken"},
		Quantity: d("1200"), UnitCode: "H87", NetPrice: d("0.62"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Kaisersemmeln"},
		Quantity: d("800"), UnitCode: "H87", NetPrice: d("0.48"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "3", Item: invoice.Item{Name: "Bauernbrot, Roggenmischbrot 2 kg"},
		Quantity: d("60"), UnitCode: "H87", NetPrice: d("5.90"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "4", Item: invoice.Item{Name: "Auszogne (Schmalznudeln)"},
		Quantity: d("150"), UnitCode: "H87", NetPrice: d("1.80"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "5", Item: invoice.Item{Name: "Brezenständer aus Edelstahl, 12 Haken"},
		Quantity: d("2"), UnitCode: "H87", NetPrice: d("89.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
	}}

	// Die ZUGFeRD-Rechnung erzeugen
	out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
		Calculate: true,
		Validate:  &validate.Options{Auto: true},
	})
	if err != nil {
		log.Fatal(err)
	}
	if err := os.WriteFile("RE-2026-1031.pdf", out, 0o644); err != nil {
		log.Fatal(err)
	}

	// Das Ergebnis lesen und prüfen
	back, att, err := zerechnung.Read(out)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(att.Filename, "·", att.Metadata.ConformanceLevel, "·", att.Relationship)
	fmt.Println("Leistungszeitraum:", back.InvoicingPeriod.Start, "bis", back.InvoicingPeriod.End)
	for _, vat := range back.VATBreakdown {
		fmt.Printf("USt %s %% auf %s €: %s €\n", vat.Rate, vat.TaxableAmount, vat.TaxAmount)
	}
	fmt.Println("Netto:", back.Totals.TaxBasisTotal, "€ · Brutto:", back.Totals.GrandTotal, "€")

	report, _, err := zerechnung.Check(out, &validate.Options{Auto: true})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("Fehler:", len(report.Errors()))
}

So führen Sie es in einem Klon des Repositorys aus:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/de-1-baeckerei
go run .

Dieses Beispiel auf GitHub

Beispiel 2

Eine Schwarzwälder Schreinerei stellt einer Gemeinde eine XRechnung

XRechnungCIILeitweg-IDSkontoUSt 19 %

Die Schreinerei Wälder in Triberg hat für die Gemeinde Tannweiler eine handgeschnitzte Kuckucksuhr für das Foyer des Rathauses gebaut und sechs Sitzbänke aus Weißtanne für den Kurpark geliefert und aufgestellt. Öffentliche Auftraggeber in Deutschland nehmen Rechnungen nur noch als XRechnung an: eine reine XML-Datei, ohne PDF, adressiert über die Leitweg-ID der Behörde.

Die Schreinerei gewährt 2 % Skonto bei Zahlung innerhalb von zehn Tagen. XRechnung schreibt dafür eine maschinenlesbare Zeile in den Zahlungsbedingungen vor, die ZeRechnung prüft.

  1. Den Verkäufer mit Ansprechpartner beschreiben

    XRechnung verlangt mehr als die EN 16931: einen Ansprechpartner mit Telefonnummer und E-Mail-Adresse (BR-DE-2 bis BR-DE-7) und eine elektronische Adresse (BT-34), hier eine E-Mail-Adresse (Schema EM).

    Go
    schreinerei := invoice.Party{
    	Name:              "Schreinerei Wälder GmbH",
    	VATID:             "DE147258365",
    	LegalRegistration: invoice.Identifier{ID: "HRB 708124"},
    	Address: invoice.Address{
    		Line1:       "Hauptstraße 27",
    		PostCode:    "78098",
    		City:        "Triberg im Schwarzwald",
    		CountryCode: "DE",
    	},
    	Contact: &invoice.Contact{
    		PersonName: "Lena Wälder",
    		Phone:      "+49 7722 91 84 0",
    		Email:      "lena.waelder@schreinerei-waelder.example",
    	},
    	ElectronicAddress: invoice.Identifier{
    		ID: "rechnung@schreinerei-waelder.example", Scheme: invoice.SchemeEmail,
    	},
    }
  2. Den öffentlichen Auftraggeber über die Leitweg-ID adressieren

    Die Leitweg-ID kennzeichnet die rechnungsempfangende Stelle. Sie steht in der Käuferreferenz (BT-10, Pflicht nach BR-DE-15) und als elektronische Adresse mit dem Schema 0204. Ihre zwei Prüfziffern (ISO 7064 MOD 97-10) prüft ZeRechnung mit.

    Go
    leitwegID := "08315123-RATHAUS-91"
    gemeinde := invoice.Party{
    	Name: "Gemeinde Tannweiler, Hauptamt",
    	Address: invoice.Address{
    		Line1: "Rathausplatz 1", PostCode: "79874", City: "Tannweiler", CountryCode: "DE",
    	},
    	ElectronicAddress: invoice.Identifier{ID: leitwegID, Scheme: invoice.SchemeLeitwegID},
    }
  3. Rechnungskopf und Positionen

    Die Rechnung nennt die Bestellung der Gemeinde (BT-13), das Datum der Aufstellung und drei Positionen: die Uhr, die Bänke und die Montage nach Stunden (UN/ECE-Code HUR). Alle tragen den Regelsteuersatz.

    Go
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:                invoice.ProfileXRechnung,
    	Number:                 "2026-0417",
    	TypeCode:               invoice.TypeCommercialInvoice,
    	IssueDate:              invoice.NewDate(2026, time.November, 20),
    	Currency:               "EUR",
    	BuyerReference:         leitwegID,
    	PurchaseOrderReference: "HA-2026-118",
    	Seller:                 schreinerei,
    	Buyer:                  gemeinde,
    	DeliveryDate:           invoice.NewDate(2026, time.November, 13),
    	PaymentMeans: []invoice.PaymentMeans{{
    		TypeCode:         invoice.PaymentSEPACreditTransfer,
    		PayeeIBAN:        "DE02120300000000202051",
    		PayeeAccountName: "Schreinerei Wälder GmbH",
    	}},
    }
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{
    		Name:        "Kuckucksuhr, handgeschnitzt, Achttagewerk",
    		Description: "Lindenholz, Höhe 85 cm, mit Musikwerk",
    	},
    	Quantity: d("1"), UnitCode: "H87", NetPrice: d("1890.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Sitzbank aus Weißtanne, 1,80 m, wetterfest geölt"},
    	Quantity: d("6"), UnitCode: "H87", NetPrice: d("640.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
    }, {
    	ID: "3", Item: invoice.Item{Name: "Montage im Kurpark und im Rathaus"},
    	Quantity: d("12"), UnitCode: "HUR", NetPrice: d("58.00"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
    }}
  4. Skonto in den Zahlungsbedingungen angeben

    Das Skonto steht als eigene Zeile in BT-20, in der Form #SKONTO#TAGE=10#PROZENT=2.00#, gefolgt von einem Zeilenumbruch (BR-DE-18). Ein Buchhaltungssystem kann es so automatisch abziehen.

    Go
    inv.PaymentTerms = []invoice.PaymentTerms{{
    	Description: "Zahlbar innerhalb von 30 Tagen netto.\n#SKONTO#TAGE=10#PROZENT=2.00#\n",
    	DueDate:     invoice.NewDate(2026, time.December, 20),
    }}
  5. Die XRechnung schreiben

    Calculate berechnet die Beträge. cii.Marshal schreibt die Rechnung in der CII-Syntax mit der Spezifikationskennung von XRechnung 3.0 (BT-24); die Behörde nimmt sie über ihr Rechnungseingangsportal an.

    Go
    inv.Calculate()
    xml, err := cii.Marshal(inv, &cii.MarshalOptions{Indent: true})
    if err != nil {
    	log.Fatal(err)
    }
    if err := os.WriteFile("xrechnung.xml", xml, 0o644); err != nil {
    	log.Fatal(err)
    }
  6. Mit den Regeln von XRechnung prüfen

    Eine XRechnung erkennt ZeRechnung an ihrer Spezifikationskennung: Die Regeln BR-DE und die Prüfung der Leitweg-ID kommen von selbst zu Schema, EN 16931 und Profilregeln hinzu, ohne Option.

    Go
    report := validate.XML(xml, nil)
    if !report.Valid() {
    	for _, f := range report.Errors() {
    		fmt.Println(f)
    	}
    	os.Exit(1)
    }
    fmt.Println("Leitweg-ID:", inv.BuyerReference)
    t := inv.Totals
    fmt.Println("Netto:", t.TaxBasisTotal, "€ · USt:", t.TaxTotal, "€ · Brutto:", t.GrandTotal, "€")
    skonto := t.DuePayable.Mul(d("0.02")).Round(2)
    fmt.Println("Bei Zahlung bis", inv.IssueDate.AddDays(10), "zu zahlen:", t.DuePayable.Sub(skonto), "€")
    fmt.Println("Befunde:", len(report.Findings))

Was das Programm ausgibt

go run .
Leitweg-ID: 08315123-RATHAUS-91
Netto: 6426.00 € · USt: 1220.94 € · Brutto: 7646.94 €
Bei Zahlung bis 2026-11-30 zu zahlen: 7494.00 €
Befunde: 0
Das vollständige Programm
main.go
package main

import (
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung/cii"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Den Verkäufer mit Ansprechpartner beschreiben
	schreinerei := invoice.Party{
		Name:              "Schreinerei Wälder GmbH",
		VATID:             "DE147258365",
		LegalRegistration: invoice.Identifier{ID: "HRB 708124"},
		Address: invoice.Address{
			Line1:       "Hauptstraße 27",
			PostCode:    "78098",
			City:        "Triberg im Schwarzwald",
			CountryCode: "DE",
		},
		Contact: &invoice.Contact{
			PersonName: "Lena Wälder",
			Phone:      "+49 7722 91 84 0",
			Email:      "lena.waelder@schreinerei-waelder.example",
		},
		ElectronicAddress: invoice.Identifier{
			ID: "rechnung@schreinerei-waelder.example", Scheme: invoice.SchemeEmail,
		},
	}

	// Den öffentlichen Auftraggeber über die Leitweg-ID adressieren
	leitwegID := "08315123-RATHAUS-91"
	gemeinde := invoice.Party{
		Name: "Gemeinde Tannweiler, Hauptamt",
		Address: invoice.Address{
			Line1: "Rathausplatz 1", PostCode: "79874", City: "Tannweiler", CountryCode: "DE",
		},
		ElectronicAddress: invoice.Identifier{ID: leitwegID, Scheme: invoice.SchemeLeitwegID},
	}

	// Rechnungskopf und Positionen
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:                invoice.ProfileXRechnung,
		Number:                 "2026-0417",
		TypeCode:               invoice.TypeCommercialInvoice,
		IssueDate:              invoice.NewDate(2026, time.November, 20),
		Currency:               "EUR",
		BuyerReference:         leitwegID,
		PurchaseOrderReference: "HA-2026-118",
		Seller:                 schreinerei,
		Buyer:                  gemeinde,
		DeliveryDate:           invoice.NewDate(2026, time.November, 13),
		PaymentMeans: []invoice.PaymentMeans{{
			TypeCode:         invoice.PaymentSEPACreditTransfer,
			PayeeIBAN:        "DE02120300000000202051",
			PayeeAccountName: "Schreinerei Wälder GmbH",
		}},
	}
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{
			Name:        "Kuckucksuhr, handgeschnitzt, Achttagewerk",
			Description: "Lindenholz, Höhe 85 cm, mit Musikwerk",
		},
		Quantity: d("1"), UnitCode: "H87", NetPrice: d("1890.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Sitzbank aus Weißtanne, 1,80 m, wetterfest geölt"},
		Quantity: d("6"), UnitCode: "H87", NetPrice: d("640.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
	}, {
		ID: "3", Item: invoice.Item{Name: "Montage im Kurpark und im Rathaus"},
		Quantity: d("12"), UnitCode: "HUR", NetPrice: d("58.00"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
	}}

	// Skonto in den Zahlungsbedingungen angeben
	inv.PaymentTerms = []invoice.PaymentTerms{{
		Description: "Zahlbar innerhalb von 30 Tagen netto.\n#SKONTO#TAGE=10#PROZENT=2.00#\n",
		DueDate:     invoice.NewDate(2026, time.December, 20),
	}}

	// Die XRechnung schreiben
	inv.Calculate()
	xml, err := cii.Marshal(inv, &cii.MarshalOptions{Indent: true})
	if err != nil {
		log.Fatal(err)
	}
	if err := os.WriteFile("xrechnung.xml", xml, 0o644); err != nil {
		log.Fatal(err)
	}

	// Mit den Regeln von XRechnung prüfen
	report := validate.XML(xml, nil)
	if !report.Valid() {
		for _, f := range report.Errors() {
			fmt.Println(f)
		}
		os.Exit(1)
	}
	fmt.Println("Leitweg-ID:", inv.BuyerReference)
	t := inv.Totals
	fmt.Println("Netto:", t.TaxBasisTotal, "€ · USt:", t.TaxTotal, "€ · Brutto:", t.GrandTotal, "€")
	skonto := t.DuePayable.Mul(d("0.02")).Round(2)
	fmt.Println("Bei Zahlung bis", inv.IssueDate.AddDays(10), "zu zahlen:", t.DuePayable.Sub(skonto), "€")
	fmt.Println("Befunde:", len(report.Findings))
}

So führen Sie es in einem Klon des Repositorys aus:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/de-2-schreinerei
go run .

Dieses Beispiel auf GitHub

Beispiel 3

Ein Stand am Christkindlesmarkt prüft seine Eingangsrechnung

ZUGFeRDEmpfangPrüfungBMF-ProfileUSt 7 % und 19 %

Monika Hollerbach verkauft am Nürnberger Christkindlesmarkt Lebkuchen, Zwetschgenmännla und Geschenkdosen. Ihre Ware bezieht sie von der Lebküchnerei Merkl in der Altstadt. Seit 2025 muss jedes Unternehmen in Deutschland E-Rechnungen empfangen können, auch ein Marktstand: Die Rechnung kommt als ZUGFeRD-PDF, und die Buchhaltung liest die Daten aus dem eingebetteten XML statt vom Papier.

Dieses Beispiel spielt beide Seiten durch: Die Lebküchnerei erzeugt die Rechnung, der Stand liest und prüft sie. Am Ende zeigt es, was die Prüfung bei einem Profil meldet, das keine E-Rechnung im Sinne des BMF ist.

  1. Die Lebküchnerei beschreibt die Rechnung

    Die Lieferung ging am 24. November an den Stand, rechtzeitig zur Eröffnung des Markts. Verkäufer und Käufer nennen Anschrift und USt-IdNr; die Bankverbindung steht in den Zahlungsanweisungen (BG-16).

    Go
    pdf, err := os.ReadFile("rechnung.pdf")
    if err != nil {
    	log.Fatal(err)
    }
    d := invoice.MustDecimal
    inv := &invoice.Invoice{
    	Profile:   invoice.ProfileEN16931,
    	Number:    "LM-26-0907",
    	TypeCode:  invoice.TypeCommercialInvoice,
    	IssueDate: invoice.NewDate(2026, time.November, 25),
    	Currency:  "EUR",
    	Seller: invoice.Party{
    		Name:  "Lebküchnerei Merkl e. K.",
    		VATID: "DE369147258",
    		Address: invoice.Address{
    			Line1: "Bergstraße 9", PostCode: "90403", City: "Nürnberg", CountryCode: "DE",
    		},
    	},
    	Buyer: invoice.Party{
    		Name:  "Monika Hollerbach, Lebkuchen und Geschenke",
    		VATID: "DE528471633",
    		Address: invoice.Address{
    			Line1:       "Glockengießergasse 4",
    			PostCode:    "90403",
    			City:        "Nürnberg",
    			CountryCode: "DE",
    		},
    	},
    	DeliveryDate: invoice.NewDate(2026, time.November, 24),
    	PaymentMeans: []invoice.PaymentMeans{{
    		TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "DE75512108001245126199",
    	}},
    	PaymentTerms: []invoice.PaymentTerms{{
    		Description: "Zahlbar bis 9. Dezember 2026 ohne Abzug.",
    		DueDate:     invoice.NewDate(2026, time.December, 9),
    	}},
    }
  2. Lebkuchen zu 7 %, Blechdosen zu 19 %

    Lebkuchen und Zwetschgenmännla sind Lebensmittel und tragen 7 % Umsatzsteuer. Die bedruckten Blechdosen verkauft die Lebküchnerei einzeln: Sie sind keine Verpackung der Lebkuchen und tragen 19 %.

    Go
    inv.Lines = []invoice.Line{{
    	ID: "1", Item: invoice.Item{Name: "Elisenlebkuchen, Karton mit 50 Stück"},
    	Quantity: d("12"), UnitCode: "H87", NetPrice: d("42.50"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "2", Item: invoice.Item{Name: "Lebkuchenherz „Frohe Weihnachten“, 18 cm"},
    	Quantity: d("300"), UnitCode: "H87", NetPrice: d("2.40"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "3", Item: invoice.Item{Name: "Nürnberger Zwetschgenmännla"},
    	Quantity: d("80"), UnitCode: "H87", NetPrice: d("6.50"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
    }, {
    	ID: "4", Item: invoice.Item{Name: "Geschenkdose aus Blech, Motiv Altstadt"},
    	Quantity: d("200"), UnitCode: "H87", NetPrice: d("3.20"),
    	VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
    }}
  3. Das ZUGFeRD-PDF erzeugen

    Wie in jedem Beispiel berechnet Create die Beträge, prüft die Rechnung und bettet das XML in das PDF ein. Dieses PDF schickt die Lebküchnerei per E-Mail an den Stand.

    Go
    received, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
    	Calculate: true,
    	Validate:  &validate.Options{Auto: true},
    })
    if err != nil {
    	log.Fatal(err)
    }
  4. Die Eingangsrechnung lesen

    Auf der Seite des Stands beginnt alles mit dem empfangenen PDF. Read findet das eingebettete XML und liest es in dieselbe Struktur invoice.Invoice, mit der die Lebküchnerei es geschrieben hat.

    Go
    in, _, err := zerechnung.Read(received)
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println(in.Seller.Name, "·", in.Number, "vom", in.IssueDate)
    for _, l := range in.Lines {
    	fmt.Printf("%8s €  %4s × %s\n", l.NetAmount, l.Quantity, l.Item.Name)
    }
    fmt.Println("Zu zahlen:", in.Totals.DuePayable, "€ bis", in.PaymentTerms[0].DueDate)
    fmt.Println("Auf das Konto:", in.PaymentMeans[0].PayeeIBAN)
  5. Die Rechnung vor dem Buchen prüfen

    Check prüft das PDF und das XML. Auto ergänzt für einen Verkäufer in Deutschland die Prüfung des Profils: Seit 2025 sind nur BASIC, EN 16931, EXTENDED und XRECHNUNG E-Rechnungen im Sinne des BMF.

    Go
    report, _, err := zerechnung.Check(received, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println("Fehler:", len(report.Errors()))
  6. Was die Prüfung bei einem MINIMUM-PDF meldet

    Das Profil MINIMUM trägt nur die Summen, keine Positionen und nicht alle Pflichtangaben nach § 14 UStG: In Deutschland ist es keine E-Rechnung. Die Prüfung meldet es mit der Regel DE-PROFILE-01, und der Stand darf eine solche Rechnung zurückweisen.

    Go
    minimum, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{Profile: invoice.ProfileMinimum})
    if err != nil {
    	log.Fatal(err)
    }
    report, _, err = zerechnung.Check(minimum, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    for _, f := range report.Errors() {
    	fmt.Println("MINIMUM:", f.Rule)
    }

Was das Programm ausgibt

go run .
Lebküchnerei Merkl e. K. · LM-26-0907 vom 2026-11-25
  510.00 €    12 × Elisenlebkuchen, Karton mit 50 Stück
  720.00 €   300 × Lebkuchenherz „Frohe Weihnachten“, 18 cm
  520.00 €    80 × Nürnberger Zwetschgenmännla
  640.00 €   200 × Geschenkdose aus Blech, Motiv Altstadt
Zu zahlen: 2634.10 € bis 2026-12-09
Auf das Konto: DE75512108001245126199
Fehler: 0
MINIMUM: DE-PROFILE-01
Das vollständige Programm
main.go
package main

import (
	"fmt"
	"log"
	"os"
	"time"

	"github.com/ritoon/zerechnung"
	"github.com/ritoon/zerechnung/invoice"
	"github.com/ritoon/zerechnung/validate"
)

func main() {
	// Die Lebküchnerei beschreibt die Rechnung
	pdf, err := os.ReadFile("rechnung.pdf")
	if err != nil {
		log.Fatal(err)
	}
	d := invoice.MustDecimal
	inv := &invoice.Invoice{
		Profile:   invoice.ProfileEN16931,
		Number:    "LM-26-0907",
		TypeCode:  invoice.TypeCommercialInvoice,
		IssueDate: invoice.NewDate(2026, time.November, 25),
		Currency:  "EUR",
		Seller: invoice.Party{
			Name:  "Lebküchnerei Merkl e. K.",
			VATID: "DE369147258",
			Address: invoice.Address{
				Line1: "Bergstraße 9", PostCode: "90403", City: "Nürnberg", CountryCode: "DE",
			},
		},
		Buyer: invoice.Party{
			Name:  "Monika Hollerbach, Lebkuchen und Geschenke",
			VATID: "DE528471633",
			Address: invoice.Address{
				Line1:       "Glockengießergasse 4",
				PostCode:    "90403",
				City:        "Nürnberg",
				CountryCode: "DE",
			},
		},
		DeliveryDate: invoice.NewDate(2026, time.November, 24),
		PaymentMeans: []invoice.PaymentMeans{{
			TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "DE75512108001245126199",
		}},
		PaymentTerms: []invoice.PaymentTerms{{
			Description: "Zahlbar bis 9. Dezember 2026 ohne Abzug.",
			DueDate:     invoice.NewDate(2026, time.December, 9),
		}},
	}

	// Lebkuchen zu 7 %, Blechdosen zu 19 %
	inv.Lines = []invoice.Line{{
		ID: "1", Item: invoice.Item{Name: "Elisenlebkuchen, Karton mit 50 Stück"},
		Quantity: d("12"), UnitCode: "H87", NetPrice: d("42.50"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "2", Item: invoice.Item{Name: "Lebkuchenherz „Frohe Weihnachten“, 18 cm"},
		Quantity: d("300"), UnitCode: "H87", NetPrice: d("2.40"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "3", Item: invoice.Item{Name: "Nürnberger Zwetschgenmännla"},
		Quantity: d("80"), UnitCode: "H87", NetPrice: d("6.50"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("7"),
	}, {
		ID: "4", Item: invoice.Item{Name: "Geschenkdose aus Blech, Motiv Altstadt"},
		Quantity: d("200"), UnitCode: "H87", NetPrice: d("3.20"),
		VATCategoryCode: invoice.VATStandard, VATRate: d("19"),
	}}

	// Das ZUGFeRD-PDF erzeugen
	received, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
		Calculate: true,
		Validate:  &validate.Options{Auto: true},
	})
	if err != nil {
		log.Fatal(err)
	}

	// Die Eingangsrechnung lesen
	in, _, err := zerechnung.Read(received)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(in.Seller.Name, "·", in.Number, "vom", in.IssueDate)
	for _, l := range in.Lines {
		fmt.Printf("%8s €  %4s × %s\n", l.NetAmount, l.Quantity, l.Item.Name)
	}
	fmt.Println("Zu zahlen:", in.Totals.DuePayable, "€ bis", in.PaymentTerms[0].DueDate)
	fmt.Println("Auf das Konto:", in.PaymentMeans[0].PayeeIBAN)

	// Die Rechnung vor dem Buchen prüfen
	report, _, err := zerechnung.Check(received, &validate.Options{Auto: true})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("Fehler:", len(report.Errors()))

	// Was die Prüfung bei einem MINIMUM-PDF meldet
	minimum, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{Profile: invoice.ProfileMinimum})
	if err != nil {
		log.Fatal(err)
	}
	report, _, err = zerechnung.Check(minimum, &validate.Options{Auto: true})
	if err != nil {
		log.Fatal(err)
	}
	for _, f := range report.Errors() {
		fmt.Println("MINIMUM:", f.Rule)
	}
}

So führen Sie es in einem Klon des Repositorys aus:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/de-3-lebkuchen
go run .

Dieses Beispiel auf GitHub

Weitere Beispiele, zu jeder Funktion des Pakets: Vollständige Beispiele im README · API-Referenz