C) Obsah a struktura datové zprávy
1) Obsah datové věty

PoleTypPopis
supplierldstringIČO dodavatele elektřiny nebo plynu.
dataarrayPole záznamů s daty, 1 záznam obsahuje data pro 1 odběratele a 1 odběrné místo.
data/idstringBezvý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/clientobjectData odběratele.
data/client/clientldstringUniká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/firstNamestringJméno odběratele.
data/client/lastNamestringPříjmení odběratele.
data/client/dateOfBirthstringDatum narození odběratele (YYYY-MM-DD).
data/cdobjectData odběrného místa a částek za dané období.
data/cd/pointOfDeliveryobjectData odběrného místa.
data/cd/pointOfDelivery/eanstringČíslo odběrného místa elektřiny (pokud jde o elektřinu, jinak neuvedeno).
data/cd/pointOfDelivery/eicstringČíslo odběrného místa plynu (pokud jde o plyn, jinak neuvedeno).
data/cd/pointOfDelivery/ruianldstringIdentifikátor adresy v RUIAN.
data/cd/pointOfDelivery/addressobjectAdresa, může obsahovat atributy street, cityPart, city, zipCode, co (číslo orientační), cp (číslo popisné), ce (číslo evidenční).
data/cd/pointOfDelivery/parcelCoordinatesobjectGeolokace 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/commoditystring, enumKomodita. Typ komodity podle číselníku uvedeného v bodu 3.
data/cd/transactionsarrayČástky pro požadované období podle výzvy.
data/cd/transactions/monthstringMěsíc a rok, podle formátu ISO 8061 (YYYY-MM).
data/cd/transactions /trTypestring, enumTyp částky. Typ částky podle číselníku uvedeného v bodu 3.
data/cd/transactions/amountnumberVýše částky.
data/cd/periodsarrayObdobí, 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/clientFromstringDatum, odkdy byl odběratel majitelem daného odběrného místa (YYYY-MM-DD).
data/cd/periods/clientTostringDatum, dokdy byl odběratel majitelem daného odběrného místa (YYYY-MM-DD).
data/statusstringInformace pro případ, že data mohou být poskytnuta částečně nebo vůbec. Hodnoty dle číselníku uvedeného v bodu 3.
data/validationErrorobjectInformace o validační chybě.
data/validationError/errorTypestring, enumTyp chyby dle číselníku uvedeného v bodu 3.
data/validationError/valuestringHodnota v systému dodavatele, pokud se liší od hodnoty, která byla zaslána ve výzvě a tato hodnota neprošla validací.
timestampstringDatum a čas, ke kterému jsou data platná, podle formátu ISO 8061.

2) Datové typy
monthTextový řetězec data ve formátu ISO 8061 YYYY-MM.

3) Číselníky
i) Typ částek:
KódTyp částkyPopis
PplatbaPlatby 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.
Zzáloha (od odběratele)Zálohy nebo jejich část vyrovnané platbou vykázané v měsíci původní zálohy.
ZZpředepsaná zálohaZáloha předepsaná odběrateli bez ohledu na to, jaké jsou jeho skutečné uhrazené zálohy.
PVvyúčtovaný přeplatek vrácený odběrateliPř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.
PZpřeplatek použitý na zálohuPřeplatek z vyúčtování použitý na úhradu zálohy. Je uveden v měsíci splatnosti zálohy.
NZzaplacený nedoplatek faktury nebo jeho částPlatba 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ódTyp komodity
Eelektřina
Gplyn

iii) Status:
HodnotaVýznam
OKVše v pořádku. Tento stav nemusí být uveden, je defaultní.
NOT_CLIENTOdběratel v celém požadovaném období nebyl majitelem uvedeného odběrného místa.
NOT_CLIENT_FULL_TIMEOdběratel je nebo byl majitelem uvedeného odběrného místa, ale ne pro celé požadované období.
DATA_NOT_YET_AVAILABLEPro požadované období ještě nejsou k dispozici kompletní data.

iv) Validační chyba:
HodnotaVýznam
WRONG_FIRST_NAMERozdílné jméno odběratele, vše ostatní odpovídá.
WRONG_LAST_NAMERozdílné příjmení odběratele, vše ostatní odpovídá.
FIRST_AND_LAST_NAME_SWITCHEDProhozené jméno a příjmení odběratele, vše ostatní odpovídá.
WRONG_BIRTHDAYRozdílné datum narození odběratele, vše ostatní odpovídá.
WRONG_ADDRESSRozdílná adresa odběrného místa, vše ostatní odpovídá.
OTHERJiný důvod, proč nebyla validace úspěšná.