Facture électronique

Exemple de facture UBL commentée, balise par balise

Une facture de services en UBL 2.1, telle qu'un logiciel la produit. Chaque balise est rapprochée de son code BT et de son libellé dans la norme EN 16931.

Télécharger le fichier XML Valide XSD, EN 16931 et CTC-FR

Page de référence Cette page approfondit un point précis de la réforme. Le parcours complet, avec vos dates selon votre taille et votre plan d'action, est dans le guide de la facture électronique.

L'essentiel en 4 points

  • Un code BT par donnée : le même numéro en UBL et en CII, seule la balise change.
  • L'ordre est imposé : en-tête, vendeur, acheteur, paiement, TVA, totaux, puis les lignes.
  • Chaque montant porte sa devise : l'attribut currencyID est obligatoire.
  • Produire le fichier ne vaut pas transmission : une facture entre assujettis français transite par une Plateforme Agréée.

Sommaire

  1. La facture
  2. Le fichier, balise par balise
  3. Lire l'en-tête
  4. Vendeur et acheteur
  5. TVA et totaux
  6. Les lignes
  7. Correspondance UBL et CII
  8. Contrôler et produire
  9. Questions fréquentes
1

La facture

ATELIER EXEMPLE SAS (SIREN 100000009) facture deux prestations à CLIENT EXEMPLE SARL (SIREN 200000008). Les deux entreprises sont fictives. Facture n° EX-2026-001 du 01/10/2026, payable le 31/10/2026.

Ligne Quantité Prix unitaire TVA
Audit de la chaîne de facturation 2 DAY 650,00 € 20 %
Paramétrage du logiciel 6 HUR 90,00 € 20 %
Total hors TVA 1840,00 €
TVA 368,00 €
Total TTC 2208,00 €
2

Le fichier, balise par balise

Les codes BT désignent une donnée, les codes BG un groupe de données. Une balise sans code est un conteneur de la syntaxe, sans terme métier.

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"> Racine du document et espaces de noms
<cbc:CustomizationID>urn:cen.eu:en16931:2017</cbc:CustomizationID> BT-24 Identifiant de spécification
<cbc:ProfileID>S1</cbc:ProfileID> BT-23 Mode de facturation (flux CTC)
<cbc:ID>EX-2026-001</cbc:ID> BT-1 Numéro de facture
<cbc:IssueDate>2026-10-01</cbc:IssueDate> BT-2 Date d'émission
<cbc:DueDate>2026-10-31</cbc:DueDate> BT-9 Date d'échéance
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode> BT-3 Type de document (facture, avoir)
<cbc:Note>Exemple fictif publié par cabinetdigital.fr. Ne pas émettre ni comptabiliser.</cbc:Note> BT-22 Mention en note de facture
<cbc:Note>#PMD#Pénalités de retard : en cas de retard de paiement, application de pénalités au taux de trois fois le taux d'intérêt légal en vigueur (article L441-10 du code de commerce).</cbc:Note> BT-22 Mention en note de facture
<cbc:Note>#PMT#Frais de recouvrement : indemnité forfaitaire de 40 euros due en cas de retard de paiement (article D441-5 du code de commerce).</cbc:Note> BT-22 Mention en note de facture
<cbc:Note>#AAB#Escompte pour paiement anticipé : néant.</cbc:Note> BT-22 Mention en note de facture
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode> BT-5 Devise
<cac:OrderReference>
<cbc:ID>BC-4512</cbc:ID> BT-13 Référence du bon de commande
</cac:OrderReference>
<cac:AccountingSupplierParty> BG-4 Vendeur
<cac:Party>
<cbc:EndpointID schemeID="0002">100000009</cbc:EndpointID> BT-34 Adresse électronique du vendeur
<cac:PartyIdentification>
<cbc:ID schemeID="0002">100000009</cbc:ID> BT-29 Identifiant du vendeur
</cac:PartyIdentification>
<cac:PostalAddress> BG-5 Adresse postale du vendeur
<cbc:StreetName>12 rue des Exemples</cbc:StreetName> BT-35 Adresse du vendeur, ligne 1
<cbc:CityName>Paris</cbc:CityName> BT-37 Ville du vendeur
<cbc:PostalZone>75011</cbc:PostalZone> BT-38 Code postal du vendeur
<cac:Country>
<cbc:IdentificationCode>FR</cbc:IdentificationCode> BT-40 Pays du vendeur
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>FR88100000009</cbc:CompanyID> BT-31 Numéro de TVA du vendeur
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID> Régime de taxe : toujours VAT
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>ATELIER EXEMPLE SAS</cbc:RegistrationName> BT-27 Nom du vendeur
<cbc:CompanyID schemeID="0002">100000009</cbc:CompanyID> BT-30 Identifiant légal du vendeur
<cbc:CompanyLegalForm>SAS au capital de 10 000 EUR, RCS Paris 100 000 009</cbc:CompanyLegalForm> BT-33 Informations juridiques complémentaires du vendeur
</cac:PartyLegalEntity>
<cac:Contact> BG-6 Contact du vendeur
<cbc:ElectronicMail>[email protected]</cbc:ElectronicMail> BT-43 Adresse email du contact vendeur
</cac:Contact>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty> BG-7 Acheteur
<cac:Party>
<cbc:EndpointID schemeID="0002">200000008</cbc:EndpointID> BT-49 Adresse électronique de l'acheteur
<cac:PartyIdentification>
<cbc:ID schemeID="0002">200000008</cbc:ID> BT-46 Identifiant de l'acheteur
</cac:PartyIdentification>
<cac:PostalAddress> BG-8 Adresse postale de l'acheteur
<cbc:StreetName>8 avenue du Modèle</cbc:StreetName> BT-50 Adresse de l'acheteur, ligne 1
<cbc:CityName>Lyon</cbc:CityName> BT-52 Ville de l'acheteur
<cbc:PostalZone>69002</cbc:PostalZone> BT-53 Code postal de l'acheteur
<cac:Country>
<cbc:IdentificationCode>FR</cbc:IdentificationCode> BT-55 Pays de l'acheteur
</cac:Country>
</cac:PostalAddress>
<cac:PartyLegalEntity>
<cbc:RegistrationName>CLIENT EXEMPLE SARL</cbc:RegistrationName> BT-44 Nom de l'acheteur
<cbc:CompanyID schemeID="0002">200000008</cbc:CompanyID> BT-47 Identifiant légal de l'acheteur
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:PaymentMeans> BG-16 Instructions de paiement
<cbc:PaymentMeansCode>30</cbc:PaymentMeansCode> BT-81 Code du moyen de paiement
<cac:PayeeFinancialAccount> BG-17 Virement
<cbc:ID>FR7630006000011234567890189</cbc:ID> BT-84 Identifiant du compte de paiement (IBAN)
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>Paiement à 30 jours par virement.</cbc:Note> BT-20 Conditions de paiement
</cac:PaymentTerms>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">368.00</cbc:TaxAmount> BT-110 Total de TVA
<cac:TaxSubtotal> BG-23 Ventilation de la TVA
<cbc:TaxableAmount currencyID="EUR">1840.00</cbc:TaxableAmount> BT-116 Base imposable de la catégorie de TVA
<cbc:TaxAmount currencyID="EUR">368.00</cbc:TaxAmount> BT-117 Montant de TVA de la catégorie
<cac:TaxCategory>
<cbc:ID>S</cbc:ID> BT-118 Code de catégorie de TVA
<cbc:Percent>20</cbc:Percent> BT-119 Taux de TVA de la catégorie
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID> Régime de taxe : toujours VAT
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal> BG-22 Totaux du document
<cbc:LineExtensionAmount currencyID="EUR">1840.00</cbc:LineExtensionAmount> BT-106 Somme des montants nets de lignes
<cbc:TaxExclusiveAmount currencyID="EUR">1840.00</cbc:TaxExclusiveAmount> BT-109 Total hors TVA
<cbc:TaxInclusiveAmount currencyID="EUR">2208.00</cbc:TaxInclusiveAmount> BT-112 Total TTC
<cbc:PayableAmount currencyID="EUR">2208.00</cbc:PayableAmount> BT-115 Net à payer
</cac:LegalMonetaryTotal>
<cac:InvoiceLine> BG-25 Ligne de facture
<cbc:ID>1</cbc:ID> BT-126 Identifiant de la ligne
<cbc:InvoicedQuantity unitCode="DAY">2</cbc:InvoicedQuantity> BT-129 Quantité facturée
<cbc:LineExtensionAmount currencyID="EUR">1300.00</cbc:LineExtensionAmount> BT-131 Montant net de la ligne
<cac:Item> BG-31 Informations sur l'article
<cbc:Name>Audit de la chaîne de facturation</cbc:Name> BT-153 Nom de l'article
<cac:ClassifiedTaxCategory> BG-30 TVA de la ligne
<cbc:ID>S</cbc:ID> BT-151 Code de catégorie de TVA de l'article
<cbc:Percent>20</cbc:Percent> BT-152 Taux de TVA de l'article
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID> Régime de taxe : toujours VAT
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price> BG-29 Détail du prix
<cbc:PriceAmount currencyID="EUR">650.00</cbc:PriceAmount> BT-146 Prix unitaire net
</cac:Price>
</cac:InvoiceLine>
<cac:InvoiceLine> BG-25 Ligne de facture
<cbc:ID>2</cbc:ID> BT-126 Identifiant de la ligne
<cbc:InvoicedQuantity unitCode="HUR">6</cbc:InvoicedQuantity> BT-129 Quantité facturée
<cbc:LineExtensionAmount currencyID="EUR">540.00</cbc:LineExtensionAmount> BT-131 Montant net de la ligne
<cac:Item> BG-31 Informations sur l'article
<cbc:Name>Paramétrage du logiciel</cbc:Name> BT-153 Nom de l'article
<cac:ClassifiedTaxCategory> BG-30 TVA de la ligne
<cbc:ID>S</cbc:ID> BT-151 Code de catégorie de TVA de l'article
<cbc:Percent>20</cbc:Percent> BT-152 Taux de TVA de l'article
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID> Régime de taxe : toujours VAT
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price> BG-29 Détail du prix
<cbc:PriceAmount currencyID="EUR">90.00</cbc:PriceAmount> BT-146 Prix unitaire net
</cac:Price>
</cac:InvoiceLine>
</Invoice>
3

Lire l'en-tête

  • Identifiant de spécification (BT-24) : urn:cen.eu:en16931:2017 déclare une facture conforme à la norme EN 16931.
  • Mode de facturation (BT-23) : S1, une prestation de services. La valeur vient d'une liste fermée imposée par les règles françaises (BR-FR-08).
  • Type de document (BT-3) : 380 pour une facture, 381 pour un avoir. En UBL, un avoir change aussi de racine : CreditNote.
  • Dates : au format AAAA-MM-JJ.
  • Notes (BT-22) : les trois mentions françaises obligatoires (BR-FR-05) sont précédées de leur code sujet entre dièses : #PMD# pénalités de retard, #PMT# indemnité de recouvrement, #AAB# escompte.
4

Vendeur et acheteur

  • SIREN : l'identifiant légal (BT-30 pour le vendeur, BT-47 pour l'acheteur) porte l'attribut schemeID="0002", le code du répertoire SIRENE.
  • Adresse électronique (BT-34 et BT-49) : ce n'est pas un email, c'est l'adresse de routage de la facture entre plateformes. Ici le SIREN, avec le même schéma 0002. Son absence est une erreur (BR-FR-12, BR-FR-13).
  • Numéro de TVA (BT-31) : dans cac:PartyTaxScheme, suivi du régime VAT.
  • Pays (BT-40 et BT-55) : code à deux lettres, FR. C'est la seule donnée d'adresse obligatoire.
5

TVA et totaux

La ventilation de TVA (BG-23) compte une occurrence par couple catégorie et taux : ici une seule, catégorie S à 20 %. Les cinq totaux se déduisent les uns des autres, et chaque égalité est une règle de validation.

Code Total Balise Calcul Règle
BT-106 Somme des lignes LegalMonetaryTotal/LineExtensionAmount Σ BT-131 BR-CO-10
BT-109 Total hors TVA LegalMonetaryTotal/TaxExclusiveAmount BT-106 - BT-107 + BT-108 BR-CO-13
BT-110 Total de TVA TaxTotal/TaxAmount Σ BT-117 BR-CO-14
BT-112 Total TTC LegalMonetaryTotal/TaxInclusiveAmount BT-109 + BT-110 BR-CO-15
BT-115 Net à payer LegalMonetaryTotal/PayableAmount BT-112 - BT-113 + BT-114 BR-CO-16

Chaque montant porte l'attribut currencyID. Quand un total est faux, la page erreurs de validation donne la valeur fautive et la correction, règle par règle.

6

Les lignes

  • Montant net (BT-131) : quantité (BT-129) multipliée par le prix unitaire net (BT-146). La somme des lignes donne BT-106.
  • Unité (BT-130) : dans l'attribut unitCode de la quantité, en code UN/ECE : DAY pour un jour, HUR pour une heure.
  • TVA de la ligne (BT-151 et BT-152) : une catégorie et un taux. La ligne ne porte aucun montant de TVA : il se calcule dans la ventilation du document.
  • Position : les lignes cac:InvoiceLine ferment le document, après les totaux.
7

Correspondance UBL et CII

Les données de cette facture dans les deux syntaxes, par code BT. Le chemin est abrégé à ses deux derniers niveaux. La même facture est commentée en CII, le XML d'un Factur-X.

Code Donnée UBL CII
BT-1 Numéro de facture cbc:ID rsm:ExchangedDocument/ram:ID
BT-2 Date d'émission cbc:IssueDate ram:IssueDateTime/udt:DateTimeString
BT-3 Type de document (facture, avoir) cbc:InvoiceTypeCode rsm:ExchangedDocument/ram:TypeCode
BT-5 Devise cbc:DocumentCurrencyCode ram:ApplicableHeaderTradeSettlement/ram:InvoiceCurrencyCode
BT-9 Date d'échéance cbc:DueDate ram:DueDateDateTime/udt:DateTimeString
BT-13 Référence du bon de commande cac:OrderReference/cbc:ID ram:BuyerOrderReferencedDocument/ram:IssuerAssignedID
BT-20 Conditions de paiement cac:PaymentTerms/cbc:Note ram:SpecifiedTradePaymentTerms/ram:Description
BT-21 Code sujet de la note - ram:IncludedNote/ram:SubjectCode
BT-22 Mention en note de facture cbc:Note ram:IncludedNote/ram:Content
BT-23 Mode de facturation (flux CTC) cbc:ProfileID ram:BusinessProcessSpecifiedDocumentContextParameter/ram:ID
BT-24 Identifiant de spécification cbc:CustomizationID ram:GuidelineSpecifiedDocumentContextParameter/ram:ID
BT-27 Nom du vendeur cac:PartyLegalEntity/cbc:RegistrationName ram:SellerTradeParty/ram:Name
BT-29 Identifiant du vendeur cac:PartyIdentification/cbc:ID -
BT-30 Identifiant légal du vendeur cac:PartyLegalEntity/cbc:CompanyID ram:SpecifiedLegalOrganization/ram:ID
BT-31 Numéro de TVA du vendeur cac:PartyTaxScheme/cbc:CompanyID ram:SpecifiedTaxRegistration/ram:ID
BT-33 Informations juridiques complémentaires du vendeur cac:PartyLegalEntity/cbc:CompanyLegalForm ram:SellerTradeParty/ram:Description
BT-34 Adresse électronique du vendeur cac:Party/cbc:EndpointID ram:URIUniversalCommunication/ram:URIID
BT-35 Adresse du vendeur, ligne 1 cac:PostalAddress/cbc:StreetName ram:PostalTradeAddress/ram:LineOne
BT-37 Ville du vendeur cac:PostalAddress/cbc:CityName ram:PostalTradeAddress/ram:CityName
BT-38 Code postal du vendeur cac:PostalAddress/cbc:PostalZone ram:PostalTradeAddress/ram:PostcodeCode
BT-40 Pays du vendeur cac:Country/cbc:IdentificationCode ram:PostalTradeAddress/ram:CountryID
BT-43 Adresse email du contact vendeur cac:Contact/cbc:ElectronicMail ram:EmailURIUniversalCommunication/ram:URIID
BT-44 Nom de l'acheteur cac:PartyLegalEntity/cbc:RegistrationName ram:BuyerTradeParty/ram:Name
BT-46 Identifiant de l'acheteur cac:PartyIdentification/cbc:ID -
BT-47 Identifiant légal de l'acheteur cac:PartyLegalEntity/cbc:CompanyID ram:SpecifiedLegalOrganization/ram:ID
BT-49 Adresse électronique de l'acheteur cac:Party/cbc:EndpointID ram:URIUniversalCommunication/ram:URIID
BT-50 Adresse de l'acheteur, ligne 1 cac:PostalAddress/cbc:StreetName ram:PostalTradeAddress/ram:LineOne
BT-52 Ville de l'acheteur cac:PostalAddress/cbc:CityName ram:PostalTradeAddress/ram:CityName
BT-53 Code postal de l'acheteur cac:PostalAddress/cbc:PostalZone ram:PostalTradeAddress/ram:PostcodeCode
BT-55 Pays de l'acheteur cac:Country/cbc:IdentificationCode ram:PostalTradeAddress/ram:CountryID
BT-72 Date effective de livraison - ram:OccurrenceDateTime/udt:DateTimeString
BT-81 Code du moyen de paiement cac:PaymentMeans/cbc:PaymentMeansCode ram:SpecifiedTradeSettlementPaymentMeans/ram:TypeCode
BT-84 Identifiant du compte de paiement (IBAN) cac:PayeeFinancialAccount/cbc:ID ram:PayeePartyCreditorFinancialAccount/ram:IBANID
BT-106 Somme des montants nets de lignes cac:LegalMonetaryTotal/cbc:LineExtensionAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:LineTotalAmount
BT-109 Total hors TVA cac:LegalMonetaryTotal/cbc:TaxExclusiveAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:TaxBasisTotalAmount
BT-110 Total de TVA cac:TaxTotal/cbc:TaxAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:TaxTotalAmount
BT-112 Total TTC cac:LegalMonetaryTotal/cbc:TaxInclusiveAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:GrandTotalAmount
BT-115 Net à payer cac:LegalMonetaryTotal/cbc:PayableAmount ram:SpecifiedTradeSettlementHeaderMonetarySummation/ram:DuePayableAmount
BT-116 Base imposable de la catégorie de TVA cac:TaxSubtotal/cbc:TaxableAmount ram:ApplicableTradeTax/ram:BasisAmount
BT-117 Montant de TVA de la catégorie cac:TaxSubtotal/cbc:TaxAmount ram:ApplicableTradeTax/ram:CalculatedAmount
BT-118 Code de catégorie de TVA cac:TaxCategory/cbc:ID ram:ApplicableTradeTax/ram:CategoryCode
BT-119 Taux de TVA de la catégorie cac:TaxCategory/cbc:Percent ram:ApplicableTradeTax/ram:RateApplicablePercent
BT-126 Identifiant de la ligne cac:InvoiceLine/cbc:ID ram:AssociatedDocumentLineDocument/ram:LineID
BT-129 Quantité facturée cac:InvoiceLine/cbc:InvoicedQuantity ram:SpecifiedLineTradeDelivery/ram:BilledQuantity
BT-131 Montant net de la ligne cac:InvoiceLine/cbc:LineExtensionAmount ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineTotalAmount
BT-146 Prix unitaire net cac:Price/cbc:PriceAmount ram:NetPriceProductTradePrice/ram:ChargeAmount
BT-151 Code de catégorie de TVA de l'article cac:ClassifiedTaxCategory/cbc:ID ram:ApplicableTradeTax/ram:CategoryCode
BT-152 Taux de TVA de l'article cac:ClassifiedTaxCategory/cbc:Percent ram:ApplicableTradeTax/ram:RateApplicablePercent
BT-153 Nom de l'article cac:Item/cbc:Name ram:SpecifiedTradeProduct/ram:Name

Un tiret signale une donnée que ce fichier n'émet pas dans la syntaxe, pas une donnée qui n'y existe pas. En UBL, le code sujet d'une note (BT-21) s'écrit dans le texte de la note, entre dièses.

8

Contrôler et produire

Un fichier valide n'est pas une facture transmise : entre assujettis français, elle passe par une Plateforme Agréée.

Sources

  • Norme EN 16931-1 : modèle sémantique de la facture électronique, d'où viennent les codes BT et BG.
  • CEN/TS 16931-3-2 : liaison du modèle avec la syntaxe UBL 2.1 (OASIS).
  • Artefacts de validation EN 16931 et règles françaises CTC-FR (FNFE-MPE), contre lesquels ce fichier est validé.
Partager
Citer cette page

Exemple de facture UBL commentée, balise par balise, https://www.cabinetdigital.fr/facture-electronique/exemple-facture-ubl/

Rester informé

Réforme de la facture électronique : nouvelles plateformes agréées, échéances et outils, un email seulement quand il y a du neuf. Pas de spam : un email uniquement en cas d'évolution de la liste DGFiP ou du calendrier. Désinscription en un clic à tout moment, votre adresse n'est jamais partagée.

Questions fréquentes

Qu'est-ce qu'un code BT dans une facture UBL ?

BT signifie Business Term : c'est le numéro d'une donnée dans la norme EN 16931, indépendant de la syntaxe. BT-1 est le numéro de facture, qu'il soit écrit cbc:ID en UBL ou ram:ID en CII. Les codes BG désignent un groupe de données, comme le vendeur (BG-4).

Pourquoi l'ordre des balises compte-t-il en UBL ?

Parce que le schéma XSD d'UBL impose une séquence. La TVA et les totaux viennent avant les lignes, l'échéance avant le code de type. Une balise correcte posée au mauvais endroit fait échouer la validation XSD avant même le contrôle des règles métier.

Où se trouve le SIREN dans une facture UBL ?

À trois endroits pour le vendeur : l'identifiant légal (BT-30, cbc:CompanyID de PartyLegalEntity), l'identifiant (BT-29) et l'adresse électronique de routage (BT-34, cbc:EndpointID). Chacun porte l'attribut schemeID 0002, le code du répertoire SIRENE.

Cet exemple est-il un UBL Peppol BIS ?

Non. L'identifiant de spécification (BT-24) vaut urn:cen.eu:en16931:2017 : c'est un UBL conforme à la norme EN 16931 et aux règles françaises CTC-FR, pas au profil Peppol BIS Billing 3.0, qui ajoute ses propres contraintes.

À quoi ressemble un avoir en UBL ?

C'est un autre document : sa racine est CreditNote et non Invoice, avec CreditNoteTypeCode, CreditNoteLine et CreditedQuantity. Les montants restent positifs. Un avoir d'exemple est fourni parmi les fichiers à télécharger.