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