EXEMPLE PRATIQUE · UBL 2.1

Exemple de facture UBL XML.

Comprendre les données d’une facture structurée et les retrouver dans un fichier UBL 2.1.

Une facture UBL est un fichier XML organisé en éléments normalisés. Voici un extrait illustratif : il montre quelques champs courants, mais ne constitue pas une facture complète et ne doit pas être utilisé comme modèle conforme.

<!-- Extrait illustratif, pas un document complet -->
<cbc:ID>FAC-001</cbc:ID>
<cbc:IssueDate>2026-10-27</cbc:IssueDate>
<cbc:DocumentCurrencyCode>MAD</cbc:DocumentCurrencyCode>
<cac:TaxTotal>
  <cbc:TaxAmount currencyID="MAD">200.00</cbc:TaxAmount>
</cac:TaxTotal>

Les principaux champs d’une facture UBL

cbc:ID: Numéro de la facture.
cbc:IssueDate: Date d’émission, au format AAAA-MM-JJ.
cbc:DocumentCurrencyCode: Devise de la facture, par exemple MAD.
cac:AccountingSupplierParty: Informations du vendeur ou fournisseur.
cac:AccountingCustomerParty: Informations du client.
cac:InvoiceLine: Une ligne de facture : article, quantité, montant et prix.
cac:TaxTotal: Montant de taxe et, selon le document, détail par taux.
cac:LegalMonetaryTotal: Totaux et montant à payer.

Les préfixes cbc et cac désignent des espaces de noms XML. Leur orthographe visible peut varier si les espaces de noms sont correctement déclarés. La spécification OASIS UBL 2.1 décrit les structures complètes.

Créer et lire un exemple avec UBL.ma

Pour obtenir un fichier complet à explorer, ouvrez le créateur gratuit, entrez des données fictives, puis téléchargez le XML. Vous pouvez ensuite le réimporter dans « Lire un UBL » pour voir les informations principales. Ne partagez pas de données réelles lorsque vous faites un essai.

UBL.ma crée un XML UBL 2.1 standard et affiche un aperçu des factures UBL. L’outil ne vérifie pas le schéma XSD ou les signatures, ne transmet pas à la DGI et ne certifie pas la conformité fiscale. Les champs ICE, IF et TP sont identifiés de façon indicative ; leur correspondance avec un éventuel profil marocain officiel doit être vérifiée.

UBL, XML et PDF : que conserver ?

Le XML conserve des données structurées ; le PDF représente une page lisible. L’aperçu d’UBL.ma peut être imprimé ou enregistré en PDF, mais il ne reprend pas tous les champs du fichier. Gardez donc l’original XML pour préserver les informations qu’il contient.

Pour le contexte marocain et les étapes de lecture et de création, consultez le guide du format UBL au Maroc. Pour suivre les annonces, consultez nos actualités sur la facturation électronique.