Format UBL : comprendre le fichier et vérifier sa compatibilité

UBL, pour Universal Business Language, est un standard de documents structurés en XML, utilisé notamment pour les factures. Dans une facture UBL, l’identité des parties, les lignes, la TVA et les totaux occupent des champs que les logiciels peuvent traiter. Le nom du format ne garantit cependant pas, à lui seul, que le fichier sera accepté dans votre circuit.

Ce guide pratique vous aide à poser les bonnes questions à votre prestataire et à contrôler un exemple. Pour comparer le document XML avec le format hybride PDF et XML, consultez le guide Factur-X et sa comparaison avec UBL et CII.

UBL, EN 16931 et Peppol : quel rôle pour chacun ?

UBL définit une syntaxe et des documents métier ; la documentation OASIS UBL 2.1 en décrit la structure. Une version doit être identifiée précisément : « XML » désigne une famille de technologies, pas une configuration complète de facture électronique.

Par exemple, la documentation Peppol BIS Billing 3.0 utilise les schémas UBL Invoice 2.1 et CreditNote 2.1 et ajoute des règles de validation. Cela ne signifie pas qu’UBL 2.1 est la dernière version de tout le standard, ni que tout fichier UBL respecte automatiquement Peppol BIS Billing.

Pour le dispositif français, faites préciser les profils et exigences issus des normes référencées par la DGFiP. Un fichier accepté dans un autre contexte doit encore être examiné pour vos opérations, vos données et votre raccordement en France.

Quels champs retrouve-t-on dans une facture UBL ?

Le tableau donne quelques repères issus de la syntaxe UBL Invoice de Peppol. Ce n’est pas un modèle de facture complet à copier ; les champs obligatoires, conditionnels et les codes dépendent des règles applicables.

Demandez au prestataire une lecture exploitable des données de votre fichier. Vous pouvez ainsi vérifier le client et les montants sans apprendre à écrire du XML. Une interface de lecture peut présenter les informations sous forme de facture ; le format structuré n’interdit pas la consultation humaine.

UBL permet-il de joindre un justificatif ?

Oui. Dans Peppol BIS Billing, le groupe AdditionalDocumentReference permet de référencer des justificatifs, notamment par numéro, par lien externe ou comme document embarqué encodé en Base64. Affirmer que le format ne permet aucune pièce jointe serait donc incorrect.

Testez toutefois le service effectivement disponible. Une possibilité dans la spécification ne prouve pas que votre interface permet de déposer n’importe quel fichier, ni que le destinataire pourra ouvrir tous les liens externes.

Exemple de test : une prestation est accompagnée d’un relevé d’heures. Vérifiez que sa référence est correcte, que le fichier ou le lien est accessible côté réception et qu’il correspond à la prestation facturée. Demandez également les limites de taille et les types de fichiers admis par le service.

Dans quels cas examiner l’usage d’UBL ?

Partez des échanges réels de votre entreprise. Trois situations justifient une discussion avec le prestataire :

• Un client demande une facture conforme à une spécification fondée sur UBL : obtenez le nom exact du profil et les conditions de réception.
• Votre système génère déjà des données structurées : contrôlez leur correspondance avec les champs de facture, les règles et le circuit visé.
• Vous échangez via un service utilisant Peppol BIS Billing : faites valider le document et tester son acheminement dans ce contexte.

L’international, à lui seul, n’impose pas systématiquement un format unique. À l’inverse, travailler uniquement en France ne permet pas de choisir sur le seul critère de la présentation visuelle. Le bon choix est celui qui couvre vos cas et les échanges exigés, avec un résultat vérifié.

Cinq contrôles avant de transmettre un fichier UBL

1. Identifier la configuration. Relevez la version, le profil, le destinataire et l’environnement de test convenu.
2. Vérifier les données métier. Comparez le client, les références, les lignes et les montants avec l’opération d’origine.
3. Obtenir le résultat de validation. Faites préciser les contrôles de structure, les règles métier et les exigences nationales couvertes. Conservez le rapport et les messages exacts.
4. Tester les compléments. Vérifiez les références de commande, justificatifs, remises et cas particuliers que vous utilisez réellement.
5. Suivre la réception. Contrôlez le retour du circuit, l’accès au document et la lecture des informations chez le destinataire.

Exemple fictif de contrôle métier : deux unités à 150 € HT représentent 300 € HT. Avec une TVA de 20 %, sans remise ni acompte, le total TTC attendu est de 360 €. Un fichier indiquant un autre total doit être examiné. Des calculs cohérents ne suffisent toutefois pas à prouver que le bon client a été facturé ou que le profil est respecté.

Conservez une fiche par cas testé : fichier original, résultat attendu, rapport de validation, référence de transmission et anomalie éventuelle. Après un changement d’outil ou de paramétrage, rejouez les cas concernés dans un environnement adapté.

Que demander si le fichier est valide mais l’envoi échoue ?

Séparez la validation du document de son acheminement. Relevez l’étape de blocage et transmettez au support le message exact avec la référence du fichier. Faites vérifier l’adressage, l’activation du service et les exigences du destinataire, sans modifier manuellement une facture émise pour contourner le contrôle.

Le guide du cycle de vie et des statuts permet ensuite de distinguer rejet technique, refus du client et encaissement. Pour vérifier l’ensemble du service proposé, utilisez aussi la grille de choix d’une plateforme agréée.

Informations vérifiées le 7 septembre 2026. Les exemples et conseils d’organisation sont pédagogiques ; les références officielles sont reliées aux passages concernés.