---
title: "Erreur BR-Z-01 (BRZ01) : catégorie Z utilisée sans sous-total Z dans la ventilation | Factur-X et EN 16931"
description: "BR-Z-01 (BRZ01), BT-118 (élément CII ram:ApplicableTradeTax/ram:CategoryCode, UBL cac:TaxCategory/cbc:ID) : catégorie Z utilisée sans sous-total Z dans la ventilation. Ajoutez un seul sous-total de catégorie Z avec sa base imposable (BT-116) et un montant de TVA (BT-117) à 0.00, ou fusionnez les sous-totaux Z en double. Si la catégorie Z a été posée par erreur, corrigez plutôt la ligne, la remise ou les frais concernés. Vérifiez votre facture dans le bac à sable gratuit."
canonical: https://validationfacture.fr/codes/br-z-01
---

# BR-Z-01 : catégorie Z utilisée sans sous-total Z dans la ventilation

## L'essentiel sur BR-Z-01

- **Ce qui est signalé** : catégorie Z utilisée sans sous-total Z dans la ventilation
- **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** : Ajoutez un seul sous-total de catégorie Z avec sa base imposable (BT-116) et un montant de TVA (BT-117) à 0.00, ou fusionnez les sous-totaux Z en double. Si la catégorie Z a été posée par erreur, corrigez plutôt la ligne, la remise ou les frais concernés.

Dès qu'une ligne (BG-25), une remise de document (BG-20) ou des frais de document (BG-21) portent la catégorie de TVA Z (BT-151, BT-95 ou BT-102), BR-Z-01 demande que la ventilation de TVA (BG-23) contienne exactement une entrée dont le code BT-118 vaut Z. En CII, cette entrée est un bloc ram:ApplicableTradeTax de ram:ApplicableHeaderTradeSettlement ; en UBL, un cac:TaxSubtotal de cac:TaxTotal. L'absence de cette entrée déclenche la règle, tout comme sa répétition.

## Ce que renvoie l'API

- **Code** : `BR-Z-01` (`BRZ01`)
- **Champ concerné** : `vat_breakdown`
- **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
- **Valeur attendue** : `Z`
- **Réparation automatique** : Non — la correction demande un arbitrage humain.
- **Version du référentiel** : `2026.08.1`

## Comment corriger

Ajoutez un seul sous-total de catégorie Z avec sa base imposable (BT-116) et un montant de TVA (BT-117) à 0.00, ou fusionnez les sous-totaux Z en double. Si la catégorie Z a été posée par erreur, corrigez plutôt la ligne, la remise ou les frais concernés.

**Si vous ne corrigez pas :** Sans ce sous-total unique, la facture est rejetée au contrôle Schematron EN 16931.

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-Z-02](/codes/br-z-02.md), [BR-Z-03](/codes/br-z-03.md), [BR-Z-04](/codes/br-z-04.md), [BR-Z-05](/codes/br-z-05.md), [BR-Z-06](/codes/br-z-06.md), [BR-Z-07](/codes/br-z-07.md), [BR-Z-08](/codes/br-z-08.md), [BR-Z-09](/codes/br-z-09.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.
