Guide d’export des données de compteur

Export des données de compteur par intervalle

EVCharge.mobi peut exporter les mesures de la borne utilisées dans le graphique d’une session, calculer la consommation par tranches de 15 minutes ou d’une heure et inclure le coût historique du tarif enregistré pour chaque période du rapport. Ce guide explique précisément ce que signifient les données CSV — et ce qu’elles ne signifient pas.

Pourquoi les heures de branchement et débranchement ne suffisent pas

Une session de recharge peut rester connectée lorsque le véhicule fait une pause, atteint une limite, suit un programme ou subit une limitation liée à la capacité du site. Les heures de début et de fin n'indiquent donc pas quand l'énergie a réellement été fournie. Les messages OCPP MeterValues horodatés peuvent apporter ce détail si la borne transmet des unités et des références de transaction exploitables.

Modes d'export

Valeurs brutes du compteur

Le CSV brut conserve chaque échantillon stocké avec son horodatage UTC, sa transaction, sa borne, son site, son connecteur, sa grandeur mesurée, sa phase, son emplacement de mesure, sa valeur d’origine et son unité. Utilisez ce format lorsque vous avez besoin du courant, de la tension, de la puissance, de l’état de charge ou de la série exacte du registre d’énergie fournie par la borne.

Énergie par quart d'heure et par heure

Les exports par intervalle utilisent uniquement les échantillons Energy.Active.Import.Register exprimés en Wh, kWh ou MWh. EVCharge transforme les valeurs cumulées consécutives en une différence exprimée en kWh. Si une période de mesure franchit une limite d’intervalle UTC, cette différence est répartie proportionnellement au temps écoulé de chaque côté de la limite.

Cette répartition proportionnelle est une estimation entre deux relevés physiques. Une borne qui transmet un relevé chaque minute permet une répartition plus précise aux limites des intervalles qu’une borne qui transmet un relevé chaque heure.

Énergie et coût par quart d'heure et par heure

Les exports avec coûts incluent les composantes tarifaires historiques enregistrées lors de la facturation de la session : énergie, acheminement, énergie de marché, prix moyen hors taxes par kWh de chaque composante, taxe, devise et total. Une ligne de 15 minutes indique le prix de la composante pour cette période ; une ligne horaire fournit la moyenne pondérée par le volume d’énergie. L’export utilise les coûts stockés pour les périodes de recharge au lieu de recalculer les anciennes sessions selon le tarif ou la configuration des prix de marché actuels.

Les enregistrements de coûts sont affectés à l’intervalle de rapport UTC contenant leur horodatage de tarification stocké. Parmi les enregistrements historiques en double pour une même transaction, un même horodatage et une même composante, seul le plus récent est conservé et marqué deduplicated_history. Les périodes avec une énergie mesurée mais sans coût tarifaire enregistré sont marquées not_priced ; un prix non renseigné ne signifie pas que la recharge est gratuite.

Comment exporter

  1. Ouvrez Rapports dans le portail CPO et choisissez la période.
  2. Choisissez comme format d'export les valeurs brutes du compteur, l'énergie par intervalle ou l'énergie et le coût par intervalle.
  3. Téléchargez le CSV et vérifiez la transaction, le tarif, la devise, l’état de tarification, les unités et les horodatages UTC avant de l’utiliser dans d’autres systèmes.

Comment lire les phases et les réinitialisations

  • Les séries par phase restent séparées. N’ajoutez pas la série agrégée « None » aux valeurs L1, L2 et L3 de la même borne.
  • Une variation cumulée négative indique généralement une remise à zéro ou un remplacement du compteur. EVCharge ignore ce segment plutôt que d'afficher une consommation négative ou de relier les données de part et d'autre de la remise à zéro.
  • Les échantillons sans unité d’énergie compatible restent dans l’export brut mais sont exclus de l’agrégation par intervalle.
  • L’énergie fournie provient de la série sélectionnée de relevés cumulés du registre. L’énergie tarifée provient des lignes historiques de facturation ; les deux colonnes restent donc visibles pour le rapprochement.
  • Si des registres agrégés et par phase existent, l’export avec coûts privilégie la série agrégée sans l’ajouter aux valeurs L1, L2 et L3.
  • L’export reflète les données transmises par la borne. Vérifiez la configuration du compteur et les exigences d’installation avant de l’utiliser pour une facturation réglementée.

Sécurité et contrôles d’accès

Les exports nécessitent le droit de lecture des rapports dans l’espace de travail CPO sélectionné. Les requêtes sont limitées à cet espace de travail et à 100 000 échantillons stockés et 100 000 enregistrements de coûts par téléchargement ; choisissez une période plus courte si une limite est atteinte. Les demandes d’export n’envoient aucune commande aux bornes et ne modifient pas les sessions de recharge.

Exemple de ligne horaire

Interval start (UTC),Interval end (UTC),Transaction,Charger,Site,Connector,Phase,Location,Energy (kWh),Contributing segments
2026-08-13T10:00:00.000Z,2026-08-13T11:00:00.000Z,4201,Garage A,Office,1,None,Outlet,6.842,12

Besoin d’un autre format de rapport ?

Si vous avez besoin d’intervalles selon le fuseau horaire du calendrier, d’envois automatiques, d’un schéma comptable particulier ou d’un accès par API aux données des compteurs, envoyez-nous les colonnes nécessaires, l’intervalle et le système destinataire. Cette méthode est plus utile que de tenter de déduire les besoins à partir d’un fichier CSV générique de sessions.