KoSIT-Validator Meldungen bei XRechnung, ZUGFeRD und Peppol – auf Deutsch erklärt
Der KoSIT-Validator gibt Fehlermeldungen mit einer Rule-ID (z.B. BR-DE-1) und einem technischen Text auf Englisch aus. Die folgende Referenz erklärt die häufigsten Meldungen auf Deutsch und zeigt, was zu tun ist.
BR-DE-Regeln sind XRechnung-spezifische Pflichtregeln der deutschen CIUS. Sie gelten zusätzlich zu den EN16931-Grundregeln und sind besonders häufig Ursache für Reject-Ergebnisse.
The element 'BT-10' is required in the context of 'XRECHNUNG'.
Das Feld BT-10 (Buyer Reference / Käuferreferenz) ist bei XRechnung-Dokumenten Pflicht. Im B2G-Kontext enthält es die Leitweg-ID des Empfängers, z.B. 991-12345-67. Im B2B-Kontext kann hier eine interne Referenz des Käufers eingetragen werden. Das Feld darf nicht leer bleiben.
The element 'BG-6' is required.
XRechnung verlangt zwingend Kontaktdaten des Verkäufers (BG-6). Die Gruppe muss Name (BT-41), Telefonnummer (BT-42) und E-Mail-Adresse (BT-43) enthalten – alle drei Felder sind Pflicht (siehe auch BR-DE-6).
The seller's VAT identifier (BT-31), the seller's tax registration identifier (BT-32) or the seller's legal registration identifier (BT-30) shall be present.
Der Verkäufer muss mindestens eine steuerliche Kennung angeben: entweder die USt-Identifikationsnummer (BT-31) oder die Steuernummer (BT-32) – oder beide. Ein Dokument ohne jegliche Steueridentifikation des Verkäufers ist nicht XRechnung-konform.
The seller contact name (BT-41), the seller contact telephone number (BT-42) and the seller contact email address (BT-43) shall be provided.
Wenn die Kontaktgruppe BG-6 vorhanden ist, müssen alle drei Felder belegt sein. Häufiger Fehler: Telefonnummer oder E-Mail wird weggelassen, weil nur der Name eingetragen wurde.
The buyer electronic address (BT-49) shall be provided.
BT-49 ist die elektronische Adresse des Käufers – bei Rechnungen an Bundesbehörden üblicherweise eine E-Rechnungs-Routing-Adresse im Format 0204:123456789 (Leitweg-Identifier-Schema). Das Feld muss mit dem Schema-Prefix angegeben werden.
The seller electronic address (BT-34) shall be provided.
BT-34 ist die elektronische Adresse des Verkäufers, z.B. eine E-Mail im Format EM:rechnungen@firma.de. Das Feld verlangt zwingend einen Schema-Prefix vor dem eigentlichen Wert.
The document level payment means code (BT-81) shall be one of the permitted values.
XRechnung erlaubt nur bestimmte Zahlungsart-Codes (BT-81) aus der UNTDID-4461-Codeliste. Die häufig verwendeten Werte sind 58 (SEPA-Überweisung), 59 (SEPA-Lastschrift) und ZZZ (sonstige). Codes außerhalb der XRechnung-Whitelist werden abgelehnt.
BR-Regeln (ohne DE-Suffix) gelten für alle EN16931-konformen Dokumente – also XRechnung, ZUGFeRD/EN16931 und Peppol gleichermaßen.
Invoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110).
Der Bruttobetrag (BT-112) muss exakt der Summe aus Nettobetrag (BT-109) und Gesamtsteuerbetrag (BT-110) entsprechen. Rundungsdifferenzen führen zu diesem Fehler. Lösung: alle Beträge auf zwei Dezimalstellen runden und die Summe rechnerisch korrekt befüllen.
Invoice total amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) - Paid amount (BT-113) + Rounding amount (BT-114).
BT-115 muss rechnerisch aus BT-112 minus BT-113 (bereits bezahlt) plus BT-114 (Rundung) resultieren. Wenn BT-113 und BT-114 nicht belegt sind, muss BT-115 gleich BT-112 sein.
Sum of Invoice line net amount (BT-106) = Σ Invoice line net amount (BT-131).
Der Gesamtbetrag BT-106 im Rechnungskopf muss der Summe aller Positionsnettobeiträge (BT-131) entsprechen. Häufige Ursache: ein Positionsbetrag wurde manuell angepasst, ohne den Kopfbetrag zu aktualisieren.
For each different value of VAT category code (BT-118) equal to 'S', the VAT category rate (BT-119) shall be provided.
Wenn als USt-Kategorie S (Standardsatz) angegeben ist, muss auch der Steuersatz BT-119 belegt sein – z.B. 19 oder 7. Ein leerer Steuersatz bei Kategorie S ist nicht zulässig.
A VAT breakdown (BG-23) with VAT Category code (BT-118) 'Reverse charge' shall have a VAT exemption reason code (BT-121) or VAT exemption reason text (BT-120).
Bei Reverse-Charge-Rechnungen (Steuerkategorie AE) muss entweder BT-120 (Befreiungsgrund als Text) oder BT-121 (Befreiungsgrundcode, z.B. VATEX-EU-AE) angegeben werden.
The specification identifier (BT-24) value shall be in the list.
BT-24 (CustomizationID) muss einen der offiziell zugelassenen Werte enthalten. Die häufigsten:
urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0urn:cen.eu:en16931:2017urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0Diese Meldungen treten auf, wenn der Validator aus einem ZUGFeRD-PDF kein gültiges XML extrahieren kann oder das eingebettete XML strukturelle Probleme hat.
No embedded XML attachment found in PDF.
Das hochgeladene PDF ist kein ZUGFeRD-Dokument – es enthält keine eingebettete XML-Datei. ZUGFeRD-PDFs müssen nach PDF/A-3 (ISO 19005-3) erstellt werden, mit einer korrekt als factur-x.xml oder zugferd-invoice.xml eingebetteten CII-Datei.
Attachment filename is 'rechnung.xml', expected 'factur-x.xml' or 'zugferd-invoice.xml'.
Der ZUGFeRD-Standard schreibt den Dateinamen des eingebetteten XML vor. Zulässig sind factur-x.xml (Factur-X / ZUGFeRD 2.x) und zugferd-invoice.xml (ältere ZUGFeRD-1.0-Dokumente). Ein abweichender Dateiname führt je nach Empfänger zur Ablehnung.
Peppol-Regeln beginnen mit PEPPOL- oder länderspezifisch mit dem Ländercode, z.B. PEPPOL-DE- für deutsche Rechnungen.
A conformant document MUST have a buyer reference or purchase order reference (BT-10 or BT-13).
Peppol BIS Billing verlangt entweder eine Käuferreferenz (BT-10) oder eine Bestellreferenz (BT-13). Mindestens eines der beiden Felder muss belegt sein – anders als bei der EN16931, wo beide optional sind.
Unit code MUST be coded according to the UN/ECE Recommendation 20.
Mengeneinheiten (BT-130) müssen aus der UN/ECE Recommendation 20 stammen. Häufige gültige Codes: C62 (Stück), HUR (Stunde), DAY (Tag), MTK (Quadratmeter). Freitext wie "Stück" oder "Std." ist nicht zulässig.