Академический Документы
Профессиональный Документы
Культура Документы
format XML
Guide technique
Version 1.2
Page 1 sur 25
Version Date Evolution(s) essentielle(s)
1.0 28/09/2009 Première diffusion du document
1.1 14/12/2009 Mise en conformité avec la norme
Prise en compte d’évolutions diverses :
1.2 23/03/2010 - Valeurs possibles pour le champ n°76
- Ajout d’informations après le champ n°77
Ce guide a été réalisé pour vous donner tous les détails nécessaires sur la façon dont sont traduites les
factures EDF au format XML.
Périmètre d’application :
Mises à jour :
Page 2 sur 25
Sommaire
1. Présentation ...................................................................................................................................................... 4
1.1 Présentation générale du service proposé par EDF ................................................................................ 4
1.2 Norme utilisée........................................................................................................................................... 4
1.3 Dématérialisation simple et fiscale ........................................................................................................... 4
1.4 Mise à disposition des fichiers XML ......................................................................................................... 4
1.5 La forme technique du XML ..................................................................................................................... 5
1.6 Présentation générale de la facture d’énergie EDF ................................................................................. 6
2. Présentation de la facture traduite en XML....................................................................................................... 7
1.7 Structure générale .................................................................................................................................... 7
1.8 Informations techniques, formats ............................................................................................................. 7
1.9 Détail de chaque bloc ............................................................................................................................... 8
1.9.1 En-tête.................................................................................................................................................. 8
1.9.2 Lignes de factures .............................................................................................................................. 20
3. Annexes .......................................................................................................................................................... 24
1.10 XSD utilisée pour la facture EDF en XML .............................................................................................. 24
1.11 Table de codification EAN des lignes de facture.................................................................................... 24
1.12 Table de description des valeurs génériques......................................................................................... 24
Page 3 sur 25
1. PRESENTATION
1.1 PRESENTATION GENERALE DU SERVICE PROPOSE PAR EDF
L’offre Flux Electronique Facturation a pour objectif de mettre à disposition de nos clients un service fiable lui
permettant de traiter automatiquement les factures en utilisant ses propres identifiants de gestion. Les
composantes de l’offre sont :
1. un flux de données structuré et documenté au format XML,
2. des données mises à disposition sur un réseau à valeur ajouté,
3. des fichiers signés électroniquement pour une dématérialisation complète (mi 2010),
4. des informations propres aux clients ajoutées dans les factures et dans les flux de données.
Ce document définit comment la facture EDF est traduite dans le format XML.
Important :
Pour l’heure, cette offre est réservée à des clients en nombre limité. EDF se réserve la possibilité de ne pas la
mettre à disposition de tous les clients qui le souhaiteraient.
EDF a fait le choix d’utiliser un format XML normé par des instances internationales. Parmi ceux ci, nous avons
retenu le plus complet, permettant une description des multiples informations techniques figurant sur les factures
d’énergie tels les index de consommation.
La norme retenue par EDF pour la dématérialisation de ses factures en XML est l’UBL Invoice 2.0, d’Oasis.
La description technique du flux (XSD) est disponible en annexe.
Vous pourrez retrouver toutes les informations détaillées sur la norme UBL Invoice 2.0 et les XSD
correspondantes sur le site officiel : http://docs.oasis-open.org/ubl/prd-UBL-2.0/
Le présent guide technique décrit l’utilisation qui est faite de cette norme pour la facture EDF et ses spécificités.
- une première phase de dématérialisation simple : chaque facture papier est traduite en XML, les flux sont
envoyés aux clients sur un réseau à valeur ajoutée, en parallèle de la facture papier. Cette phase permet
de fiabiliser le processus d’intégration automatique et de comparer les données intégrées à celles
disponibles sur la facture papier correspondante ;
- une deuxième phase de dématérialisation fiscale : après signature d’un contrat d’inter-échange actant du
passage en dématérialisation fiscale, la facture papier n’est plus envoyée. C’est le fichier XML qui a
valeur de preuve fiscale. Celui-ci est signé électroniquement et transmis au client par le réseau à valeur
ajoutée.
Lors de cette deuxième phase, la signature est mise à disposition dans un fichier distinct de la facture
elle-même (le fichier de facture y faisant référence), et sert à garantir l’origine de la facture.
Page 4 sur 25
Une ré-émission des factures peut être faite en cas d’incident technique, et uniquement sur demande du
destinataire de la facture.
En complément du canal à valeur ajoutée, les données suivantes sont disponibles dans votre espace membre sur
nos sites Internet : www.edfentreprises.fr ou www.edfcollectivites.fr :
• En cas de dématérialisation simple, vous retrouvez une image en pdf de la facture originale en papier.
• En cas de dématérialisation fiscale (fichier XML signé), ce même fichier XML est disponible dans votre
espace membre. A son ouverture une mise en page du fichier est automatiquement associée. Cette mise
en page présente des différences avec celle de la facture papier.
Le XML est un langage structuré utilisant des balises. Sa structure est définie dans un schéma : le schéma
décrivant la facture EDF en XML est présent en annexe, sous forme de fichier XSD (cf XSD utilisée pour la
facture EDF en XML).
La structure du fichier est visualisable de manière graphique, grâce à des outils spécialisés. Vous trouverez dans
chaque paragraphe décrivant un bloc XML sa représentation graphique.
Page 5 sur 25
1.6 PRESENTATION GENERALE DE LA FACTURE D’ENERGIE EDF
EDF propose une facturation monosite (un site facturé = un compte commercial) ou une facturation multisite (un
compte commercial permet de facturer plusieurs contrats d’énergie ou un contrat d’énergie portant sur
l’alimentation en énergie de plusieurs sites).
Page 1 - recto :
Page 6 sur 25
2. PRESENTATION DE LA FACTURE TRADUITE EN XML
1.7 STRUCTURE GENERALE
La facture traduite en XML se découpe en blocs distincts, se rapprochant des différentes parties de la facture
papier :
• Les données d’en-tête, décrivant les informations générales de la facture et les données techniques
nécessaires à la transmission et l’intégration : cf § 1.9.1.1
• Les informations sur le compte payeur de la facture, présentant les identifiants du compte commercial
client : cf § 1.9.1.4
• Les informations contractuelles : cf § 1.9.1.2
• Les modalités et le type de paiement : cf § 1.9.1.6
• Les informations client, décrivant l’identification et le contact client : cf § 1.9.1.4
• Les informations de contact EDF : cf § 1.9.1.3
• Les montants de la facture, comprenant les montants TTC, HTVA et TVA globaux de la facture : cf §
1.9.1.7
• Les informations de site, dupliquées autant de fois qu’il y a de sites concernés par la facture : cf § 1.9.1.5
• Les lignes de facture, donnant la description complète de toutes les lignes qui composent la facture,
qu’elles soient informatives, de regroupement, ou constitutives du montant TTC de la facture : cf § 1.9.2
• L’historique de consommation, s’il est disponible, est rattaché à la ligne de facture « Dont consommation
facturée »
• Les informations techniques du point de livraison (numéro de compteur, coefficient de lecture…) sont
également rattachées à la ligne de facture « Dont consommation facturée »
• Les éléments présents sur l’annexe complément (facture papier) sont dispersés à différents niveaux du
fichier
Page 7 sur 25
1.9 DETAIL DE CHAQUE BLOC
Les tableaux présentés ci-après décrivent techniquement et fonctionnellement le contenu du flux XML.
1.9.1 En-tête
Les informations d’en-tête n’apparaissent qu’une fois par
facture et correspondent aux données présentes sur la page
récapitulative d’une facture papier.
Page 8 sur 25
En-tête générale : Invoice/
N° Elément Obl Type Valeur par défaut Commentaire
A Information
1 xmlns N http://www.w3.org/2001/XMLSchema-instance
technique
A urn:oasis:names:specification:ubl:schema:xsd:Co Information
2 xmlns:cac N
mmonBasicComponents-2 technique
A urn:oasis:names:specification:ubl:schema:xsd:Co Information
3 xmlns:cbc N
mmonBasicComponents-2 technique
A urn:oasis:names:specification:ubl:schema:xsd:Co Information
4 xmlns:ext N
mmonExtensionComponents-2 technique
A urn:oasis:names:specification:ubl:schema:xsd:Co Information
5 xmlns:xsi N
mmonAggregateComponents-2 technique
A urn:oasis:names:specification:ubl:schema:xsd:Inv Schéma technique
6 xsi:schemaLocation N
oice-2 UBL-Invoice-2.0.xsd de référence
A Information
7 cbc:UBLVersionID N 2.0
technique
A urn:oasis:names:specification:ubl:xpath:Invoice- Information
8 cbc:CustomizationID N
2.0:sbs-1.0-draft technique
A bpid:urn:oasis:names:draft:bpss:ubl-2-sbs- Information
9 cbc:ProfileID N
invoice-notification-draft technique
N Numéro légal de la
10 cbc:ID O
facture
A "false" => facture
11 cbc:CopyIndicator N originale
"true" => duplicata
N Identifiant technique
12 cbc:UUID N
de la facture
13 cbc:IssueDate O A Date de la facture
N "381" => Avoir
14 cbc:InvoiceTypeCode N
"380" => Facture
A "Avoir"
15 cbc:InvoiceTypeCode@Name N
"Facture"
A Date d'application de
16 cbc:TaxPointDate N
la TVA
A Monnaie du
17 cbc:DocumentCurrencyCode N EUR
document
A Monnaie du
18 cbc:TaxCurrencyCode N EUR
document
A Monnaie du
19 cbc:PaymentCurrencyCode N EUR
document
N Nombre de lignes de
20 cbc:LineCountNumeric N
facture
A Date la prochaine
21 cac:InvoicePeriod/cbc:StartDate N
facture
22 cac:InvoicePeriod/cbc:Description N A Date prochaine facture Libellé fixe
N Date de la facture
cac:OriginatorDocumentReferenc
23 N d’origine en cas
e/cbc:ID
d’avoir
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 9 sur 25
1.9.1.2 En-tête contractuelle
Identifiant du
24 cbc:ID O A compte
commercial client
« Bon de
commande » ou
25 cbc:DocumentTypeCode N A
« Compte
commercial »
cbc:DocumentTypeCode@list
26 N A EDF S.A.
ID
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 10 sur 25
Cet encart est visualisable sur la page 1 de la facture papier.
Reference de
27 cbc:ID O N
votre contrat
Date d'effet du
28 cbc:IssueDate N A
contrat
Libellé de l'offre
29 cbc:DocumentTypeCode N A
contractuelle
Attachment/ExternalReferenc Date d'échéance
30 N A
e/cbc:ExpiryDate du contrat
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Cet encart précède le détail de facturation de chaque site (point de livraison) sur la facture papier.
Page 11 sur 25
32 cbc:AdditionalAccountID N N Numéro TVA EDF
Party/cac:PartyIdentification/cbc:I
33 N N 55 208 131 766 522 SIRET
D
Party/cac:PartyName[1]/cbc:Nam
34 N A Nom de l’émetteur
e
Party/PostalAddress/cbc:PostalZo
35 N N Code postal contact EDF
ne
Party/PostalAddress/AdressLine/L
36 N A Lignes d'adresse contact EDF
ine
Party/PostalAddress/cac:Country/
37 N A Code pays contact EDF (ex:FR)
cbc:IdentificationCode
Party/cac :PartyTaxScheme/cac :
38 N A TVA DEBIT
TaxTypeCode
Party/PartyLegalEntity/cbc:Registr
39 N A EDF S.A.
ationName
Party/PartyLegalEntity/cbc:Compa
40 N A PARIS 552 081 317
nyID
Party/PartyLegalEntity/Registratio
41 N N 75008
nAddress/cbc:PostalZone
Party/PartyLegalEntity/Registratio
42 N A 22-30 avenue de Wagram
nAddress/AdressLine/Line
Party/PartyLegalEntity/Registratio
43 N A 75008
nAddress/AdressLine/Line
Party/PartyLegalEntity/Registratio
44 N A Paris
nAddress/AdressLine/Line
Party/PartyLegalEntity/Registratio
45 nAddress/cac:Country/cbc:Identifi N A FR
cationCode
Party/PartyLegalEntity/Corporate
46 N A 911085545
RegistrationScheme/cbc:ID
47 AccountingContact/cbc:Telephone N A Téléphone contact EDF
48 AccountingContact /cbc:Telefax N A Fax contact EDF
AccountingContact
49 N A Email contact EDF
/cbc:ElectronicMail
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 12 sur 25
1.9.1.4 Informations sur le destinataire
Page 13 sur 25
Informations contact client : AccountingCustomerParty/
50 cbc:CustomerAssignedAccountID N N Identifiant
52 Party/cac:PartyName/cbc:Name N A Nom
53 Party/PostalAddress/cbc:PostalZone N N Code postal
Party/PostalAddress/AddressLine/cbc Lignes d'adresse, répété autant de fois que de
54 N A
:Line lignes d'adresses
Party/PostalAddress/cac:Country/cbc
55 N A Code pays (ex: FR)
:IdentificationCode
56 AccountingContact/cbc:ID N N Identifiant compte de facturation
57 AccountingContact/cbc:Telephone N A Téléphone
58 AccountingContact/cbc:Telefax N A Fax
59 AccountingContact/cbc:ElectronicMail N A Email
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
52
56
54
Page 14 sur 25
1.9.1.5 Sites facturés
Un site facturé correspond à un point de livraison de l’énergie, associé généralement à un compteur
d’énergie électrique ou de gaz naturel (sauf pour certains tarif d’électricité sans comptage). Les lignes
de détail de facturation sont fournies pour chaque point de livraison. Le régime de collecte de taxes
locales étant défini par chaque collectivité en fonction de la puissance souscrite, le détail de
facturation par point de livraison est obligatoire.
NB : Certaines lignes de facturation ne sont pas attachées aux points de livraison. Dans ce
cas, elles figurent dans l’annexe « Complément ». Elles peuvent néanmoins être liées à un
contrat ou à un sous-périmètre d’un contrat.
Les variables citées dans le tableau suivant sont des caractéristiques des points de niveau « Site »
(ou point de livraison).
Page 15 sur 25
Groupe : identifiant propre au client qui
69 DeliveryParty/PartyIdentification/cbc:I A permet de faire des groupes de points de
D@SchemeName N service sur la facture papier uniquement.
DeliveryParty/PartyIdentification/cbc:I
70 A Code Imputation Site
D N
Code imputation : identifiant propre au
client qui permet d'identifier l'imputation
71 A comptable associée à un point de
DeliveryParty/PartyIdentification/cbc:I livraison. N’est utilisé que pour les
D@SchemeName N clients en comptabilité publique
DeliveryParty/PartyIdentification/cbc:I
72 A Code Site
D N
Code Site : identifiant propre au client qui
permet d’affecter automatiquement la
73 A facture, ou des éléments de la facture à
DeliveryParty/PartyIdentification/cbc:I une ligne budgétaire dans les applications
D@SchemeName N comptables du client
74 DeliveryParty/Contact/cbc:Name N A Depannage
Numéro de téléphone du dépannage pour
75 DeliveryParty/Contact/cbc:Telephone N A
ce point de service
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 16 sur 25
1.9.1.6 Informations de paiement
Valeurs possibles :
1 : Non défini
76 cbc:PaymentMeansCode O A 10 : Espèces
20 : Chèque / TIP
49 : Prélèvement automatique
cbc:PaymentMeansCode@listAgenc
N A NES
yID
cbc:PaymentMeansCode@listAgenc
N A Northern European Subset
yName
78 cbc:PaymentDueDate N A Date d’échéance du paiement
79 cbc:PaymentChannelCode N A IBAN
81 cbc:InstructionNote@languageID N A fr_FR
Valeurs possibles :
Automated clearing house credit
Cheque
83 cbc:Note N A Credit transfer
Interbank debit transfer
In cash
National or regional clearing
84 cbc:Amount N N Montant paiement
85 cbc:Amount@currencyID N A EUR
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Exemple : Page 1 facture Client payant par prélèvement : client de type entreprises
Page 17 sur 25
Exemple : Page 1 Avoir client payant par prélèvement : client de type entreprises
Client de type collectivité territoriale payant par « Virement sans mandatement au préalable ».
Page 18 sur 25
1.9.1.7 Montants récapitulatifs facture
88
86
92
90
Cet encart est disponible sur la page récapitulative de la facture papier pour les factures multisites
(verso de la première feuille).
Page 19 sur 25
94
Page 20 sur 25
Ligne de facture (répété autant de fois qu'il y a de lignes dans la facture) : InvoiceLine/
Page 21 sur 25
98 cbc:LineExtensionAmount O N Montant
cbc:LineExtensionAmount@currenc
99 N A EUR
yID
Valeurs possibles :
true => lignes ne participant pas au calcul
100 cbc:FreeOfChargeIndicator N A du montant total TTC de la facture
false => lignes participant au calcul du
montant total TTC de la facture
Identifiant du contrat/offre concerne par la
101 cac:DocumentReference/cbc:ID N A
ligne (voir AdditionalDocumentReference)
102 cac:Delivery/cbc:ID N A Identifiant du site facture (Voir Delivery)
103 cac:Item/cbc:Description N A Libellé du poste tarifaire
cac:Item/cbc:Description@language
104 N A fr-FR
ID
105 cac:Item/cbc:Name N A Libellé de la ligne
cac:Item/cac:ClassifiedTaxCategory
106 N N Code EAN de la ligne
/cac:ID
cac:Item/cac:ClassifiedTaxCategory
107 N A EN
/cac:ID@schemeID
cac:Item/cac:ClassifiedTaxCategory
108 N A EAN
/cac:ID@schemeAgencyID
Valeurs possibles :
cac:Item/cac:ClassifiedTaxCategory TVA Normale
109 N A
/cbc:Name TVA Réduite
Non Soumis
cac:Item/cac:ClassifiedTaxCategory
110 N N Pourcentage de TVA appliquée
/cbc:Percent
cac:Item/cac:StandardItemIdentificat
111 ion/AdditionalItemProperty/cbc:Nam N A ValeurGenerique
e
cac:Item/cac:StandardItemIdentificat
112 ion/AdditionalItemProperty/cbc:Valu N A Valeur de la valeur générique
e
cac:Item/cac:StandardItemIdentificat
113 ion/AdditionalItemProperty/ItemProp N A Numéro de la valeur générique
ertyGroup/cbc:ID
114 Cac:Price/cbc:PriceAmount N N Prix unitaire
Cac:Price/cbc:PriceAmount@curren
115 N A EUR
cyID
116 cac:Price/cbc:BaseQuantity N N Quantité
cac:DeliveryTerms/cac:DeliveryLoca
117 N A Date de début de facturation
tion/cac:ValidityPeriod/cbc:StartDate
cac:DeliveryTerms/cac:DeliveryLoca
118 N A Date de fin de facturation
tion/cac:ValidityPeriod/cbc:EndDate
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 22 sur 25
Informations techniques sur le point de livraison : AddititionalItemProperty/
Nom technique du
champ relatif au
119 cbc:Name N A
numéro de compteur
du site
Numéro de compteur
120 cbc:Value N N
du site
121 UsabilityPeriod/cbc:Description N A Numero de compteur
Nom technique du
champ relatif au
122 cbc:Name N A
coefficient de lecture du
site
Coefficient de lecture
123 cbc:Value N N
du site
124 UsabilityPeriod/cbc:Description N A Coefficient de lecture
La colonne « Obl » indique si la donnée est obligatoire (« O ») ou non (« N »).
La colonne « Type » indique si le format de donnée est numérique (« N ») ou alphanumérique (« A »).
Page 23 sur 25
3. ANNEXES
1.10 XSD UTILISEE POUR LA FACTURE EDF EN XML
UBL-Invoice-2.0.xsd
Pour interpréter et requêter les lignes de facture qui vous intéressent, EDF utilise une liste de codes
articles EAN associés à leur libellé. Voici la règle de transcodage.
< Identifiant Interne (4c)>, est un identifiant propre à EDF gérant l'unicité du code.
<Clé Validation EAN> est conforme à la norme EAN-13 ; cette clé permet de s'assurer de la validité
d'un code suite à un transfert électronique.
Cette liste de code est susceptible d'évoluer suite à des changement liés :
• à la création de nouveaux produits,
• aux évolutions réglementaires,
• aux évolutions des normes EAN.
Page 24 sur 25
SOUS_TOTAL_MONOPHASE Sous-total kWh
Page 25 sur 25