Guida ai report dei dati del contatore

Trasforma i campioni OCPP in dati utili di energia per intervallo.

EVCharge.mobi può esportare i campioni del caricatore alla base del grafico di una sessione, calcolare i consumi per intervalli di 15 minuti e di un’ora e includere il costo storico della tariffa registrato per ciascun periodo del report. Questa guida spiega esattamente cosa significano i dati CSV — e cosa non significano.

Perché gli orari di collegamento e scollegamento non bastano

Una sessione di ricarica può restare collegata mentre il veicolo è in pausa, raggiunge un limite, segue una programmazione o è vincolato dalla capacità del sito. Gli orari di inizio e fine sessione, quindi, non indicano quando è stata effettivamente erogata l'energia. I messaggi OCPP MeterValues con marca temporale possono fornire questo dettaglio se il caricatore li invia con unità e riferimenti di transazione utilizzabili.

Modalità di esportazione

Valori grezzi del contatore

Il CSV grezzo conserva ogni campione memorizzato con il timestamp UTC, la transazione, il caricatore, il sito, il connettore, la grandezza misurata, la fase, la posizione di misura, il valore originale e l'unità. Usa questo formato quando ti servono la corrente, la tensione, la potenza, lo stato di carica o l'esatta serie del registro energetico fornita dal caricatore.

Energia per intervalli di 15 minuti e per ora

Le esportazioni per intervallo usano solo campioni Energy.Active.Import.Register con unità Wh, kWh o MWh. EVCharge converte valori cumulativi consecutivi in una differenza espressa in kWh. Se un periodo di lettura attraversa il confine di un intervallo UTC, la differenza viene ripartita proporzionalmente al tempo trascorso sui due lati del confine.

Questa ripartizione proporzionale è una stima tra due letture fisiche. Un caricatore che invia letture ogni minuto consente una ripartizione più precisa ai confini degli intervalli rispetto a uno che le invia ogni ora.

Energia e costo per intervalli di 15 minuti e per ora

Le esportazioni con costi aggiungono le componenti tariffarie storiche registrate durante la fatturazione della sessione: energia, trasmissione, energia di mercato, prezzo netto medio per kWh di ogni componente, imposte, valuta e totale. Una riga di 15 minuti mostra il prezzo della componente per quel periodo; una riga oraria fornisce la media ponderata per il volume di energia. L'esportazione usa i costi memorizzati dei periodi di ricarica anziché ricalcolare le vecchie sessioni con la tariffa o la configurazione dei prezzi di mercato attuali.

I record dei costi sono assegnati all'intervallo di report UTC contenente il timestamp di determinazione del prezzo memorizzato. Tra i record storici duplicati per la stessa transazione, lo stesso timestamp e la stessa componente, viene conservato soltanto il più recente, contrassegnato come deduplicated_history. I periodi con energia misurata ma senza un costo tariffario registrato sono contrassegnati come not_priced; un prezzo non specificato non equivale a una ricarica gratuita.

Come esportare

  1. Apri Report nel portale CPO e scegli l’intervallo di date.
  2. Scegli valori grezzi del contatore, energia per intervallo oppure energia e costo per intervallo come formato di esportazione.
  3. Scarica il CSV e verifica la transazione, la tariffa, la valuta, lo stato di valorizzazione, le unità e i timestamp UTC prima di usarlo in altri sistemi.

Come leggere fasi e azzeramenti

  • Le serie per fase restano separate. Non sommare la serie aggregata «None» ai valori L1, L2 e L3 dello stesso caricatore.
  • Una variazione cumulativa negativa indica in genere un azzeramento o una sostituzione del contatore. EVCharge esclude quel segmento invece di riportare un consumo negativo o collegare i dati prima e dopo l'azzeramento.
  • I campioni senza unità di energia supportata restano nell’esportazione grezza ma sono esclusi dall’aggregazione per intervallo.
  • L'energia erogata proviene dalla serie selezionata di letture cumulative del registro. L'energia valorizzata proviene dalle righe storiche di fatturazione: entrambe le colonne restano visibili per la riconciliazione.
  • Se sono presenti sia registri aggregati sia registri per fase, l'esportazione con costi preferisce la serie aggregata senza sommarla ai valori L1, L2 e L3.
  • L'esportazione riflette i dati riportati dal caricatore. Verifica la configurazione del contatore e i requisiti di installazione prima di usarla per la fatturazione regolamentata.

Sicurezza e controllo accessi

Le esportazioni richiedono il permesso di lettura dei report nello spazio di lavoro CPO selezionato. Le query sono limitate a quello spazio di lavoro e a un massimo di 100.000 campioni memorizzati e 100.000 record dei costi per download; scegli un intervallo di date più breve se raggiungi un limite. Le richieste di esportazione non inviano comandi ai caricatori e non modificano le sessioni di ricarica.

Esempio di riga oraria

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

Serve un formato di report diverso?

Se servono intervalli basati sul fuso orario del calendario, invii automatici, uno schema contabile specifico o accesso API ai dati del contatore, inviaci colonne necessarie, intervallo e sistema di destinazione. È più utile che cercare di ricavare i requisiti da un generico CSV delle sessioni.