Mittausdatan vientiohje

Jaksokohtaisten mittaustietojen vienti

EVCharge.mobi voi viedä lataustapahtuman kaavion taustalla olevat laturin mittausnäytteet, johtaa kulutuksen 15 minuutin ja tunnin jaksoille sekä sisällyttää kullekin raportointijaksolle tallennetut historialliset tariffikustannukset. Tämä opas selittää tarkasti, mitä CSV-tiedot tarkoittavat — ja mitä ne eivät tarkoita.

Miksi kytkentä- ja irrotusajat eivät riitä

Lataustapahtuma voi pysyä kytkettynä, vaikka ajoneuvo pitää tauon, saavuttaa rajan, noudattaa ajastusta tai kohteen kapasiteetti rajoittaa sitä. Lataustapahtuman aloitus- ja lopetusajat eivät siksi näytä, milloin energia todella siirrettiin. Aikaleimatut OCPP MeterValues -tiedot voivat kertoa tämän, kun laturi lähettää ne käyttökelpoisilla yksiköillä ja tapahtumaviitteillä.

Vientitavat

Raakamittausarvot

Raaka-CSV säilyttää jokaisen tallennetun näytteen UTC-aikaleiman, tapahtuman, laturin, kohteen, liittimen, mittaussuureen, vaiheen, sijainnin, alkuperäisen arvon ja yksikön. Käytä tätä muotoa virran, jännitteen, tehon, varaustilan tai laturin lähettämän tarkan energiarekisterisarjan tarkasteluun.

Energia 15 minuutin ja tunnin jaksoissa

Jaksokohtaiset viennit käyttävät vain Energy.Active.Import.Register-näytteitä, joiden yksikkö on Wh, kWh tai MWh. EVCharge muuntaa peräkkäiset kumulatiiviset arvot kWh-erotukseksi. Jos mittausjakso ylittää UTC-jaksorajan, erotus jaetaan rajan molemmin puolin kuluneen ajan suhteessa.

Tämä suhteellinen kohdistus on arvio kahden fyysisen lukeman välillä. Minuutin välein raportoiva laturi tuottaa tarkemman jaksorajan kuin tunnin välein raportoiva.

Energia ja kustannukset 15 minuutin ja tunnin jaksoissa

Hinnoitellut viennit lisäävät latauksen laskutuksessa tallennetut historialliset tariffiosat: energia, siirto, markkinaenergia, kunkin osan keskimääräinen nettohinta kilowattitunnilta, verot, valuutta ja kokonaishinta. 15 minuutin rivi näyttää jakson osahinnan; tuntirivi näyttää määräpainotetun keskiarvon. Vienti käyttää tallennettuja latausjaksojen kustannuksia eikä laske vanhoja latauksia uudelleen nykyisillä tariffi- tai markkinahinta-asetuksilla.

Kustannustiedot kohdistetaan tallennetun hinnoitteluajan sisältävään UTC-raportointijaksoon. Saman tapahtuman, aikaleiman ja osan historiallisista kaksoiskappaleista säilytetään uusin tietue, joka merkitään deduplicated_history. Jaksot, joilla on mitattua energiaa mutta ei tallennettua tariffikustannusta, merkitään not_priced; tyhjä hinta ei tarkoita maksutonta latausta.

Näin viet tiedot

  1. Avaa CPO-portaalin raportit ja valitse aikaväli.
  2. Valitse vientimuodoksi raakamittausarvot, jakson energia tai jakson energia ja kustannukset.
  3. Lataa CSV ja tarkista tapahtuma, tariffi, valuutta, hinnoittelun tila, yksiköt ja UTC-aikaleimat ennen jatkokäyttöä.

Näin luet vaiheita ja mittarin nollauksia

  • Vaihekohtaiset sarjat pysyvät erillisinä. Älä lisää saman laturin None-koontisarjaa L1-, L2- ja L3-arvoihin.
  • Negatiivinen kumulatiivinen erotus tarkoittaa yleensä mittarin nollausta tai vaihtoa. EVCharge ohittaa jakson eikä ilmoita negatiivista kulutusta tai yhdistä tietoja nollauksen yli.
  • Näytteet, joissa ei ole tuettua energiayksikköä, säilyvät raakaviennissä, mutta niitä ei sisällytetä jaksokohtaiseen koostamiseen.
  • Toimitettu energia perustuu valittuun kumulatiiviseen mittausrekisteriin. Hinnoiteltu energia perustuu historiallisiin laskutusriveihin, joten molemmat sarakkeet näkyvät täsmäytystä varten.
  • Kun sekä koonti- että vaihekohtaiset rekisterit ovat saatavilla, hinnoiteltu vienti käyttää ensisijaisesti koontisarjaa eikä lisää sitä L1-, L2- ja L3-arvoihin.
  • Vienti vastaa laturin ilmoittamia tietoja. Varmista mittarin asetukset ja asennusvaatimukset ennen käyttöä säännellyssä laskutuksessa.

Turvallisuus ja käyttöoikeuksien hallinta

Vienti vaatii raporttien lukuoikeuden valittuun CPO-työtilaan. Kyselyt rajataan kyseiseen työtilaan ja enintään 100 000 säilytettyyn näytteeseen sekä 100 000 kustannustietueeseen latausta kohti. Valitse lyhyempi aikaväli, jos raja täyttyy. Vientipyynnöt eivät lähetä komentoja latureille eivätkä muuta lataustapahtumia.

Esimerkkirivi tunnilta

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

Tarvitsetko toisenlaisen raportin?

Jos tarvitset kalenterin aikavyöhykkeen mukaisia jaksoja, automaattisen toimituksen, tietyn kirjanpitoskeeman tai mittaustietojen API-käytön, lähetä tarvittavat sarakkeet, aikaväli ja jatkokäsittelyjärjestelmä. Se on hyödyllisempää kuin vaatimusten päätteleminen yleisestä latausten CSV-tiedostosta.