Primename, kad nuo rugpjūčio 21 dienos yra sudiegtas svarbus pokytis dėl 15 min skaitiklių duomenų atidavimo „push“ metodu (dokumentacijoje – Delta Interval Reading Service).
Norime pabrėžti, kad šis funkcionalumas yra labai svarbus ne tik DH sistemai dėl geresnio stabilumo ir greitaveikos, bet ir kitoms ESO sistemoms, kurios yra atsakingos už skaitiklių duomenų surinkimą ir apdorojimą.
Todėl prašome įsivertinti ateinančių pokyčių apimtis ir susiplanuoti kaip galima greičiau pradėti naudoti naująjį metodą.
Primename ir papildome esmines žinutės apie funkcionalumą:
- Apie tokio funkcionalumo naudojimą turite informuoti el.p. [email protected], kad toks duomenų formavimas būtų įjungtas.
- Duomenys bus tik 15 min intervale.
- Duomenys bus tik už praėjusią parą (live duomenų sprendimas šiuo metu testuojamas).
- Duomenys bus tik skaitiklio lygmenyje.
- Duomenys rašomi į avro failą.
- Apie suformuotą avro failą bus siunčiami pranešimai-event‘ai per dedikuotą API metodą.
- Duomenys avro faile yra neagreguoti ir nesurikiuoti (neapdoroti (raw) skaitiklių duomenys).
- Vieno skaitiklio duomenys gali būti atiduodami atskirais avro failais.
- Duomenų rašymas į failą vyksta delta principu, jei duomenų nebuvo, vadinasi jie gali būti įrašomi į kitą failą, kai bus nuskaityti.
- Duomenų rašymas ir pranešimų-event‘ų siuntimas prasidės kiekvienos dienos 00:15.
- Suformuotas failas saugomas DH sistemoje 3 dienas.
- Šiuo metodu gautų duomenų nenaudokite sąskaitų formavimui, tam, po sąskaitybos periodo uždarymo žinutės, naudokite senuosius API metodus skirtus gauti duomenis už ilgesnį periodą.
Palyginimas kokius duomenis šiuo metu gaunate naudojant veikiantį API metodą su naujuoju „PUSH“ sprendimu:
| Dabartinis API metodas (skaitiklio lygmuo) užsakymo atsakyme esantys duomenys | Naujasis metodas avro faile esantys duomenys |
"consumptionCategory": "P+", "amount": 0, "consumptionTime":"2025-08-12T09:22:20.370Z", "valueType": "EST" "meterNumber": "SAG1111111111111" "objectBsId": 0, "objectNumber": "12345678", "personCode": "123456", "personName": "Jonas", "personSurname": "Jonaitis" | "category": "+A" "amount": "1.23" "collectedAt": "2025-08-07T00:01:00+03:00" "readingTime": "2025-08-07T00:00:00+03:00" "valueType": "VAL" "meterNumber": "SAG1111111111111" "objectNumber": "12345678" |
Taip pat, DH IT komanda paruošė rekomendacijas, su kuriomis prašome supažindinti savo IT komandas, esant klausimų kreipkitės [email protected]
Nuoroda į IT rekomendacijas: Nepriklausomų tiekėjų dokumentacija | ESO DH, dokumentas „DH API documentation for independent supplier“
Skyriai:
6.8 Delta Interval Reading Service
7.13 Messaging controller
We would like to remind you that from August 21, an important change has been implemented regarding the provision of 15-minute meter data via the "push" method (in the documentation - Delta Interval Reading Service).
We would like to emphasize that this functionality is very important not only for the DH system due to better stability and speed, but also for other ESO systems that are responsible for collecting and processing meter data.
Therefore, we ask you to assess the scope of the upcoming changes and plan to start using the new method as soon as possible.
A few key messages about the functionality:
- You must inform us about the use of such functionality by e-mail [email protected] so that such data formatting is enabled.
- Data will only be available in 15-minute intervals.
- Data will only be available for the previous 24 hours (live data solution is currently being tested).
- Data will only be available at the meter level.
- Data will be written to an avro file.
- Event messages will be sent about the generated avro file via a dedicated API method.
- Data in the avro file is not aggregated and not sorted (raw meter data).
- Data from one meter can be provided with different avro files.
- Data is written to the file using the delta principle, if there was no data, it can be written to another file when it is read.
- Data writing and sending of event messages will begin every day at 00:15.
- The generated file is stored in the DH system for 3 days.
- Do not use the data obtained with this method for billing purposes. To do this, after the billing period closing message, use the old API methods for obtaining data for a longer period.
Comparison of what data you currently receive using the working API method with the new "PUSH" solution:
| Current API method (meter level) data in order response | The new method is the data in the avro file. |
"consumptionCategory": "P+", "amount": 0, "consumptionTime":"2025-08-12T09:22:20.370Z", "valueType": "EST" "meterNumber": "SAG1111111111111" "objectBsId": 0, "objectNumber": "12345678", "personCode": "123456", "personName": "Jonas", "personSurname": "Jonaitis" | "category": "+A" "amount": "1.23" "collectedAt": "2025-08-07T00:01:00+03:00" "readingTime": "2025-08-07T00:00:00+03:00" "valueType": "VAL" "meterNumber": "SAG1111111111111" "objectNumber": "12345678" |
Also, the DH IT team has prepared recommendations, which we kindly ask you to familiarize your IT teams with. If you have any questions, please contact [email protected]
Link to IT recommendations: Nepriklausomų tiekėjų dokumentacija | ESO DH, document name “DH API documentation for independent supplier”
Sections:
6.8 Delta Interval Reading Service
7.13 Messaging controller