Unités de mesure Factur-X (BT-130) : codes UN/ECE Rec 20 C62, HUR, DAY et erreur BR-CL-23

Publié le

Table de correspondance immédiate : unité ERP française → code UN/ECE Rec 20 valide (Factur-X & UBL)

Unité métier couranteValeurs rejetées (BR-CL-23)Code officiel BT-130Exemple CII (Factur-X EN 16931)
Unité / Forfait / PrestationU, UNITE, FORFAIT, PCEC62 (ou H87 pièce)<ram:BilledQuantity unitCode="C62">1.0000</ram:BilledQuantity>
Heure de prestationH, HR, HEUREHUR<ram:BilledQuantity unitCode="HUR">7.5000</ram:BilledQuantity>
Jour / TJM consultantJ, JR, JOUR, HJDAY<ram:BilledQuantity unitCode="DAY">5.0000</ram:BilledQuantity>
Mois / Abonnement mensuelM, MOIS, MENSMON (ANN pour an)<ram:BilledQuantity unitCode="MON">12.0000</ram:BilledQuantity>
Poids / Longueur / Surface / VolumeKG, M, M2, LKGM · MTR · MTK · LTR<ram:BilledQuantity unitCode="KGM">25.0000</ram:BilledQuantity>

Tester mes codes BT-130 dans le bac à sableRègle BR-DEC-23 (décimales)Règle BR-CO-26 (identifiants)Norme EN 16931 expliquée

Dans un logiciel de facturation, l'unité d'une ligne est souvent un libellé libre : « U », « H », « JOUR », « FORFAIT ». Une facture électronique n'accepte pas ces libellés. Le terme BT-130 porte un code tiré de la recommandation n° 20 de la CEE-ONU (UN/ECE Rec 20), complétée par les codes d'emballage de la Rec 21, et le Schematron EN 16931 vérifie que le code fait partie de cette liste.

Où se trouve BT-130

BT-130 n'est pas un élément mais un attribut, @unitCode, posé sur la quantité facturée BT-129 :

  • en CII (Factur-X) : ram:SpecifiedLineTradeDelivery/ram:BilledQuantity/@unitCode ;
  • en UBL : cbc:InvoicedQuantity/@unitCode sur une facture, cbc:CreditedQuantity/@unitCode sur un avoir.

Trois règles l'entourent :

Règle Ce qu'elle vérifie
BR-22 chaque ligne a une quantité facturée (BT-129)
BR-23 cette quantité porte un code unité (BT-130)
BR-CL-23 le code appartient à la liste Rec 20, extension Rec 21 comprise

BR-CL-23 ne regarde pas seulement la quantité facturée : elle contrôle aussi l'attribut @unitCode de la quantité de base du prix (ram:BasisQuantity en CII, cbc:BaseQuantity en UBL).

Les codes à connaître

La liste officielle compte plus de deux mille codes. Pour une facture française courante, une vingtaine suffit :

Ce que dit votre logiciel Code @unitCode Signification
unité, pièce sans précision C62 unité (« one »)
pièce H87 pièce
nombre d'articles NAR nombre d'articles
forfait LS montant forfaitaire (« lump sum »)
unité de service E48 unité de service
lot, ensemble SET ensemble
minute MIN minute
heure HUR heure
jour, journée facturée au TJM DAY jour
semaine WEE semaine
mois, abonnement mensuel MON mois
année ANN année
gramme GRM gramme
kilogramme KGM kilogramme
tonne TNE tonne
mètre, mètre linéaire MTR mètre
mètre carré MTK mètre carré
mètre cube MTQ mètre cube
litre LTR litre
kilomètre KMT kilomètre
kilowattheure KWH kilowattheure
pourcentage P1 pour cent

Les libellés maison comme U, UN, PCE, H, HR, J, JOUR, KG, KM, M2 ou FORFAIT ne figurent pas dans la liste : ils font échouer BR-CL-23.

Le piège des codes qui passent

Une poignée d'abréviations françaises existent par hasard dans la Rec 20 avec un tout autre sens. L'exemple le plus parlant : PAL, que beaucoup d'ERP utilisent pour « palette », est un code valide… qui désigne le pascal. La facture passe le Schematron, mais elle facture des unités de pression. Un contrôle de liste ne voit pas ce genre d'erreur ; seule une table de correspondance relue par quelqu'un du métier l'évite.

Même prudence avec les codes qui se ressemblent : MON est le mois, alors qu'un M isolé n'existe pas dans la liste et échoue.

Quantité de base du prix et unité facturée

Un prix peut s'exprimer pour une quantité de base (BT-149, avec son unité BT-150) : un tarif « pour 100 kg », par exemple. Le Schematron EN 16931 ne compare pas BT-150 à BT-130, mais il contrôle les deux codes avec BR-CL-23. Garder la même unité des deux côtés reste la façon la plus sûre de produire un montant de ligne que le destinataire peut recalculer : avec un prix exprimé par jour et une quantité en jours, BT-131 vaut simplement quantité × prix.

Exemple : une ligne au TJM

Cinq jours de prestation à 850 € HT le jour. Le prix est exprimé pour une quantité de base d'un jour, la quantité facturée est de cinq jours.

<ram:IncludedSupplyChainTradeLineItem>
  <ram:AssociatedDocumentLineDocument>
    <ram:LineID>1</ram:LineID>
  </ram:AssociatedDocumentLineDocument>
  <ram:SpecifiedTradeProduct>
    <ram:Name>Intégration API Factur-X</ram:Name>
  </ram:SpecifiedTradeProduct>
  <ram:SpecifiedLineTradeAgreement>
    <ram:NetPriceProductTradePrice>
      <!-- BT-146 : prix net unitaire, jamais négatif (BR-27) -->
      <ram:ChargeAmount>850.00</ram:ChargeAmount>
      <!-- BT-149 et BT-150 : prix exprimé pour 1 jour -->
      <ram:BasisQuantity unitCode="DAY">1</ram:BasisQuantity>
    </ram:NetPriceProductTradePrice>
  </ram:SpecifiedLineTradeAgreement>
  <ram:SpecifiedLineTradeDelivery>
    <!-- BT-129 et BT-130 : 5 jours (BR-22, BR-23, BR-CL-23) -->
    <ram:BilledQuantity unitCode="DAY">5</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:TypeCode>VAT</ram:TypeCode>
      <ram:CategoryCode>S</ram:CategoryCode>
      <ram:RateApplicablePercent>20.00</ram:RateApplicablePercent>
    </ram:ApplicableTradeTax>
    <ram:SpecifiedTradeSettlementLineMonetarySummation>
      <!-- BT-131 : 5 × 850.00, deux décimales au plus (BR-DEC-23) -->
      <ram:LineTotalAmount>4250.00</ram:LineTotalAmount>
    </ram:SpecifiedTradeSettlementLineMonetarySummation>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>

La même ligne en UBL :

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <!-- BT-129 et BT-130 ; sur un avoir, cbc:CreditedQuantity -->
  <cbc:InvoicedQuantity unitCode="DAY">5</cbc:InvoicedQuantity>
  <cbc:LineExtensionAmount currencyID="EUR">4250.00</cbc:LineExtensionAmount>
  <cac:Item>
    <cbc:Name>Intégration API Factur-X</cbc:Name>
    <cac:ClassifiedTaxCategory>
      <cbc:ID>S</cbc:ID>
      <cbc:Percent>20.00</cbc:Percent>
      <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
    </cac:ClassifiedTaxCategory>
  </cac:Item>
  <cac:Price>
    <cbc:PriceAmount currencyID="EUR">850.00</cbc:PriceAmount>
    <!-- Contrôlée elle aussi par BR-CL-23 -->
    <cbc:BaseQuantity unitCode="DAY">1</cbc:BaseQuantity>
  </cac:Price>
</cac:InvoiceLine>

Corriger une facture existante

Les deux règles ne se traitent pas de la même façon :

  • BR-23 (unité absente) : la réparation automatique pose C62 sur la ligne. C'est un défaut raisonnable pour un article à l'unité, mais une ligne facturée à l'heure ou au jour doit recevoir HUR ou DAY à la source.
  • BR-CL-23 (code inconnu) : pas de correction automatique. Le moteur ne peut pas savoir si votre « J » voulait dire jour ou joule ; la correspondance se décide dans votre logiciel, une fois pour toutes.

Pour voir quelles lignes posent problème, déposez une facture dans le bac à sable : il est gratuit, sans compte, et indique pour chaque écart la ligne et la valeur relevée. En production, validate_invoice (0,10 €) fait le même contrôle et repair_invoice (0,50 €) applique les corrections possibles ; les détails sont sur la page intégration.

Contrôler une facture Factur-X ou XML contre EN 16931

Le bac à sable applique en direct les Schematron officiels EN 16931, Factur-X 1.09.2 et les règles françaises de la réforme : chargez un PDF Factur-X ou collez un JSON, le diagnostic est immédiat et sans compte. En production, l'API REST et le serveur MCP valident, réparent ou convertissent vos factures dès 0,10 € par document (ou dès 49 € HT/mois avec 100 documents inclus en formule Starter).

Tester une facture gratuitementTarifs API (dès 0,10 €)Formule Starter (49 €/mois)Codes d'anomalie BR- & FR-Codes de rejet PPF & PDP