Zum Hauptinhalt springen

BR-DE-22 Dateinamen eingebetteter Anhänge müssen eindeutig sein

Gemäß der deutschen XRechnung-Regel BR-DE-22 darf ein Rechnungsdokument keine eingebetteten Anhänge mit identischem Dateinamen enthalten (BT-125 / Attribut filename). Wenn mehrere zusätzliche beigefügte Dokumente (BG-24 / AdditionalDocumentReference) mit binären Anhängen (cac:Attachment/cbc:EmbeddedDocumentBinaryObject bzw. ram:AttachmentBinaryObject) beigefügt werden, muss jeder Dateiname eindeutig sein. Doppelte Dateinamen führen in Dokumentenmanagementsystemen zu Überschreibungsfehlern oder dem Verlust von Leistungsnachweisen und Verträgen.

Problembeschreibung

FEHLER

Nationale XRechnung-Regel (KoSIT, BR-DE) · XRechnung 3.0

Interaktive Prüfkette

Klicken Sie auf eine Stufe, um zu sehen, was sie prüft, oder geben Sie eine Regel-ID ein, um die meldende Stufe zu finden.

Beispiele:

BR-DE-22 XRechnung-Regel (Deutschland)

Gemeldet in Stufe 3: Nationale Regeln (CIUS).

Stufe Fehler: Der Bericht empfiehlt, die Rechnung abzulehnen.

Stufe 3 · Was geprüft wird

  • Die Spezifikationskennung in BT-24 wählt das Regelwerk, etwa XRechnung 3.0 oder Peppol BIS Billing 3.0.
  • XRechnung ergänzt die deutschen BR-DE-Regeln: Käuferreferenz (BT-10), Verkäuferkontakt, Zahlungsanweisungen.
  • Peppol ergänzt PEPPOL-EN16931- und Länderregeln. Auch XRechnung wendet einige PEPPOL-EN16931-Regeln an.

Beispielcodes

Typische Korrektur

Pflegen Sie die vom Regelwerk verlangten Felder in den Stammdaten, etwa die Leitweg-ID in BT-10 oder den Verkäuferkontakt.

Ein Validator prüft eine E-Rechnung in Stufen. Zuerst muss die Datei wohlgeformtes XML sein und zum UBL- oder CII-Schema (XSD) passen. Dann laufen die Geschäftsregeln der EN 16931: BR-Kernregeln, BR-CO-Berechnungen, BR-CL-Codelisten, BR-DEC-Nachkommastellen und Regeln je Umsatzsteuerkategorie wie BR-S. Danach folgen die nationalen oder Netzwerk-Regeln, die BT-24 auswählt: BR-DE für XRechnung, PEPPOL-EN16931 für Peppol BIS Billing. Der Bericht nennt jede verletzte Regel: Ein Fehler bedeutet Ablehnung, nur Warnungen bedeuten weiterhin Annahme. BR-DE-22: XRechnung-Regel (Deutschland), gemeldet in der Stufe „Nationale Regeln (CIUS)“. Regelwerke: KoSIT-Validator 1.6.3 mit der XRechnung-Konfiguration vom 31. Aug. 2026 (EN-16931-Artefakte 1.3.16), Peppol BIS Billing 3.0.21.

Lösung

Stellen Sie in Ihrem ERP- oder Dokumentenmanagementsystem sicher, dass alle angehängten Dateien vor dem XML-Export eindeutige Dateinamen haben. In UBL 2.1 befüllen Sie eindeutige filename-Attribute: <cbc:EmbeddedDocumentBinaryObject filename="stundennachweis_januar.pdf" mimeCode="application/pdf"> unter <cac:AdditionalDocumentReference>. In UN/CEFACT CII befüllen Sie eindeutige filename-Attribute unter <ram:AdditionalReferencedDocument>. Benennen Sie gleichnamige Anhänge vor dem Versand um (z. B. „anlage_1.pdf“, „anlage_2.pdf“).

Schnellzugriff

Kontext und Bedeutung

Der deutsche XRechnung-Validator prüft alle Dateinamen eingebetteter Anhänge strikt auf Duplikate und löst bei identischen Namen den Fehler BR-DE-22 aus.

Gültige Beispiele

  • Rechnung mit zwei Anhängen: „stundennachweis_januar.pdf“ und „leistungsabnahme_januar.pdf“
  • Rechnung mit einzelnem Anhang: „vertrag_anlage_1.pdf“

Ungültige Beispiele

  • Rechnung enthält zwei Anhänge, die beide „anlage.pdf“ heißen
  • cac:AdditionalDocumentReference enthält mehrere Binärobjekte mit identischem filename-Attribut

Code-Beispiele

Gültiges XML
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-1</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="stundennachweis.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-2</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="leistungsnachweis.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
Ungültiges XML
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-1</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AdditionalDocumentReference>
  <cbc:ID>DOC-2</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

Betroffene Felder

Validierungstools