Configuration des importations de fichiers (.csv)

Comment mettre en place l'importation d'un fichier dans Energinet

Ce guide montre comment mettre en place l'importation d'un fichier d'un email expéditeur vers un email destinataire dans Energinet. Il montre également comment configurer l'importation d'un fichier et l'adapter aux formats de fichiers.

• Pour collecter des données à partir d' Energinet, une solution API REST est nécessaire (il s'agit de l'exportation à partir d'Energinet). Ce guide ne décrit pas l'exportation, mais la manière d'importer des données dans Energinet.
• '.csv' est le type de fichier le plus communément utilisé pour ce type d'importation, à ne pas confondre avec le format de fichier qui décrit comment le fichier .csv est conçu.
• Il est recommandé d'envoyer des fichiers au format es, es_2 ou Energinet Matrise. Ces formats de fichiers sont décrits dans la partie 3 de cet article.
• N'hésitez pas à contacter le service d'assistance de Kiona à l'adresse [e-mail] si vous avez besoin d'aide.

Partie 1 : Comment vous créez une importation de fichiers

1. Allez dans les paramètres et ensuite dans 'Importations de fichiers' / 'File imports'

2. Cliquez sur 'Créer'

3. Donnez un nom à l'importation de fichiers et créez l'adresse e-mail du destinataire

• L'adresse email du destinataire ('To address') sera utilisée pour envoyer vos fichiers csv à Energinet à partir de votre base de données/email.
• Vous pouvez ajouter une note pour votre propre administration, laisser les autres paramètres par défaut.

4. Sélectionnez le(s) objet(s) destinataire(s) des données de l'importation de fichiers

• Il peut s'agir de dossiers et de bâtiments auxquels vous avez accès. Assurez-vous qu'ils sont surlignés en vert.
  
  

5. Cliquez sur "Créer et ajouter des expéditeurs autorisés"

6. Ajoutez l'adresse électronique de l'expéditeur ou des expéditeurs et sélectionnez le(s) format(s) correct(s)

• Dans la troisième partie de cet article, vous verrez comment créer un fichier CSV correspondant à ces formats.

(!) Assurez-vous de cliquer sur le symbole plus () à droite pour ajouter l'expéditeur valide!

(!) Veillez à choisir le bon format de fichier lié à l'expéditeur valide!

• Seuls les expéditeurs valides peuvent envoyer des messages à l'adresse du destinataire que vous avez créée dans la partie 1, étape 3.
• Vous pouvez avoir plusieurs expéditeurs valides par importation de fichier, y compris des formats différents.

7. Vérifiez que l'expéditeur a bien été ajouté

8. Cliquez sur "Mettre à jour" / "Update" lorsque vous avez terminé

Partie 2 : Comment vous modifiez une importation de fichiers existante

1. Allez dans les paramètres, puis dans "Importation de fichiers" / "File imports"

2. Cliquez sur le symbole du crayon pour modifier les paramètres d'une importation de fichiers

• Vous pouvez également cliquer sur le symbole graphique bleu pour obtenir une vue d'ensemble des fichiers importés.
• Vous pouvez également utiliser le symbole de la croix rouge pour supprimer une importation de fichiers.

3. Modifiez les paramètres de l'importation de fichiers ouverte (voir la partie 1 de cet article)

4. Cliquez sur "Mettre à jour" / "Update" lorsque vous avez terminé.

Partie 3 : Formats de fichiers CSV d'Energinet

Créez le fichier CSV en fonction du format de fichier que vous avez choisi dans la partie 1, étape 6

• Les formats présentés dans la partie 3 sont les plus faciles à configurer, n'oubliez pas de suivre leurs spécifications à la lettre.
• Energinet prend également en charge de nombreux autres formats (plus complexes), tels que MSCONS, UTILS, GS2, Schneider EGX300. Veuillez contacter [e-mail] pour toute question.
• Vous pouvez ajouter plus d'un numéro de compteur par fichier CSV.

---

1. Format du fichier: es 

Fichier de valeurs séparées par des virgules (CSV) de conception simple.

• Trois colonnes structurées comme suit: horodatage,numéro d'identification du compteur, valeur.
• Virgule comme séparateur entre les colonnes
• Point comme indicateur décimal.
• N'utilisez pas de séparateurs ou de signes décimaux dans l'identifiant de votre compteur (Meter ID)!

Colonne 1: Date et heure

Les structures autorisées pour les horodatages sont les suivantes :

Année, mois, jour.	AAAA-MM-JJ
Année, mois, jour, heure, minute.	AAAA-MM-JJ HH:mm
Année, mois, jour, heure, minute, seconde.	AAAA-MM-JJ HH:mm:ss
Jour, mois, année.	JJ-MM-AAAA
Jour, mois, année, heure, minute.	JJ-MM-AAAA HH:mm
Jour, mois, année, heure, minute, seconde.	JJ-MM-AAAA HH:mm:ss

Colonne 2: ID du compteur (Meter ID)

Dans cette colonne, l'identifiant du compteur est ajouté. L'ID du compteur est l'identifiant unique qu'Energinet utilise pour envoyer les données au bon compteur dans le système.

Colonne 3: Valeur

La valeur du compteur à l'horodatage correspondant.

Exemple (timestamp,meterID,value) :

04-07-2025 00:00:00,A5750007500X,10.00
03-07-2025 23:00:00,A05750007500X,20.00
03-07-2025 22:00:00,A5750007500X,30.00

---

2. Format de fichier : es_2

Même procédure que 'es' mais avec deux différences :

1. Lepoint-virgule est utilisé comme séparateur de colonne au lieu de la virgule.
2. Lavirgule est utilisée comme indicateur décimal au lieu du point.

• Comme "es", ce format se compose de trois colonnes structurées comme suit : timestamp;meterID;value
• Ne pas utiliser de virgule ou de point-virgule dans les numéros d'identification des compteurs (Meter ID)!

Exemple :

31-12-2025 23:00:00;A5750003940X;11,00
31-12-2025 22:00:00;A5750003940X;10,00
31-12-2025 21:00:00;A5750003940X;8,00

---

3. Format du fichier: Energinet Matrisse 

Ce format de fichier CSV est structuré comme une matrice:

• Le point-virgule peut être utilisé comme séparateur, ou bien une virgule ou un tabulateur.
• Le signe décimal est soit un point, soit une virgule
• N'utilisez pas ces séparateurs ou signes décimaux dans l'identification de votre compteur !
• Le format de la date doit être DD.MM.YYYY ou YYYY.MM.DD, tandis que le format de l'heure est facultatif et peut être HH:mm:ss ou HH:mm (comme pour es et es_2).
• La ligne 1, colonne A, doit être le texte: FBDATO

Exemple :

FBDATO;MeterID_1;MeterID_2;MeterID_3
25.07.2025 14:00;12.5;7.8;3.4
25.07.2025 15:00;13.0;8.0;3.6
25.07.2025 16:00;12.8;7.9;3.5

Dans un tableau, ces données se présenteraient comme suit:

FBDATO	MeterID_1	MeterID_2	MeterID_3
25.07.2025 14:00	12.5	7.8	3.4
25.07.2025 15:00	13.0	8.0	3.6
25.07.2025 16:00	12.8	7.9	3.5

• La ligne 1 contient les identifiants des données de compteur à partir de la colonne B.
• Les données de compteur apparaissent à partir de la ligne 2.
• La colonne A est réservée aux horodatages.

---

4. Format du fichier : eos_3

Fichier CSV spécialement conçu pour les compteurs à lecture horaire qui transmettent des données quotidiennement.

• Il n'est pas nécessaire de fournir les 24 valeurs. Les colonnes vides seront interprétées comme des valeurs manquantes.
• Le point-virgule est utilisé comme séparateur entre les colonnes.
• Un point ou une virgule peut être utilisé comme signe décimal.
• N'utilisez pas de séparateurs ou de signes décimaux dans l'identifiant de votre compteur (Meter ID)!
• Utilisez toujours le format d'horodatage suivant : JJ-MM-AAAA

Exemple (sans valeurs manquantes):

27.05.2022;101;31;27;23;25;25;21;26;34;41;30;27;30;30;27;30;25;24;21;20;22;26;21;25;21
28.05.2022;102;20;21;21;20;22;20;16;23;27;27;28;29;27;27;28;24;24;29;25;22;26;22;20;19
29.05.2022;103;22;21;19;21;21;17;19;20;24;25;25;23;25;27;27;35;31;29;27;25;26;25;26;22

Ou sous forme de tableau (avec des valeurs manquantes):

Date	MeterID	Val_1	Val_2	Val_3	...	Val_24
27.05.2022	101	5.2	4.8	5.0	...	4.9
28.05.2022	102	7.5		7.3	...	7.1
29.05.2022	103	3.1	3.0		...

Ce texte a été traduit de l'anglais et peut donc contenir des erreurs malgré tous nos efforts pour les éliminer. En cas de doute, veuillez consulter la version anglaise.