Wie sieht das XML-Format einer ZUGFeRD-Rechnung mit Zuschlägen und mehreren Positionen aus?

Question

Accepted Answer

## Klare Antwort

**Eine ZUGFeRD-Rechnung mit mehreren Positionen und Zuschlägen besteht im XML nicht aus „irgendwelchen freien Tags“, sondern aus einer festen EN16931-/CII-Struktur: Kopf der Rechnung, Summen/Steuern und dann je Position ein `IncludedSupplyChainTradeLineItem`; Zuschläge stehen entweder auf Belegebene als `SpecifiedTradeAllowanceCharge` oder auf Positionsebene innerhalb der jeweiligen Zeile.** Die entscheidende praktische Folge: Wenn du Zuschläge einfach als zusätzliche Textzeile modellierst, ist die Rechnung oft fachlich lesbar, aber nicht sauber validierbar. ([en.e-rechnung-bund.de](https://en.e-rechnung-bund.de/e-invoicing-faq/xrechnung/))

## So ist die Struktur wirklich aufgebaut

Bei ZUGFeRD 2.x ist das XML in der Regel **UN/CEFACT Cross Industry Invoice (CII)**. Für mehrere Positionen wiederholt sich der Block `IncludedSupplyChainTradeLineItem` einfach mehrfach. Ein Zuschlag ist dagegen **kein eigener Fantasie-Knoten**, sondern fachlich eine **Charge**:

- **Dokumentenzuschlag**: im Summenbereich der Rechnung
- **Positionszuschlag**: innerhalb der betroffenen Rechnungsposition
- **Normale weitere Leistung** wie „Versand“ oder „Verpackung“ kann alternativ auch als eigene Position modelliert werden, wenn sie wie ein abrechenbarer Artikel behandelt werden soll

Genau dieser Unterschied wird in vielen Erklärungen zu oberflächlich behandelt: **„Versandkosten“ sind technisch nicht automatisch ein Zuschlag.** Wenn sie eine eigenständige abrechenbare Leistung sind, ist eine eigene Position oft sauberer; wenn sie ein echter Aufschlag auf die Rechnung oder auf eine Zeile sind, dann als Charge. ([bvbs.de](https://www.bvbs.de/wp-content/uploads/2024/04/ZUGFeRD-Implementierungs-Leitfaden-2.2_20240321.pdf))

## Beispiel: ZUGFeRD-XML mit 2 Positionen und Dokumentenzuschlag

Das folgende Beispiel ist **vereinfacht, aber strukturell nah an echtem CII/ZUGFeRD EN16931**. Es zeigt:

- 2 Positionen
- 1 Zuschlag auf Dokumentebene
- Netto-/Steuer-/Bruttosummen

```xml

urn:cen.eu:en16931:2017

RE-2026-1001
    380
    
      20260420

1

Artikel A

100.00

2

VAT
          S
          19.00

200.00

2

Artikel B

50.00

1

VAT
          S
          19.00

50.00

Muster GmbH

Kunde AG

20260420

EUR

49.40
        VAT
        260.00
        S
        19.00

true
        
        10.00
        Versandzuschlag
        
          VAT
          S
          19.00

250.00
        10.00
        260.00
        49.40
        309.40
        309.40

```

## Beispiel: Zuschlag direkt an einer Position

Wenn der Zuschlag **nur eine einzelne Position** betrifft, gehört er an die Zeile, nicht in den Kopf. Genau das wird in vielen Implementierungen falsch gemacht. Für line-level Charges/Allowances gibt es eigene Gruppen und Validierungsregeln. ([xoev.de](https://www.xoev.de/sixcms/media.php/13/211-XRechnung-2021-07-29.pdf))

Vereinfacht sieht das so aus:

```xml

1

Artikel A

100.00

true
        
        5.00
        Expressaufschlag

105.00

2

VAT
      S
      19.00

210.00

```

## Was in der Praxis oft schiefgeht

Der wichtigste Unterschied ist:

- **Eigene Position**: sinnvoll für Versand, Verpackung, Servicepauschale, wenn das als separat abrechenbare Leistung erscheinen soll
- **Zuschlag/Charge**: sinnvoll, wenn es fachlich ein Aufschlag auf Rechnung oder Position ist
- **Rabatt/Nachlass**: gleiche Struktur, aber `ChargeIndicator = false`

Das ist nicht nur Stilfrage, sondern wirkt direkt auf Summenbildung, Steueraufschlüsselung und Validierung. Gerade bei EN16931 müssen Zuschläge und Nachlässe mit Betrag und Steuerbezug sauber modelliert werden. ([xoev.de](https://www.xoev.de/sixcms/media.php/13/211-XRechnung-2021-07-29.pdf))

## Was du mindestens brauchst

Für eine valide ZUGFeRD-Rechnung mit mehreren Positionen und Zuschlägen brauchst du mindestens:

- Rechnungsnummer, Datum, Typ
- Verkäufer und Käufer
- Währung
- je Position: laufende Nummer, Bezeichnung, Menge, Einheit, Preis, Steuer
- Zuschlag entweder auf Kopf- oder Positionsebene
- korrekte Summen:
  - Summe der Positionen
  - Summe Zuschläge
  - Steuerbasis
  - Steuerbetrag
  - Gesamtbetrag

Die eigentliche Hürde ist meist **nicht das XML-Schreiben**, sondern die **konsistente Berechnung**. Wenn `LineTotalAmount`, `ChargeTotalAmount`, `TaxBasisTotalAmount`, `TaxTotalAmount` und `GrandTotalAmount` nicht exakt zusammenpassen, fällt die Rechnung bei der Validierung durch. Das ist der Punkt, an dem viele Beispielseiten zu ungenau bleiben. ([xoev.de](https://www.xoev.de/sixcms/media.php/13/211-XRechnung-2021-07-29.pdf))

## Praktische Empfehlung

**Wenn du ein ERP oder Shopsystem anbindest, modelliere Zuschläge nur dann als echte Charge, wenn sie fachlich ein Aufschlag sind; alles, was der Kunde als eigene abrechenbare Leistung sehen soll, ist meist besser als normale Rechnungsposition aufgehoben.** Das macht XML, Steuerlogik und spätere Verarbeitung deutlich rob

Wie sieht das XML-Format einer ZUGFeRD-Rechnung mit Zuschlägen und mehreren Positionen aus?

Verwandte Fragen

Wie bearbeite ich das Rechnungsformular in Shopware 5?