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

Die Meldung kommt auf Englisch, die Ursache ist simpel: Unter den Anhängen, die direkt in die XML eingebettet sind, gibt es mindestens zwei mit identischem Dateinamen.

Was die Regel prüft

Eine E-Rechnung kann rechnungsbegründende Unterlagen (BG-24, BG = Business Group, eine Feldgruppe der Norm) direkt als Binärdaten mitführen, etwa Stundenzettel, Aufmaße oder Lieferscheine. Jeder eingebettete Anhang (BT-125) trägt ein filename-Attribut. BR-DE-22 verlangt, dass diese Dateinamen innerhalb der Rechnung eindeutig sind. Der Grund ist praktisch: Der Empfänger speichert die Anhänge unter genau diesen Namen ab. Bei Duplikaten würde eine Datei die andere überschreiben oder die Zuordnung wäre mehrdeutig.

Warum sie in der Praxis fehlschlägt

1. Standardnamen aus der Software. Manche Programme benennen jeden Export gleich, etwa Anlage.pdf oder attachment.pdf. Bei einem Anhang fällt das nicht auf, ab dem zweiten schlägt die Regel an.
2. Gleichnamige Quelldateien. Wer zwei Lieferscheine anhängt, die beide Lieferschein.pdf heißen, weil sie aus verschiedenen Ordnern stammen, erzeugt exakt diesen Konflikt.
3. Derselbe Anhang doppelt. Ein Dokument wird versehentlich zweimal angehängt, z. B. einmal manuell und einmal automatisch von der Software.

So behebst du den Fehler

Benenne die Anhänge vor dem Anhängen sprechend und eindeutig, am besten mit Bezug zum Inhalt: Lieferschein-4711.pdf, Aufmass-BV-Mueller.pdf. Das behebt nicht nur den Validierungsfehler, sondern hilft auch dem Sachbearbeiter beim Empfänger. Prüf außerdem, ob wirklich alle Anhänge gebraucht werden, Duplikate fliegen raus. Belegschmied prüft die Dateinamen beim Hochladen und fordert bei Kollision einen anderen Namen an.

XML-Beispiel: vorher und nachher

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>Lieferschein 2026-0815</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <!-- verletzt BR-DE-22: filename "Anlage.pdf" kommt doppelt vor -->
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="Anlage.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>
<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>Stundenzettel KW 32</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="Anlage.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>Lieferschein 2026-0815</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="Lieferschein-2026-0815.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>
<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>Stundenzettel KW 32</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf" filename="Stundenzettel-KW32.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>