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