BR-21
Identifiant de ligne vide
Chaque ligne de facture (BG-25) doit avoir un identifiant de ligne (BT-126).
Pourquoi cette erreur apparaît
Le numéro de ligne est calculé à l'affichage mais pas écrit dans le XML, ou la ligne est exportée avec un identifiant vide.
Où regarder
BT-126 — IncludedSupplyChainTradeLineItem/AssociatedDocumentLineDocument/LineID (CII) ou cac:InvoiceLine/cbc:ID (UBL)
Correction
Écrire un identifiant non vide pour chaque ligne, par exemple son rang (1, 2, 3…).
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-21.
Fragment refusé
<ram:LineID></ram:LineID> Fragment corrigé
<ram:LineID>1</ram:LineID> Réponse de l'API pour ce fichier
- Règle
BR-21(error)- Message
- [BR-21]-Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
- Emplacement
- /CrossIndustryInvoice[1]/SupplyChainTradeTransaction[1]/IncludedSupplyChainTradeLineItem[1]
Avec le fragment corrigé, le même fichier est accepté sans erreur.
Ce fichier déclenche aussi PEPPOL-EN16931-R008.
Rejouer ce cas dans votre chaîne
Télécharger le fichier invalide (br-21-invalide.xml)curl -X POST https://api.facturxapi.com/api/v1/validate \
-H "X-API-Key: $FACTURX_API_KEY" \
-F "[email protected]" Bonnes pratiques
- Numéroter les lignes au moment de l'export, pas seulement à l'affichage
- Sur ce fichier, l'API renvoie aussi PEPPOL-EN16931-R008 (élément vide) pour le même champ
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.