Aller au contenu
Lekteo

Le fichier UBL : à quoi il ressemble et comment le lire

UBL est un format de facture entièrement en XML : pas de page, pas de mise en forme, rien qui s’affiche tout seul. Voici ce que contient le fichier et comment en tirer une facture lisible.

Ce qu’est un fichier UBL

UBL signifie Universal Business Language. C’est un standard publié par l’organisme OASIS pour décrire les documents commerciaux — commandes, bons de livraison, factures — sous une forme que les logiciels peuvent échanger sans se parler à l’avance. La version retenue par le socle français est UBL 2.1.

Un fichier UBL est un document XML : du texte brut, organisé par des balises imbriquées. Il commence par <Invoice> pour une facture, ou par <CreditNote> pour un avoir. C’est le repère le plus simple pour savoir ce que vous tenez.

Comme les deux autres formats du socle, UBL est conforme à la norme européenne EN 16931 : il exprime les mêmes informations que CII ou Factur-X, avec un vocabulaire différent.

Pourquoi il n’a aucun rendu visuel

Un PDF décrit une page : des polices, des positions, des traits. Un fichier UBL ne décrit rien de tel. Il ne contient ni logo, ni couleur, ni cadre, ni ordre d’affichage. Il ne dit pas comment présenter la facture, il dit ce que vaut chaque information.

C’est un choix, pas un oubli. La même facture doit pouvoir être intégrée automatiquement par n’importe quel logiciel comptable, en France comme ailleurs en Europe. Une mise en page rendrait le fichier plus agréable pour vous et beaucoup moins exploitable pour la machine.

Concrètement, ouvrir un UBL dans un navigateur affiche un arbre de balises repliables ; dans un éditeur de texte, une longue suite de lignes. Dans les deux cas, l’information est là, mais il faut la chercher à la main.

À quoi ressemble le contenu

Les noms de balises suivent deux familles : cbc: pour les valeurs simples, cac: pour les blocs qui en regroupent plusieurs. Les préfixes eux-mêmes sont libres — un émetteur peut en choisir d’autres — seul le nom qui suit compte vraiment.

Les montants sont écrits à l’informatique : point décimal, aucun séparateur de milliers, devise indiquée en attribut. 1234.50 se lit donc 1 234,50 €.

Comment lire un fichier UBL

  1. Déposez le fichier .xml sur la zone de dépôt.
  2. La syntaxe est reconnue automatiquement à partir de la première balise.
  3. La facture s’affiche remise en forme : parties, lignes, ventilation de TVA, totaux, règlement.
  4. Les constats de contrôle apparaissent ensuite, en français, avec les montants concernés.

Un fichier UBL peut aussi déclarer un profil plus précis, par exemple Peppol BIS Billing 3.0 ou XRechnung. Ce profil est affiché tel quel : il indique quelle variante de la norme l’émetteur affirme respecter. Le comparatif des formats replace ces profils dans l’ensemble.

Ce que le fichier ne vous dira pas de lui-même

Un UBL peut être parfaitement bien formé et pourtant faux. Le XML garantit la structure, pas la justesse : un IBAN dont un chiffre a sauté, un SIREN qui ne passe pas sa clé, une TVA qui ne correspond pas à sa base ou une échéance antérieure à l’émission produisent un fichier techniquement valide et comptablement inutilisable.

C’est précisément ce que les règles BR-xx de EN 16931 servent à détecter, et ce que Lekteo vérifie à chaque lecture. Si vous découvrez ces fichiers parce qu’ils viennent d’apparaître dans votre boîte, voyez ouvrir un fichier XML de facture et la page obligations 2026.

Questions fréquentes

Pourquoi mon fichier UBL s’ouvre-t-il dans le navigateur sans rien afficher de lisible ?

Parce que le navigateur fait exactement ce qu’on lui demande : afficher un document XML. Il montre l’arbre des balises, faute de savoir qu’il s’agit d’une facture. Il lui manque la couche qui donne un sens à chaque balise et qui remet le tout en forme.

Les balises de mon fichier n’ont pas de préfixe cbc: ou cac:. Est-ce grave ?

Non, c’est même fréquent. Les préfixes d’espaces de noms sont choisis librement par l’émetteur, et certains n’en mettent aucun. Seul le nom local de la balise compte : un fichier sans préfixe se lit exactement comme un autre.

Quelle différence entre UBL et Factur-X ?

UBL est une syntaxe XML complète, sans page imprimable. Factur-X est un PDF qui transporte un XML en pièce jointe, écrit lui dans la syntaxe CII. Les deux expriment la même norme, mais un UBL ne s’affiche jamais tout seul, contrairement à un Factur-X.

Puis-je transformer un UBL en document imprimable pour mon classeur ?

Vous pouvez imprimer la facture une fois qu’elle est remise en forme, et exporter les données en JSON ou en CSV pour votre outil de saisie. Conservez toutefois le fichier XML reçu : une impression n’en est qu’une représentation.