BR-38
Frais de document sans motif
Tout frais au niveau du document (BG-21) doit avoir un motif (BT-104) ou un code motif (BT-105).
Pourquoi cette erreur apparaît
Des frais globaux (port, emballage) sont exportés avec leur montant mais sans libellé ni code.
Où regarder
BT-104, BT-105 — SpecifiedTradeAllowanceCharge[ChargeIndicator=true]/Reason et ReasonCode (CII) ou cac:AllowanceCharge/cbc:AllowanceChargeReason et cbc:AllowanceChargeReasonCode (UBL)
Correction
Ajouter Reason (libellé libre, par exemple « Frais de port ») ou ReasonCode (code de la liste UNTDID 7161), ou les deux.
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-38.
Fragment refusé
<ram:CategoryCode>S</ram:CategoryCode>
<ram:RateApplicablePercent>20</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>
<ram:SpecifiedTradeAllowanceCharge><ram:ChargeIndicator><udt:Indicator>true</udt:Indicator></ram:ChargeIndicator><ram:ActualAmount>0.00</ram:ActualAmount><ram:CategoryTradeTax><ram:TypeCode>VAT</ram:TypeCode><ram:CategoryCode>S</ram:CategoryCode><ram:RateApplicablePercent>20</ram:RateApplicablePercent></ram:CategoryTradeTax></ram:SpecifiedTradeAllowanceCharge>
<ram:SpecifiedTradePaymentTerms> Fragment corrigé
<ram:CategoryCode>S</ram:CategoryCode>
<ram:RateApplicablePercent>20</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>
<ram:SpecifiedTradePaymentTerms> Réponse de l'API pour ce fichier
- Règle
BR-38(error)- Message
- [BR-38]-Each Document level charge (BG-21) shall have a Document level charge reason (BT-104) or a Document level charge reason code (BT-105).
- Emplacement
- /CrossIndustryInvoice[1]/SupplyChainTradeTransaction[1]/ApplicableHeaderTradeSettlement[1]/SpecifiedTradeAllowanceCharge[1]/ChargeIndicator[1]
Avec le fragment corrigé, le même fichier est accepté sans erreur.
Ce fichier déclenche aussi BR-CO-12, BR-CO-22.
Rejouer ce cas dans votre chaîne
Télécharger le fichier invalide (br-38-invalide.xml)curl -X POST https://api.facturxapi.com/api/v1/validate \
-H "X-API-Key: $FACTURX_API_KEY" \
-F "[email protected]" Bonnes pratiques
- Sur ce fichier, le total des frais (BT-108) n'est pas déclaré : l'API renvoie aussi BR-CO-12
- Les remises de document (BG-20) ont la même exigence sous BR-33
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.