BR-23
Quantité facturée sans unité
Une ligne de facture (BG-25) doit avoir un code d'unité de mesure de la quantité facturée (BT-130).
Pourquoi cette erreur apparaît
La quantité est exportée seule, sans l'attribut unitCode, souvent parce que l'unité n'est pas renseignée sur l'article.
Où regarder
BT-130 — SpecifiedLineTradeDelivery/BilledQuantity/@unitCode (CII) ou cbc:InvoicedQuantity/@unitCode (UBL)
Correction
Ajouter l'attribut unitCode avec un code de la liste UN/ECE Recommandation 20 (par exemple C62 pour une unité, HUR pour une heure, DAY pour un jour, MON pour un mois).
Exemple vérifié contre l'API
Facture de démonstration dont un seul fragment a été altéré, envoyée le 7 novembre 2026 à POST /api/v1/validate de l'API de test (staging) : elle l'a refusée avec la règle BR-23.
Fragment refusé
<ram:BilledQuantity>2</ram:BilledQuantity> Fragment corrigé
<ram:BilledQuantity unitCode="MON">2</ram:BilledQuantity> Réponse de l'API pour ce fichier
- Règle
BR-23(error)- Message
- [BR-23]-An Invoice line (BG-25) shall have an Invoiced quantity unit of measure code (BT-130).
- Emplacement
- /CrossIndustryInvoice[1]/SupplyChainTradeTransaction[1]/IncludedSupplyChainTradeLineItem[2]
Avec le fragment corrigé, le même fichier est accepté sans erreur.
Rejouer ce cas dans votre chaîne
Télécharger le fichier invalide (br-23-invalide.xml)curl -X POST https://api.facturxapi.com/api/v1/validate \
-H "X-API-Key: $FACTURX_API_KEY" \
-F "[email protected]" Bonnes pratiques
- Rendre l'unité obligatoire sur la fiche article et la mapper vers un code UN/ECE
- Un code présent mais hors liste est un autre contrôle (liste de codes), pas BR-23
Et après ?
Passer à l'action
Choisissez l'étape suivante pour activer FacturX API sur votre stack.
Contrat des champs
Rechercher un champ par code BT/BG, règle ou XPath CII.
Tester votre fichier
Déposez votre fichier : vous voyez les contrôles qui échouent et leur emplacement. Contrôle technique du fichier, pas une décision d'une plateforme agréée.
Corriger avec l’API
Clé API gratuite : POST /api/v1/validate renvoie le code et l'emplacement ; corrigez la donnée source, puis renvoyez le fichier.