# BR-DE-22 Les noms de fichiers des pièces jointes intégrées doivent être uniques

Conformément à la règle allemande XRechnung BR-DE-22, une facture ne doit pas comporter de pièces jointes intégrées ayant des noms de fichier identiques (BT-125 / attribut filename). Lorsque plusieurs documents justificatifs (BG-24) contiennent des fichiers intégrés (cac:Attachment/cbc:EmbeddedDocumentBinaryObject ou ram:AttachmentBinaryObject), chaque nom de fichier doit être unique. Les doublons risquent d’entraîner l’écrasement ou la perte de justificatifs dans les systèmes de GED.

## Description du problème

> **ERREUR**: Règle nationale allemande XRechnung (KoSIT, BR-DE) · XRechnung 3.0

> **Où BR-DE-22 est contrôlée**
>
> Un validateur contrôle une facture électronique par étapes. D’abord, le fichier doit être un XML bien formé conforme au schéma UBL ou CII (XSD). Viennent ensuite les règles métier de l’EN 16931 : règles de base BR, calculs BR-CO, listes de codes BR-CL, décimales BR-DEC et règles par catégorie de TVA comme BR-S. Puis les règles nationales ou de réseau sélectionnées par BT-24 : BR-DE pour XRechnung, PEPPOL-EN16931 pour Peppol BIS Billing. Le rapport liste chaque règle en échec : une erreur signifie rejet, des avertissements seuls signifient toujours acceptation. BR-DE-22 : règle XRechnung (Allemagne), étape « Règles nationales (CIUS) ».

## Solution

Dans votre ERP ou système de GED, assurez-vous que toutes les pièces jointes possèdent des noms de fichier distincts avant l’export XML XRechnung. En UBL 2.1, renseignez des attributs filename uniques sur <cbc:EmbeddedDocumentBinaryObject filename="rapport_activite_janvier.pdf" mimeCode="application/pdf"> sous <cac:AdditionalDocumentReference>. En CII, renseignez des attributs filename uniques sous <ram:AdditionalReferencedDocument>.

- [Vérifier le XML gratuitement](/fr/xrechnung-validator?source=resource&rule=BR-DE-22)

## Contexte et importance

Le validateur allemand XRechnung contrôle strictement les noms de fichiers des pièces jointes intégrées et déclenche l’erreur BR-DE-22 en cas de doublon.

## Exemples valides

- Facture avec deux pièces jointes: « stundennachweis_januar.pdf » et « leistung_januar.pdf »
- Facture avec une seule pièce jointe: « annexe_contrat_1.pdf »

## Exemples invalides

- La facture contient deux pièces jointes nommées toutes deux « anlage.pdf »
- cac:AdditionalDocumentReference contient plusieurs objets binaires avec des attributs filename identiques

## Exemples de code

### XML valide
```
<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 invalide
```
<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>
    <cbc:EmbeddedDocumentBinaryObject filename="anhang.pdf" mimeCode="application/pdf">UEsDBBQ...</cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>
```

## Champs concernés

- [BT-125 Pièce jointe](/resources/xrechnung/bt-125-attached-document)
- [BG-24 Pièces justificatives supplémentaires](/resources/xrechnung/bt-122-supporting-document-reference)
- [BT-122 Référence de la pièce justificative](/resources/xrechnung/bt-122-supporting-document-reference)

## Règles associées

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

## Outils de validation

- [Validateur KoSIT officiel](https://github.com/itplr-kosit/validator): Exécutez le validateur officiel du KoSIT avec la configuration XRechnung pour contrôler les règles EN 16931 et XRechnung.
- [Convertir un PDF en XRechnung](/pdf-to-xrechnung): Repérez les erreurs de validation pendant la conversion et vérifiez chaque correction.

## Ressources associées

- [Spécification officielle](https://xeinkauf.de/xrechnung/)
- [Suite de tests](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Toutes les erreurs de validation](/resources/kosit-validator-errors): Vue d’ensemble des règles de validation EN 16931, XRechnung et Peppol expliquées ici.
