Aller au contenu
FactureLisible

Lire une facture UBL

Un fichier UBL est une facture écrite en XML : parfaitement claire pour un logiciel, illisible pour vous. Déposez-le, il redevient une facture.

Votre fichier reste sur votre ordinateur. Il est lu par votre navigateur, jamais envoyé sur un serveur — vous pouvez même couper votre connexion après le chargement de la page.

UBL, le format XML des factures structurées

UBL — Universal Business Language — est un standard ouvert publié par OASIS et repris par la norme européenne EN 16931. Une facture UBL est un fichier texte dont la racine s'appelle Invoice pour une facture, ou CreditNote pour un avoir. Tout y est balisé : l'émetteur dans AccountingSupplierParty, le destinataire dans AccountingCustomerParty, chaque prestation dans un InvoiceLine.

C'est rigoureux, c'est interopérable, et c'est parfaitement indéchiffrable pour qui reçoit le fichier sans logiciel adapté. Ouvert dans un navigateur, un UBL affiche un arbre de balises ; ouvert dans un tableur, il produit des colonnes absurdes ; ouvert dans un traitement de texte, du code brut. Aucune de ces manipulations ne vous dit ce que vous devez payer, ni à qui.

Le visualiseur remet chaque donnée à sa place : identités et numéros d'identification, détail des lignes avec quantités et unités, ventilation de la TVA par taux, totaux, coordonnées bancaires et conditions de règlement. Les champs absents du fichier sont affichés comme absents — jamais remplacés par une valeur plausible.

Factures et avoirs

Invoice comme CreditNote, avec le type de document correctement interprété : facture, avoir, acompte, rectificative.

Remises et frais

Les AllowanceCharge globaux et de ligne sont distingués, pour que le total des lignes et le total après remise ne soient pas confondus.

Prix aux multiples

Un tarif exprimé « aux cent » est ramené au prix unitaire réel, afin que quantité × prix unitaire retombe bien sur le total de ligne affiché.

Questions fréquentes sur UBL

Comment reconnaître une facture UBL ?

Ouvrez le fichier dans un éditeur de texte et regardez la première balise après la déclaration XML. Si elle s'appelle Invoice ou CreditNote et que les balises suivantes commencent par cbc: et cac:, c'est de l'UBL. Si la racine s'appelle CrossIndustryInvoice avec des balises ram:, c'est du CII — l'autre grande famille, celle qu'utilise Factur-X.

Quelle différence entre UBL et CII ?

Ce sont deux grammaires différentes pour dire la même chose. UBL vient du consortium OASIS et domine dans les marchés publics européens et de nombreux logiciels de facturation ; CII vient de l'UN/CEFACT et sert de socle à Factur-X. Les deux sont autorisés par la norme européenne EN 16931 et par la réforme française. Le contenu métier — émetteur, lignes, TVA, totaux — est équivalent.

Pourquoi les préfixes de balises changent d'un fichier à l'autre ?

Parce qu'un préfixe XML est arbitraire : seul l'espace de noms qu'il désigne compte. Un logiciel peut écrire cbc:ID, un autre ns2:ID, un troisième ID tout court. C'est une source classique de bugs dans les outils de lecture. FactureLisible identifie les balises par leur nom réel et non par leur préfixe, et lit donc indifféremment les trois écritures.

Un avoir UBL est-il lisible ici ?

Oui. Les avoirs utilisent la racine CreditNote au lieu de Invoice, et le type de document 381 au lieu de 380. Ils sont reconnus et affichés comme tels. À noter : dans UBL, les montants d'un avoir restent positifs, c'est le type de document qui porte le sens.

FactureLisible est un visualiseur, pas un validateur. Il affiche le contenu de votre fichier tel qu'il est écrit et signale les mentions qu'il n'y trouve pas. Il ne délivre aucune attestation de conformité, ne remplace pas une Plateforme Agréée et n'effectue aucune transmission à l'administration. Le fichier d'origine fait foi et reste la facture officielle : conservez-le tel quel.