Norme EN 16931 · Code BR-22 (BR22)
BR-22 : quantité facturée absente sur une ligne (BT-129)
bloquantBT-129
Signification de BR-22 (BR22) et correctif
- Ce qui est signalé : quantité facturée absente sur une ligne (BT-129) (terme
BT-129 (Quantité facturée)) - Élément CII (Factur-X) :
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity - Élément UBL 2.1 :
/ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity - Ce qu'il faut changer : Renseignez lines[].quantity sur chaque ligne ; pour un forfait, indiquez 1 avec l'unité C62. La quantité doit venir de vos données de vente : elle ne se déduit pas du reste.
<!-- Le document qui déclenche BR-22 -->
<ram:BilledQuantity>valeur absente ou fautive</ram:BilledQuantity>
<!-- Le même élément une fois corrigé -->
<ram:BilledQuantity>valeur attendue par la règle</ram:BilledQuantity>Vérifier ma facture dans le bac à sable API & lots dès 0,10 €
BR-22 exige sur chaque ligne la quantité facturée, BT-129 : ram:BilledQuantity sous SpecifiedLineTradeDelivery en CII, cbc:InvoicedQuantity en UBL. Elle va de pair avec son unité de mesure (BT-130), elle-même rendue obligatoire par BR-23. Sans quantité, le montant net de la ligne ne peut pas être rapproché du prix.
Fiche technique de BR-22
- Code
BR-22(parfois écritBR22)- Champ du modèle JSON
lines[0].quantity- Terme EN 16931
BT-129, Quantité facturée- XPath CII (Factur-X)
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity- XPath UBL 2.1
/ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity- Gravité
- Erreur bloquante
- Référentiel
- EN 16931
- Réparation automatique
- Non — la correction demande un arbitrage humain.
- Version du référentiel
2026.08.1
Corriger BR-22
Renseignez lines[].quantity sur chaque ligne ; pour un forfait, indiquez 1 avec l'unité C62. La quantité doit venir de vos données de vente : elle ne se déduit pas du reste.
Si vous ne corrigez pas : La facture échoue à la validation EN 16931 tant qu'une ligne reste sans quantité.
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.
Extraits XML & prompt de correction ERP prêts à copier (BR-22)
Copiez l'extrait conforme au format de votre facture électronique ou le prompt de correction pour votre générateur ERP / Factur-X (échéance réforme 1er septembre 2026).
<!-- Correctif Factur-X (CII EN 16931) pour BR-22 · BT-129 -->
<!-- XPath : /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity -->
<ram:SpecifiedLineTradeDelivery>
<!-- Rejeté (BR-22) : <ram:BilledQuantity>valeur absente ou fautive</ram:BilledQuantity> -->
<ram:BilledQuantity>valeur attendue par la règle</ram:BilledQuantity>
</ram:SpecifiedLineTradeDelivery><!-- Correctif UBL 2.1 (Chorus Pro / Peppol) pour BR-22 · BT-129 -->
<!-- XPath : /ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity -->
<cac:InvoiceLine>
<cbc:InvoicedQuantity>valeur conforme EN 16931</cbc:InvoicedQuantity>
</cac:InvoiceLine>Corrige le générateur de facture électronique pour éliminer l'anomalie BR-22 (Norme EN 16931, gravité : erreur bloquante).
- Champ du modèle : lines[0].quantity / terme EN 16931 : BT-129 (Quantité facturée)
- XPath Factur-X (CII) : /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity
- XPath UBL 2.1 : /ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity
- Règle contrôlée : BR-22 exige sur chaque ligne la quantité facturée, BT-129 : ram:BilledQuantity sous SpecifiedLineTradeDelivery en CII, cbc:InvoicedQuantity en UBL. Elle va de pair avec son unité de mesure (BT-130), elle-même rendue obligatoire par BR-23. Sans quantité, le montant net de la ligne ne peut pas être rapproché du prix.
- Correction attendue : Renseignez lines[].quantity sur chaque ligne ; pour un forfait, indiquez 1 avec l'unité C62. La quantité doit venir de vos données de vente : elle ne se déduit pas du reste.
Ajoute un test unitaire qui vérifie que /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity respecte BR-22.Tester ma facture corrigée dans le bac à sable Automatiser en CI/CD ou avant envoi PDP (API) Plans Starter & Pro (dès 49 € HT/mois)
Votre facture déclenche BR-22 ? Chargez-la dans le bac à sable : le contrôle vous dit si ce code sort sur votre document, avec le champ en cause et la valeur attendue. Sans compte et sans clé.
BR-22 en trois questions
Quelle est la signification de la règle BR-22 (BR22) ?
Signification de BR-22 (BR22) : BR-22 exige sur chaque ligne la quantité facturée, BT-129 : ram:BilledQuantity sous SpecifiedLineTradeDelivery en CII, cbc:InvoicedQuantity en UBL. Elle va de pair avec son unité de mesure (BT-130), elle-même rendue obligatoire par BR-23. Sans quantité, le montant net de la ligne ne peut pas être rapproché du prix. Le contrôle porte sur le champ lines[0].quantity, c'est-à-dire le terme BT-129 (Quantité facturée), et relève du référentiel Norme EN 16931. La facture échoue à la validation EN 16931 tant qu'une ligne reste sans quantité.
Où se trouve l'élément à corriger pour BR-22 ?
Dans un Factur-X ou tout fichier CII, l'élément visé est /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity. Dans une facture UBL 2.1, c'est /ubl:Invoice/cac:InvoiceLine/cbc:InvoicedQuantity. Renseignez lines[].quantity sur chaque ligne ; pour un forfait, indiquez 1 avec l'unité C62. La quantité doit venir de vos données de vente : elle ne se déduit pas du reste.
Comment vérifier que BR-22 a disparu ?
Chargez le PDF Factur-X ou le JSON corrigé sur https://validationfacture.fr/essai. Le bac à sable, gratuit et sans compte, refait les contrôles de l'API (Schematron officiels EN 16931 et Factur-X 1.09.2, règles françaises du service) et vous dit si BR-22 sort encore.
À rapprocher
Autres règles du même groupe
Contrôler une facture sur ce point
Le bac à sable applique ce contrôle à votre facture gratuitement, en ligne : chargez un Factur-X ou collez un JSON, le verdict est immédiat. En production, l'opération validate_invoice renvoie ce code, le champ en cause, la valeur attendue et la correction, pour 0,10 € par document (ou dès 49 € HT/mois avec 100 documents inclus en formule Starter).
Contrôler une facture Tarifs API (dès 0,10 €) Formule Starter (49 €/mois) Voir l'intégration Tous les codes