E-Rechnung Validator

Beispieldateien

XRechnung-Beispiele zum Download — mit dem KoSIT-Validator geprüft

Fünf Beispieldateien mit erfundenen Daten: XRechnung als UBL und als CII, eine Gutschrift, eine Rechnung im Profil EN 16931 und eine ZUGFeRD-PDF. Jede Datei wurde mit dem KoSIT-Validator geprüft, dem frei verfügbaren Prüfprogramm der Koordinierungsstelle für IT-Standards (KoSIT), und ihrer Prüfkonfiguration für XRechnung. Zu jeder Datei kannst du den Prüfbericht des KoSIT-Validators ansehen.

Die Beispieldateien darfst du frei verwenden. Prüfe sie im Validator, lass sie dir als Rechnung anzeigen oder nimm sie als Vorlage für deine eigene Software.

Die Beispieldateien

XML · UBL

XRechnung 3.0, UBL-Rechnung

Rechnung eines IT-Dienstleisters an eine Stadtverwaltung: drei Positionen, zwei Steuersätze (19 % und 7 %), Leitweg-ID als Käuferreferenz, Zahlung per SEPA-Überweisung. Mit Feldnummern (BT) als Kommentar in der Datei.

Datei
xrechnung-ubl.xml (8,6 KB)
Dokument
Rechnung (380)
BT-24
urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
KoSIT
angenommen, weder Fehler noch Warnungen (Szenario „EN16931 XRechnung (UBL Invoice)“)
Mustang
gültig, ohne Fehler und Warnung
XML · CII

XRechnung 3.0, CII-Rechnung

Dieselbe Rechnung wie im UBL-Beispiel, nur in der anderen Syntax (UN/CEFACT Cross Industry Invoice). Gut zum Vergleichen: gleiche Feldnummern, andere Elementnamen.

Datei
xrechnung-cii.xml (12,0 KB)
Dokument
Rechnung (380)
BT-24
urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
KoSIT
angenommen, weder Fehler noch Warnungen (Szenario „EN16931 XRechnung (CII)“)
Mustang
gültig, ohne Fehler und Warnung
XML · UBL

XRechnung 3.0, UBL-Gutschrift

Gutschrift zur Rechnung aus dem UBL-Beispiel: Zwei der zwölf abgerechneten Beratungsstunden wurden nicht erbracht. Zeigt die Wurzel CreditNote, den Dokumenttyp 381 und den Verweis auf die berichtigte Rechnung (BT-25).

Datei
xrechnung-ubl-gutschrift.xml (7,4 KB)
Dokument
Gutschrift (381)
BT-24
urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
KoSIT
angenommen, weder Fehler noch Warnungen (Szenario „EN16931 XRechnung (UBL CreditNote)“)
Mustang
gültig, ohne Fehler und Warnung
XML · CII

EN 16931 (ZUGFeRD-Profil), CII-XML

Rechnung zwischen zwei Unternehmen im Profil EN 16931, so wie die XML in einer ZUGFeRD- oder Factur-X-Rechnung steckt. Mit Nachlass auf Dokumentenebene, abweichender Lieferanschrift und zwei Steuersätzen. Keine XRechnung: BT-24 trägt die EN-16931-Kennung.

Datei
en16931-cii.xml (13,0 KB)
Dokument
Rechnung (380)
BT-24
urn:cen.eu:en16931:2017
KoSIT
angenommen, weder Fehler noch Warnungen (Szenario „EN16931 (CII)“)
Mustang
gültig, ohne Fehler und Warnung Mustang meldet einen Hinweis (BR-DE-21): BT-24 trägt nicht die XRechnung-Kennung. Das ist richtig, die Datei ist keine XRechnung.
PDF · CII

ZUGFeRD-/Factur-X-PDF, Profil EN 16931

Lesbare Rechnung als PDF/A-3 mit eingebetteter XML (Anhang factur-x.xml). Die XML ist dieselbe wie in en16931-cii.xml. Der KoSIT-Validator prüft die eingebettete XML, Mustang zusätzlich die PDF-Hülle und das PDF/A-Format.

Datei
zugferd-en16931.pdf (43,1 KB)
Dokument
Rechnung (380)
BT-24
urn:cen.eu:en16931:2017
KoSIT
angenommen, weder Fehler noch Warnungen (Szenario „EN16931 (CII)“)
Mustang
gültig, ohne Fehler und Warnung Mustang prüft PDF/A-3 (veraPDF 1.30.2) und PDF-Hülle ohne Befund; zur XML dieselbe Meldung wie bei en16931-cii.xml (Hinweis BR-DE-21).

So haben wir geprüft

KoSIT-Validator 1.6.3 mit der Prüfkonfiguration XRechnung vom 31.08.2026 (EN-16931-Schematron 1.3.16, XRechnung-Schematron 2.6.0). Ergebnis bei allen Dateien: angenommen. Im Prüfbericht steht: „Das geprüfte Dokument enthält weder Fehler noch Warnungen.“ Bei der PDF hat der KoSIT-Validator die eingebettete XML geprüft.

Zur Gegenprobe hat Mustang 2.26.0 jede Datei ebenfalls als gültig bewertet. Bei den Dateien im Profil EN 16931 weist Mustang auf BR-DE-21 hin: BT-24 trägt nicht die XRechnung-Kennung. Das stimmt, sie sind keine XRechnung.

Die Berichte sind der Prüfbericht des KoSIT-Validators, unverändert aus seinem Bericht herausgelöst. Unser Dienst ist ein unabhängiges Angebot und kein Angebot der KoSIT.

Alle Angaben sind erfunden: Musterfirma, Beispiel-IBAN, Beispiel-Leitweg-ID. Die Dateien sind nicht für den Versand an echte Empfänger gedacht. Ob ein Empfänger eine Rechnung annimmt, hängt von mehr ab als von den Prüfregeln, bei öffentlichen Auftraggebern etwa von einer echten Leitweg-ID.

So ist eine XRechnung aufgebaut

Eine XRechnung ist eine XML-Datei. Es gibt sie in zwei Syntaxen, UBL und CII. Beide tragen dieselben Angaben, nummeriert nach der europäischen Norm EN 16931: BT steht für ein einzelnes Feld (Business Term), BG für eine Gruppe von Feldern (Business Group). In den Beispieldateien steht die Feldnummer als Kommentar an jedem Element.

Auszug aus xrechnung-cii.xml: Spezifikationskennung, Rechnungsnummer, Typ und Datum

  <rsm:ExchangedDocumentContext>
    <!-- BT-23 Geschäftsprozess -->
    <ram:BusinessProcessSpecifiedDocumentContextParameter>
      <ram:ID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</ram:ID>
    </ram:BusinessProcessSpecifiedDocumentContextParameter>
    <!-- BT-24 Spezifikationskennung: Diese Zeile macht die Datei zur XRechnung 3.0 -->
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>

  <rsm:ExchangedDocument>
    <!-- BT-1 Rechnungsnummer -->
    <ram:ID>RE-2026-1042</ram:ID>
    <!-- BT-3 Rechnungstyp: 380 = Handelsrechnung -->
    <ram:TypeCode>380</ram:TypeCode>
    <!-- BT-2 Rechnungsdatum (format 102 = JJJJMMTT) -->
    <ram:IssueDateTime>
      <udt:DateTimeString format="102">20260930</udt:DateTimeString>
    </ram:IssueDateTime>
    <!-- BT-22 Anmerkung zur Rechnung -->
    <ram:IncludedNote>
      <ram:Content>Vielen Dank für Ihren Auftrag.</ram:Content>
    </ram:IncludedNote>
  </rsm:ExchangedDocument>

Dieselben Felder in beiden Syntaxen. Die Einträge in der Spalte „CII“ stehen unterhalb von rsm:SupplyChainTradeTransaction, wenn nichts anderes dasteht:

BT Feld UBL CII
BT-24 Spezifikationskennung cbc:CustomizationID ram:GuidelineSpecifiedDocumentContextParameter / ram:ID
BT-1 Rechnungsnummer cbc:ID rsm:ExchangedDocument / ram:ID
BT-2 Rechnungsdatum cbc:IssueDate ram:IssueDateTime / udt:DateTimeString
BT-3 Rechnungstyp cbc:InvoiceTypeCode ram:TypeCode
BT-10 Käuferreferenz (Leitweg-ID) cbc:BuyerReference ram:BuyerReference
BT-27 Name des Verkäufers cac:PartyLegalEntity / cbc:RegistrationName ram:SellerTradeParty / ram:Name
BT-44 Name des Käufers cac:PartyLegalEntity / cbc:RegistrationName ram:BuyerTradeParty / ram:Name
BT-84 IBAN cac:PayeeFinancialAccount / cbc:ID ram:PayeePartyCreditorFinancialAccount / ram:IBANID
BT-115 Zahlbetrag cac:LegalMonetaryTotal / cbc:PayableAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation / ram:DuePayableAmount

Welche Felder Pflicht sind und welche Meldung kommt, wenn eines fehlt, steht im Artikel XRechnung-XML erstellen, mit einem vollständigen CII-Beispiel zum Kopieren.

Häufige Fragen

Wie sieht eine XRechnung aus?

Eine XRechnung ist eine XML-Datei ohne Layout. Sie enthält nur Daten, jede Angabe in einem eigenen Element: Rechnungsnummer, Datum, Verkäufer, Käufer, Positionen, Steuer und Summen. Wie das aussieht, zeigen die Dateien auf dieser Seite. Mit „Als Rechnung anzeigen“ siehst du dieselben Daten als lesbare Ansicht.

UBL oder CII: Welche Syntax nehme ich?

Die XRechnung 3.0 gibt es in beiden Syntaxen, und der KoSIT-Validator prüft beide. Inhaltlich sind sie gleich: Die Feldnummern (BT) stimmen überein, nur Aufbau und Elementnamen weichen ab. Nimm die Syntax, die dein Empfänger verlangt, sonst die, die deine Software ausgibt. Das XML in einer ZUGFeRD-Datei ab Version 2.0 ist CII.

Woran erkenne ich, ob eine XML-Datei eine XRechnung ist?

Am Feld BT-24, der Spezifikationskennung. Bei der XRechnung 3.0 lautet sie urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0. Der KoSIT-Validator wählt über dieses Feld die Prüfregeln aus. Gemessen: Fehlt BT-24, findet er kein Prüfszenario, nennt den Dokumenttyp „unbekannt“ und empfiehlt, die Datei zurückzuweisen.

Was unterscheidet die XRechnung von der XML im Profil EN 16931?

Die Kennung in BT-24 ist eine andere. Dazu verlangt die XRechnung einige Angaben, die im Profil EN 16931 optional sind: die Käuferreferenz (BT-10), den Ansprechpartner des Verkäufers (BG-6) und die elektronischen Adressen beider Seiten (BT-34, BT-49). Gemessen mit dem KoSIT-Validator: Ersetzt man in en16931-cii.xml nur BT-24 durch die XRechnung-Kennung, nimmt er die Datei als XRechnung an, weil sie diese Felder schon enthält.

Darf ich die Beispieldateien verwenden?

Ja, du darfst sie frei verwenden: zum Testen deiner Software, für Schulungen oder als Vorlage für eigene Dateien. Alle Angaben sind erfunden. Schicke sie nicht als echte Rechnung an einen Empfänger.

Wie prüfe ich meine eigene Datei?

Lade sie im Validator hoch. Du bekommst einen Prüfbericht mit Regelkennung, Originalmeldung des Prüfers und Fundstelle zu jedem Befund. Das Ergebnis kommt in wenigen Sekunden, die Datei liegt nur während der Prüfung im Arbeitsspeicher.