# BR-DE-22 I nomi file degli allegati incorporati devono essere univoci

In base alla regola tedesca XRechnung BR-DE-22, la fattura non deve contenere allegati incorporati con nomi file identici (BT-125 / attributo filename). Quando sono presenti più documenti di supporto (BG-24) con allegati binari (cac:Attachment/cbc:EmbeddedDocumentBinaryObject o ram:AttachmentBinaryObject), ciascun nome file deve essere univoco. Nomi duplicati causano sovrascritture nei sistemi documentali.

## Descrizione del problema

In base alla regola tedesca XRechnung BR-DE-22, la fattura non deve contenere allegati incorporati con nomi file identici (BT-125 / attributo filename). Quando sono presenti più documenti di supporto (BG-24) con allegati binari (cac:Attachment/cbc:EmbeddedDocumentBinaryObject o ram:AttachmentBinaryObject), ciascun nome file deve essere univoco. Nomi duplicati causano sovrascritture nei sistemi documentali.

> **ERRORE**: XRechnung 3.0

## Contesto e significato

Il validatore tedesco XRechnung controlla rigorosamente i nomi dei file allegati incorporati e attiva l’errore BR-DE-22 in presenza di duplicati.

## Soluzione

Nel gestionale ERP o sistema documentale assicurati che tutti i file allegati abbiano nomi univoci prima dell’esportazione XML XRechnung. In UBL 2.1 compila attributi filename univoci in <cbc:EmbeddedDocumentBinaryObject filename="rapporto_ore_gennaio.pdf" mimeCode="application/pdf"> dentro <cac:AdditionalDocumentReference>. In CII compila attributi filename univoci sotto <ram:AdditionalReferencedDocument>.

- validate
- convert

## Esempi validi

- Fattura con due allegati: "rapporto_gennaio.pdf" e "verbale_collaudo_gennaio.pdf"
- Fattura con allegato singolo: "allegato_contratto_1.pdf"

## Esempi non validi

- La fattura include due allegati entrambi denominati "anlage.pdf"
- cac:AdditionalDocumentReference contiene più oggetti binari con attributi filename identici

## Esempi di codice

### XML valido
```
<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>
```

### XML non valido
```
<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>
```

## Campi interessati

- [BT-125 Documento allegato](/resources/xrechnung/bt-125-attached-document)
- [BG-24 Documenti di supporto aggiuntivi](/resources/xrechnung)
- [BT-122 Riferimento del documento di supporto](/resources/xrechnung/bt-122-supporting-document-reference)

## Regole correlate

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

## Strumenti di validazione

- [Validatore KoSIT ufficiale](https://erechnungsvalidator.service-bw.de/): Valida i tuoi file XRechnung rispetto a tutte le regole BR-DE.
- [Converti PDF in XRechnung](/pdf-to-xrechnung): Correzione automatica degli errori di validazione durante la conversione.

## Risorse correlate

- [Specifiche ufficiali](https://xeinkauf.de/xrechnung/)
- [Test suite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Elenco completo degli errori](/resources/kosit-validator-errors): Panoramica di tutte le regole di validazione XRechnung tedesche.