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.
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
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 € | ||
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>
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.
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.
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.
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.
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.
Contrôler et produire
- Contrôler un fichier : le validateur UBL applique le XSD, les règles EN 16931 et les règles françaises CTC-FR.
- Produire le vôtre : le générateur UBL part d'un formulaire et rend un fichier déjà validé.
- Autres cas : avoir, autoliquidation, livraison intracommunautaire, export, devise, parmi les exemples de factures à télécharger.
- Les formats du socle : Factur-X, UBL et CII comparés.
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é.
Citer cette page
Exemple de facture UBL commentée, balise par balise, https://www.cabinetdigital.fr/facture-electronique/exemple-facture-ubl/