# 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

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“).

- validate
- convert

## 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>
    <!-- Duplicate filename triggers BR-DE-22 -->
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
```

## Betroffene Felder

- [BT-125 Anhangsdokument](/resources/xrechnung/bt-125-attached-document)
- [BG-24 Zusätzliche beigefügte Dokumente](/resources/xrechnung)
- [BT-122 Referenz auf das beigefügte Dokument](/resources/xrechnung/bt-122-supporting-document-reference)

## Verwandte Regeln

- [BR-DE-23](#)
- [BR-52](/resources/kosit-validator-errors/br-52-supporting-document-reference-required)

## Validierungstools

- [Offizieller KoSIT Validator](https://erechnungsvalidator.service-bw.de/): Überprüfen Sie Ihre XRechnung-Dateien gegen alle BR-DE-Regeln.
- [PDF zu XRechnung konvertieren](/pdf-to-xrechnung): Validierungsfehler beim Konvertieren erkennen, prüfen und gezielt beheben.

## Verwandte Ressourcen

- [Offizielle Spezifikation](https://xeinkauf.de/xrechnung/)
- [Testsuite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Vollständige Fehlerliste](/resources/kosit-validator-errors): Übersicht aller deutschen XRechnung-Validierungsregeln.