Referenz
Markdown-ExportBR-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
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.
FEHLER
XRechnung 3.0
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.
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
Gültige Beispiele
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- Rechnung mit zwei Anhängen: „stundennachweis_januar.pdf“ und „leistungsabnahme_januar.pdf“
- Rechnung mit einzelnem Anhang: „vertrag_anlage_1.pdf“
Ungültige Beispiele
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- 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
<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><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>
<!-- Duplicate filename triggers BR-DE-22 -->
<cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>