attestwireAttestwire › XRechnung-Regeln › BR-DE-22
BR-DE-22 Dateinamen von Anhängen müssen eindeutig sein
Ihre Rechnung wurde abgelehnt, weil zwei eingebettete Anhänge denselben Dateinamen tragen. In einer XRechnung muss jeder Dateiname eindeutig sein; benennen Sie einen der Anhänge um. Im Standard ist das die Gruppe BG-24 mit dem Feld BT-125; BR-DE-22 ist die Regel, die die Eindeutigkeit prüft.
Die Regelnummer bezeichnet die fehlgeschlagene Prüfung. BT steht für ein Rechnungsfeld, BG für eine Gruppe von Feldern. XRechnung ergänzt die europäische Norm EN 16931 um deutsche Anforderungen (CIUS).
- Informationselement
BG-24 / BT-125- Schweregrad
fatal— Ablehnung: das Dokument ist nicht konform- Regelwerk
- XRechnung-CIUS (KoSIT) — nationale Verschärfung der EN 16931
Die Lösung
Benennen Sie einen der Anhänge um. Stellen Sie die Rechnungsnummer oder einen Index voran ("2026-000142-anlage-1.pdf", "2026-000142-anlage-2.pdf"), dann bleiben die Namen auch bei gleichartigen Dokumenten eindeutig.
Ein Wert, der die Prüfung besteht
"attachment": { "filename": "2026-000142-stundennachweis.pdf", "mimeCode": "application/pdf", "content": "JVBERi0xLjQK" }Was die Regel verlangt
Der Dateiname jedes eingebetteten Anhangs muss innerhalb der Rechnung eindeutig sein. Zwei Anhänge mit dem Namen anlage.pdf verstoßen gegen die Regel, auch wenn ihr Inhalt verschieden ist.
Der Grund ist naheliegend: Zwei Dateien mit demselben Namen lassen sich nicht auseinanderhalten. Welche von beiden ein Empfänger ablegt oder anzeigt, ist nicht vorhersehbar, und die Regel verhindert, dass diese Frage überhaupt entsteht.
Der offizielle Regeltext
Die Regel BR-DE-22 stammt aus der XRechnung-CIUS und
wird im Schematron der KoSIT geführt, den offiziellen Prüfregeln.
Ein wörtliches Zitat des Regeltextes liegt uns für diese Regel nicht
vor; was Sie oben lesen, ist unsere Erklärung. Maßgeblich ist die
Veröffentlichung der KoSIT.
Warum es die Regel gibt
Anhänge sind bei öffentlichen Aufträgen oft der eigentliche Nachweis: Stundenzettel, Lieferschein, Abnahmeprotokoll. Lässt sich einer davon nicht mehr zuordnen, wird die Rechnung gekürzt oder zurückgestellt, und die Ursache ist von außen schwer zu erkennen. Die Regel fängt das ab, bevor es passieren kann.
So sieht der Befund aus
Genau dieses Objekt liefert die Bibliothek in
result.errors,
wenn die Regel anschlägt. Es wird beim Bauen dieser Seite durch
Ausführen von @attestwire/en16931 erzeugt und entspricht
dem Text, den Sie in Ihrem eigenen Log sehen. Die Meldung selbst ist
englisch, weil die Bibliothek englisch meldet.
{
"rule": "BR-DE-22",
"field": [
"BG-24",
"BT-125"
],
"severity": "fatal",
"message": "Two embedded attachments carry the same filename \"a.pdf\" — supportingDocuments[0] and supportingDocuments[1]. XRechnung requires the filename attribute of every EmbeddedDocumentBinaryObject to be unique, because the receiving system writes the attachments out to one directory: a duplicate name means one document silently overwrites the other, and the one that survives is whichever the parser happened to reach last.",
"fix": "Rename one of them. Prefix with the reference (BT-122) or an index — \"2026-000142-anlage-1.pdf\", \"2026-000142-anlage-2.pdf\" — so the names stay unique even when two attachments genuinely are the same kind of document.",
"example": "\"attachment\": { \"filename\": \"2026-000142-stundennachweis.pdf\", \"mimeCode\": \"application/pdf\", \"content\": \"JVBERi0xLjQK\" }",
"xpath": "/ubl:Invoice/cac:AdditionalDocumentReference[2]/cac:Attachment/cbc:EmbeddedDocumentBinaryObject",
"docsUrl": "https://attestwire.com/rules/BR-DE-22"
}
xpath zeigt auf das Element in einem
UBL-Dokument — dort meldet auch ein KoSIT-Validator
denselben Mangel. Bei einer CII-Rechnung
(xrechnung-cii, ZUGFeRD, Factur-X) erhalten Sie dieselbe
Zeichenkette und müssen sie selbst auf das CII-Element übertragen.
Häufige Fragen
- Was bedeutet BR-DE-22?
- Ihre Rechnung wurde abgelehnt, weil zwei eingebettete Anhänge denselben Dateinamen tragen. In einer XRechnung muss jeder Dateiname eindeutig sein; benennen Sie einen der Anhänge um. Im Standard ist das die Gruppe BG-24 mit dem Feld BT-125; BR-DE-22 ist die Regel, die die Eindeutigkeit prüft.
- Wie behebe ich BR-DE-22?
- Benennen Sie einen der Anhänge um. Stellen Sie die Rechnungsnummer oder einen Index voran ("2026-000142-anlage-1.pdf", "2026-000142-anlage-2.pdf"), dann bleiben die Namen auch bei gleichartigen Dokumenten eindeutig.
- Ist BR-DE-22 Pflicht für XRechnung?
- Ja. Ein Verstoß führt zur Ablehnung, aber nur, wenn Ihre Rechnung mindestens zwei eingebettete Anhänge trägt.