Aide-mémoire développeur · BT-130 (@unitCode) · UN/ECE Rec 20
Table de correspondance immédiate : unité ERP française → code UN/ECE Rec 20 valide (Factur-X & UBL)
| Unité métier courante | Valeurs rejetées (BR-CL-23) | Code officiel BT-130 | Exemple CII (Factur-X EN 16931) |
|---|---|---|---|
| Unité / Forfait / Prestation | U, UNITE, FORFAIT, PCE | C62 (ou H87 pièce) | <ram:BilledQuantity unitCode="C62">1.0000</ram:BilledQuantity> |
| Heure de prestation | H, HR, HEURE | HUR | <ram:BilledQuantity unitCode="HUR">7.5000</ram:BilledQuantity> |
| Jour / TJM consultant | J, JR, JOUR, HJ | DAY | <ram:BilledQuantity unitCode="DAY">5.0000</ram:BilledQuantity> |
| Mois / Abonnement mensuel | M, MOIS, MENS | MON (ANN pour an) | <ram:BilledQuantity unitCode="MON">12.0000</ram:BilledQuantity> |
| Poids / Longueur / Surface / Volume | KG, M, M2, L | KGM · 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/@unitCodesur une facture,cbc:CreditedQuantity/@unitCodesur 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
C62sur la ligne. C'est un défaut raisonnable pour un article à l'unité, mais une ligne facturée à l'heure ou au jour doit recevoirHURouDAYà 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.