---
title: "Erreur BR-CL-17 (BRCL17) : code de catégorie de TVA hors de la liste UNCL 5305 | Factur-X et EN 16931"
description: "BR-CL-17 (BRCL17), BT-118 (élément CII ram:ApplicableTradeTax/ram:CategoryCode, UBL cac:TaxCategory/cbc:ID) : code de catégorie de TVA hors de la liste UNCL 5305. Remplacez les codes internes, comme TVA20 ou EXO, par la catégorie UNCL 5305 correspondante, en majuscules. Le taux se porte à part, dans le champ de taux de la même catégorie. Vérifiez votre facture dans le bac à sable gratuit."
canonical: https://validationfacture.fr/codes/br-cl-17
---

# BR-CL-17 : code de catégorie de TVA hors de la liste UNCL 5305

## L'essentiel sur BR-CL-17

- **Ce qui est signalé** : code de catégorie de TVA hors de la liste UNCL 5305
- **Donnée visée** : `BT-118`
- **Élément CII (Factur-X)** : `/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode`
- **Élément UBL 2.1** : `/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID`
- **Ce qu'il faut changer** : Remplacez les codes internes, comme TVA20 ou EXO, par la catégorie UNCL 5305 correspondante, en majuscules. Le taux se porte à part, dans le champ de taux de la même catégorie.

Les catégories de TVA se codent avec une restriction de la liste UNCL 5305 à dix valeurs : S (taux normal), Z (taux zéro), E (exonération), AE (autoliquidation), K (livraison intracommunautaire), G (export hors UE), O (hors champ de la TVA), plus L, M et B. En UBL, la règle porte sur cac:TaxCategory/cbc:ID, donc sur la ventilation de TVA (BT-118) comme sur les remises et charges. En CII, elle vise ram:CategoryTradeTax/ram:CategoryCode des remises et charges de document, la ventilation relevant de BR-CL-18.

## Ce que renvoie l'API

- **Code** : `BR-CL-17` (`BRCL17`)
- **Champ concerné** : `vat_breakdown[].category`
- **Terme de la norme** : `BT-118` (Code de catégorie de TVA)
- **Chemin XPath CII (Factur-X)** : `/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode`
- **Chemin XPath UBL 2.1** : `/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:ID`
- **Gravité** : Erreur bloquante
- **Source** : EN 16931
- **Réparation automatique** : Non — la correction demande un arbitrage humain.
- **Version du référentiel** : `2026.08.1`

## Comment corriger

Remplacez les codes internes, comme TVA20 ou EXO, par la catégorie UNCL 5305 correspondante, en majuscules. Le taux se porte à part, dans le champ de taux de la même catégorie.

**Si vous ne corrigez pas :** Le contrôle des listes de codes EN 16931 rejette la facture.

Cette anomalie n'est pas corrigée automatiquement : il faudrait deviner une donnée absente ou choisir entre deux valeurs contradictoires. Le service la signale et laisse la décision à l'émetteur.

## À rapprocher



Autres règles du même groupe : [BR-CL-01](/codes/br-cl-01.md), [BR-CL-04](/codes/br-cl-04.md), [BR-CL-14](/codes/br-cl-14.md), [BR-CL-15](/codes/br-cl-15.md), [BR-CL-16](/codes/br-cl-16.md), [BR-CL-23](/codes/br-cl-23.md), [BR-CL-25](/codes/br-cl-25.md), [BR-CL-03](/codes/br-cl-03.md).

## Contrôler une facture sur ce point

L'opération `validate_invoice` renvoie ce code, le champ en cause, la valeur attendue et la correction, pour 0,10 € par document.
