XRechnung-Fehlermeldungen verstehen
Häufige Validierungsfehler erklärt mit praktischen Lösungen
Wenn Ihre XRechnung die Validierung nicht besteht, erhalten Sie Fehlermeldungen mit technischen Codes. Dieser Leitfaden erklärt die häufigsten Fehler und zeigt, wie Sie diese beheben.
Schematron-Fehler vs. XML-Schema-Fehler
XRechnung-Validierung erfolgt in zwei Schritten:
1. XML-Schema-Validierung (XSD)
Prüft die grundlegende XML-Struktur, Datentypen und Elementreihenfolge. Fehler hier bedeuten, dass die XML-Datei nicht wohlgeformt oder strukturell falsch ist.
2. Schematron-Validierung
Prüft geschäftliche Regeln, Berechnungen und Pflichtfelder. Diese Fehler beginnen typischerweise mit 'BR-' oder 'BT-' Codes.
Top 10 häufige Fehler
Fehlende Käuferreferenz (Buyer Reference)
In Deutschland ist die Käuferreferenz Pflicht. Dies ist oft die Leitweg-ID oder Bestellnummer.
Fügen Sie <cbc:BuyerReference> direkt unter dem Invoice-Element hinzu.
<ubl:Invoice>
<cbc:BuyerReference>991-B12345-99</cbc:BuyerReference>
...
</ubl:Invoice>Verkäufername fehlt
Der Name des Rechnungsstellers ist ein Pflichtfeld.
Ergänzen Sie den Verkäufernamen in PartyName:
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Musterfirma GmbH</cbc:Name>
</cac:PartyName>
</cac:Party>
</cac:AccountingSupplierParty>Summen stimmen nicht überein
Die berechneten Gesamtbeträge (Netto + MwSt = Brutto) stimmen nicht mit den angegebenen Werten überein.
Überprüfen Sie alle Beträge und Rundungen. Verwenden Sie maximal 2 Nachkommastellen für Geldbeträge.
💡 Häufige Ursache: Rundungsfehler bei der Berechnung
Rechnungswährung fehlt
Die Währung der Rechnung muss angegeben werden.
Fügen Sie den DocumentCurrencyCode hinzu:
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>Ungültige Umsatzsteuer-Identifikationsnummer
Die USt-IdNr hat nicht das korrekte Format.
Format: DE + 9 Ziffern (z.B. DE123456789)
<cbc:CompanyID schemeID="VAT">DE123456789</cbc:CompanyID>Leistungsdatum fehlt
Das Datum der Leistungserbringung ist erforderlich.
Fügen Sie das Lieferdatum oder den Leistungszeitraum hinzu:
<cbc:ActualDeliveryDate>2026-01-15</cbc:ActualDeliveryDate>Umsatzsteuerkategorie fehlt
Jede Position muss eine Steuerkategorie haben.
Standard-MwSt in Deutschland:
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>19</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>Leitweg-ID hat falsches Format
Die Leitweg-ID muss dem Format 'XX-YYYYYY-ZZ' entsprechen.
Format: 2-3 Ziffern + 6 Zeichen + 2 Ziffern, getrennt durch '-'
Korrekt: 991-B12345-99 | Falsch: 991B1234599
Zahlungsbedingungen unvollständig
Wenn Zahlungsbedingungen angegeben werden, müssen diese vollständig sein.
Geben Sie mindestens Zahlungsziel oder Skontobedingungen an.
💡 Zahlungsbedingungen sind optional, aber wenn vorhanden, müssen sie vollständig sein.
Rechnungsempfänger-Adresse unvollständig
Name, Postleitzahl und Stadt sind Pflichtfelder für den Empfänger.
Vervollständigen Sie die Adressangaben:
<cac:PostalAddress>
<cbc:StreetName>Musterstraße 1</cbc:StreetName>
<cbc:CityName>Berlin</cbc:CityName>
<cbc:PostalZone>10115</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>DE</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>XML nicht wohlgeformt
Wenn die XML-Datei nicht einmal geparst werden kann:
- Nicht geschlossene Tags (<Invoice> ohne </Invoice>)
- Falsche Zeichenkodierung (verwenden Sie UTF-8)
- Sonderzeichen nicht escaped (&, <, > müssen als &, <, > geschrieben werden)
- Fehlerhafte Namespace-Deklarationen
✓ Verwenden Sie einen XML-Editor mit Syntax-Highlighting oder einen XML-Validator, um strukturelle Fehler zu finden.