BR-DE-22: Dateinamen der Anhänge sind nicht eindeutig

Offizielle Meldung

[BR-DE-22] Not all filename attributes of the embeddedDocumentBinaryObject elements are unique

XRechnung (CII) · Fehler · Sprache der Meldung: Englisch · Stand: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-DE-22] Das "filename"-Attribut aller "EmbeddedDocumentBinaryObject"-Elemente muss eindeutig sein

XRechnung (UBL) · Fehler · Sprache der Meldung: Deutsch · Stand: xrechnung-3.0.2-validator-configuration-2026-08-31

Schweregrad: Fehler Die Rechnung gilt als ungültig und kann vom Empfänger abgelehnt werden.
Gilt für: XRechnung (CII), XRechnung (UBL)

Was bedeutet das?

Alle eingebetteten Anhänge (Attached document, BT-125) einer XRechnung müssen unterschiedliche Dateinamen (Attribut filename) haben. Mindestens zwei Anhänge tragen denselben Dateinamen.

Typische Ursachen

Dieselbe Datei wurde mehrfach angehängt.
Verschiedene Dateien haben denselben Namen, z. B. mehrere Anhänge mit dem Namen anlage.pdf.

So beheben Sie den Fehler

Jedem Anhang einen eigenen, eindeutigen Dateinamen geben, z. B. lieferschein_4711.pdf und stundenzettel_maerz.pdf.
Doppelt angehängte Dateien entfernen.
CII: ram:AdditionalReferencedDocument/ram:AttachmentBinaryObject/@filename, UBL: cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename.
Die Rechnung erneut erzeugen und prüfen.

In E-Rechnungsfreund

Im Rechnungsformular (Ansicht „Experte“) im Abschnitt „Zusätzliche Dokumente (BG-24)“ die Felder „Dateiname (BT-125-2)“ so anpassen, dass jeder Name nur einmal vorkommt, oder doppelte Dokumente entfernen.

Beispiel

Fehlerhaft

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>LS-4711</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="anlage.pdf">...</ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>
<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>STD-03</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="anlage.pdf">...</ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>

Richtig

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>LS-4711</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="lieferschein_4711.pdf">...</ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>
<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>STD-03</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="stundenzettel_maerz.pdf">...</ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>

Für Entwickler: Prüfausdruck je Syntax

XRechnung (CII) (CII)

Kontext: /rsm:CrossIndustryInvoice

count(//ram:AdditionalReferencedDocument) = count(//ram:AdditionalReferencedDocument[not(./ram:AttachmentBinaryObject/@filename = preceding-sibling::ram:AdditionalReferencedDocument/ram:AttachmentBinaryObject/@filename)])

XRechnung (UBL) (UBL)

Kontext: /ubl:Invoice | /cn:CreditNote

count(cac:AdditionalDocumentReference) = count(cac:AdditionalDocumentReference[not(./cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename = preceding-sibling::cac:AdditionalDocumentReference/cac:Attachment/cbc:EmbeddedDocumentBinaryObject/@filename)])

Cookie-Einstellungen