C) Obsah a struktura datové zprávy
1) Obsah datové věty
| Pole | Typ | Popis |
|---|---|---|
| supplierld | string | IČO dodavatele elektřiny nebo plynu. |
| data | array | Pole záznamů s daty, 1 záznam obsahuje data pro 1 odběratele a 1 odběrné místo. |
| data/id | string | Bezvýznamový unikátní identifikátor záznamu, který byl součástí výzvy s žádostí o data. Musí být vrácen jako součást dat s náklady pro daného odběratele a odběrné místo. |
| data/client | object | Data odběratele. |
| data/client/clientld | string | Unikátní identifikátor odběratele v rámci systémů dodavatele plynu nebo elektřiny. Slouží hlavně pro případné řešení nestandardních situací, ve standardním procesu není nijak využito. |
| data/client/firstName | string | Jméno odběratele. |
| data/client/lastName | string | Příjmení odběratele. |
| data/client/dateOfBirth | string | Datum narození odběratele (YYYY-MM-DD). |
| data/cd | object | Data odběrného místa a částek za dané období. |
| data/cd/pointOfDelivery | object | Data odběrného místa. |
| data/cd/pointOfDelivery/ean | string | Číslo odběrného místa elektřiny (pokud jde o elektřinu, jinak neuvedeno). |
| data/cd/pointOfDelivery/eic | string | Číslo odběrného místa plynu (pokud jde o plyn, jinak neuvedeno). |
| data/cd/pointOfDelivery/ruianld | string | Identifikátor adresy v RUIAN. |
| data/cd/pointOfDelivery/address | object | Adresa, může obsahovat atributy street, cityPart, city, zipCode, co (číslo orientační), cp (číslo popisné), ce (číslo evidenční). |
| data/cd/pointOfDelivery/parcelCoordinates | object | Geolokace parcely, může obsahovat atributy areaName, areaCode, parcelNumber, subParcelNumber. V datech je uveden pouze jeden údaj z trojice ruianId, address, parcelCoordinates, preferován je ruianId. |
| data/cd/pointOfDelivery/commodity | string, enum | Komodita. Typ komodity podle číselníku uvedeného v bodu 3. |
| data/cd/transactions | array | Částky pro požadované období podle výzvy. |
| data/cd/transactions/month | string | Měsíc a rok, podle formátu ISO 8061 (YYYY-MM). |
| data/cd/transactions /trType | string, enum | Typ částky. Typ částky podle číselníku uvedeného v bodu 3. |
| data/cd/transactions/amount | number | Výše částky. |
| data/cd/periods | array | Období, po která byl odběratel majitelem daného odběrného místa. Uvádí se pouze, pokud odběratel nebyl majitelem odběrného místa po celé reportované období. |
| data/cd/periods/clientFrom | string | Datum, odkdy byl odběratel majitelem daného odběrného místa (YYYY-MM-DD). |
| data/cd/periods/clientTo | string | Datum, dokdy byl odběratel majitelem daného odběrného místa (YYYY-MM-DD). |
| data/status | string | Informace pro případ, že data mohou být poskytnuta částečně nebo vůbec. Hodnoty dle číselníku uvedeného v bodu 3. |
| data/validationError | object | Informace o validační chybě. |
| data/validationError/errorType | string, enum | Typ chyby dle číselníku uvedeného v bodu 3. |
| data/validationError/value | string | Hodnota v systému dodavatele, pokud se liší od hodnoty, která byla zaslána ve výzvě a tato hodnota neprošla validací. |
| timestamp | string | Datum a čas, ke kterému jsou data platná, podle formátu ISO 8061. |
2) Datové typy
| month | Textový řetězec data ve formátu ISO 8061 YYYY-MM. |
3) Číselníky
i) Typ částek:
| Kód | Typ částky | Popis |
|---|---|---|
| P | platba | Platby od odběratele přijaté v daném měsíci. Pokud je více plateb v daném měsíci, je uveden součet. Nezapočítávají se platby nebo části plateb použité na pokuty nebo jiné sankce, případně na jiné další účely, jako je například pronájem LED žárovek. Tyto částky se odečtou od částky, kterou odběratel v daném měsíci poslal. |
| Z | záloha (od odběratele) | Zálohy nebo jejich část vyrovnané platbou vykázané v měsíci původní zálohy. |
| ZZ | předepsaná záloha | Záloha předepsaná odběrateli bez ohledu na to, jaké jsou jeho skutečné uhrazené zálohy. |
| PV | vyúčtovaný přeplatek vrácený odběrateli | Přeplatek z vyúčtování vrácený odběrateli. Je uveden v měsíci, kdy došlo k jeho vrácení, za které se považuje odeslání platby. |
| PZ | přeplatek použitý na zálohu | Přeplatek z vyúčtování použitý na úhradu zálohy. Je uveden v měsíci splatnosti zálohy. |
| NZ | zaplacený nedoplatek faktury nebo jeho část | Platba od odběratele přijatá v daném měsíci na úhradu nedoplatku z vyúčtování. Podle data přijetí platby (ne podle data splatnosti). Pokud má odběratel splátkový kalendář, uvede se příslušná částka též jako NZ v daném měsíci. NZ se tak rozloží do více měsíců. |
ii) Typ komodity:
| Kód | Typ komodity |
|---|---|
| E | elektřina |
| G | plyn |
iii) Status:
| Hodnota | Význam |
|---|---|
| OK | Vše v pořádku. Tento stav nemusí být uveden, je defaultní. |
| NOT_CLIENT | Odběratel v celém požadovaném období nebyl majitelem uvedeného odběrného místa. |
| NOT_CLIENT_FULL_TIME | Odběratel je nebo byl majitelem uvedeného odběrného místa, ale ne pro celé požadované období. |
| DATA_NOT_YET_AVAILABLE | Pro požadované období ještě nejsou k dispozici kompletní data. |
iv) Validační chyba:
| Hodnota | Význam |
|---|---|
| WRONG_FIRST_NAME | Rozdílné jméno odběratele, vše ostatní odpovídá. |
| WRONG_LAST_NAME | Rozdílné příjmení odběratele, vše ostatní odpovídá. |
| FIRST_AND_LAST_NAME_SWITCHED | Prohozené jméno a příjmení odběratele, vše ostatní odpovídá. |
| WRONG_BIRTHDAY | Rozdílné datum narození odběratele, vše ostatní odpovídá. |
| WRONG_ADDRESS | Rozdílná adresa odběrného místa, vše ostatní odpovídá. |
| OTHER | Jiný důvod, proč nebyla validace úspěšná. |