Vyhláška o provedení některých ustanovení zákona o pomoci v hmotné nouzi

A) Specifikace komunikace mezi peněžním ústavem a orgánem pomoci v hmotné nouzi
1) Orgán pomoci v hmotné nouzi odešle písemnou žádost jako zprávu obsahující dokument výzvy a XML soubor z datové schránky orgánu pomoci v hmotné nouzi do datové schránky peněžního ústavu. Orgán pomoci v hmotné nouzi do předmětu datové zprávy vloží pouze text “XMLOPHNSOUC”.
2) Peněžní ústav na písemnou žádost orgánu pomoci v hmotné nouzi odešle zprávu s XML souborem s požadovanými daty do datové schránky orgánu pomoci v hmotné nouzi z datové schránky peněžního ústavu. Pro vytvoření XML souboru odpovědi peněžní ústav využije vlastní technické prostředky. Peněžní ústav do předmětu datové zprávy vloží pouze text “XMLOPHNSOUC”.

B) Formát a struktura datové zprávy
Datová zpráva pro komunikaci mezi orgánem pomoci v hmotné nouzi a peněžním ústavem je výhradně ve formátu XML. XML soubor je kódován v UTF-8. Jméno souboru je tvořeno kódem orgánu pomoci v hmotné nouzi, kódem peněžního ústavu a unikátním identifikátorem vytvořeným orgánem pomoci v hmotné nouzi při vytváření dotazu, a to podle následujících pravidel:

Pořadí	Část	Délka	Popis
1	KodOPHN	3	Kód dotazujícího se orgánu pomoci v hmotné nouzi.
2	„-„	1	Oddělovač.
3	KodBanky	4	Kód dotazovaného peněžního ústavu.
4	-	1	Oddělovač.
5	CisloDavky	10	Jednoznačné identifikační číslo dávky.
6	„-„	1	Oddělovač.
7	„dot“ nebo „odp“	3	Identifikace, zda se jedná o dotaz („dot“) nebo odpověď („odp“).
8	„.xml“	4	Přípona indikující typ souboru.

1) Dotaz je zabalen do SOAP obálky s hlavičkou, která obsahuje metadata zprávy a pečeť. Má následující strukturu:
○ Dotazujici
■ Davka
○ DSubjekt
• Dotaz (kolekce)
○ SOAP-Body
○ SOAP-Header
■ Zprava
• SOAP-Envelope
■ Signature
o Chyba (místo DSubjekt a Ucet)
o Ucet (0..n)
■ Dotazujici
o Odpovidajici
■ Signature
○ SOAP-Body
2) Odpověď je zabalena do SOAP obálky s hlavičkou, která obsahuje metadata zprávy a pečeť. Na každý dotaz je vytvořena právě jedna odpověď. Odpověď obsahuje tělo dotazu. Odpověď má následující strukturu:
■ Zprava
○ SOAP-Header
o DSubjekt
o Dotaz
• Odpoved (kolekce)
■ Dsubjekt
• SOAP-Envelope
■ Davka

C) Obsah datové zprávy
1) Dotaz obsahuje prvky Davka, Dotaz, Dotazujici a DSubjekt ve struktuře podle části B. Každý prvek se skládá z atributů.
2) Odpověď obsahuje prvky Davka, Odpoved, Dotaz, Dotazujici, DSubjekt, Odpovidajici, Ucet a Chyba. Prvky Davka, Dotaz, Dotazujici a DSubjekt jsou stejné jako v dotazu. Prvek Dotaz je kopií přijatého dotazu. Prvek DSubjekt v prvku Odpoved je tvořen z dat peněžního ústavu, ne kopií dotazu.

Prvek	Atribut	Max. počet znaků	Popis pole
Dotaz	TypDotazu	2	Typ dotazu, vždy vyplněno hodnotou “02”.
Dotaz	KodDotazu	10	Jedinečný kód dotazu generovaný dotazujícím se orgánem pomoci v hmotné nouzi.
Dotazujici, Odpovidajici	Cislo	8	Identifikace odpovědné osoby, v dotazu číslo pracovníka orgánu pomoci v hmotné nouzi, v odpovědi identifikace pracovníka peněžního ústavu.
Dotazujici, Odpovidajici	Jmeno	40	Titul, jméno a příjmení dotazujícího se nebo odpovídajícího pracovníka.
DSubjekt	Typ	1	Vždy vyplněno jako “F”, fyzická osoba.
Dsubjekt	ICO	10	Není využíváno.
Dsubjekt	RC	10	Rodné číslo bez lomítka, devítimístné rodné číslo zůstává na 9 znaků.
Dsubjekt	Jmeno	40	Vyplněno pouze v odpovědi.
Dsubjekt	Ulice	50	Vyplněno pouze v odpovědi.
Dsubjekt	Obec	50	Vyplněno pouze v odpovědi.
Dsubjekt	PSC	5	Vyplněno pouze v odpovědi.
Ucet	CisloUctu1	6	Nepovinné pole, je-li předčíslí rovno nule, není nutno jej uvádět. V předčíslí mohou být uvedeny úvodní nuly. Úvodní nuly jsou nevýznamové. Pole je variabilní délky.
Ucet	CisloUctu2	10	Základní části čísla účtu. Mohou být uvedeny úvodní nuly. Úvodní nuly jsou nevýznamové. Pole je variabilní délky.
Ucet	KodBanky	4	Kód peněžního ústavu podle číselníku ČNB AP – 0001 s úvodními nulami.
Ucet	SpecSymbolCS	max. 10 znaků	Není využíváno.
Ucet	TypUctu	1	Vyplní se hodnotou “B” pro běžný účet, “V” pro vkladový účet, “J” pro jiný účet a “X” pro chráněný účet.
Ucet	KodMeny	3	ISO kód měny, ve které je veden účet.
Ucet	Zustatek	15	V jednotkách dané měny, přičemž poslední 2 místa oddělená desetinnou čárkou jsou desetinná místa příslušné měnové jednotky; bez úvodních nul, záporný zůstatek se znaménkem minus.
Ucet	Datum	10	Datum zůstatku na účtu.

3) Atributy prvků dotazu a odpovědi jsou vyplněny podle následujících pravidel:

A) Specifikace způsobů odpovědi zaměstnavatele na výzvu orgánu pomoci v hmotné nouzi
1) Zaměstnavatel využívá pro odpověď na výzvu orgánu pomoci v hmotné nouzi tyto způsoby:
2) Specifikace způsobu odpovědi zaměstnavatele na výzvu orgánu pomoci v hmotné nouzi s využitím odeslání doplněného XML souboru z datové schránky zaměstnavatele:
3) Specifikace způsobu odpovědi zaměstnavatele na výzvu orgánu pomoci v hmotné nouzi prostřednictvím webového formuláře, dostupného v odkazu uvedeném ve výzvě při využití webového formuláře vyžaduje autentizaci zaměstnavatele prostřednictvím Informačního systému datových schránek, nebo datovou schránkou osoby, kterou zaměstnavatel zmocní prostřednictvím elektronické služby „Správa plných mocí“ ePortálu České správy sociálního zabezpečení.
4) Specifikace způsobu odpovědi zaměstnavatele na výzvu orgánu pomoci v hmotné nouzi prostřednictvím přímého volání služby založené na standardu GovTalk:

B) Formát
Odpověď zaměstnavatele je orgánem pomoci v hmotné nouzi přijímána výhradně ve formátu XML.

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

Atribut	Typ	Popis
UUID	string	Unikátní identifikátor výzvy.
cisloJednaci	string	Číslo jednací výzvy k poskytnutí příjmů.
rodneCislo	string	Rodné číslo zaměstnance.
Jmeno, prijmeni	string	Jméno a příjmení zaměstnance.
datumNarozeni	Datum	Datum narození zaměstnance.
ikMPSV	string	Unikátní identifikátor zaměstnance.
Prijmy	kolekce	Kolekce příjmů po jednotlivých měsících.
vysePrijmuKodA1	int	Příjmy ze závislé činnosti vykonávané v České republice (Příjmy ze závislé činnosti a funkční požitky uvedené v zákoně o daních z příjmů).
vysePrijmuKodAB	int	Příjmy získané z náhrady mzdy (platu, odměny) za dobu prvních 14 dnů dočasné pracovní neschopnosti (karantény) podle § 192 odst. 2 zákoníku práce (kód ab).
vysePrijmuKodA1Mena, vysePrijmuKodABMena	Měny, číselník	Číselník měn, kódy podle normy ISO 4217.
rok, mesic	int	Rok a měsíc, za který daný příjem náleží, podle výzvy.
prijemOd, prijemDo	Datum	Data období, za které v daném roce a daném měsíci příjem náleží.
bylZamestnancem	boolean	TRUE pokud byl alespoň část dotazovaného období zaměstnancem, jinak FALSE.

2) Datové typy

Datum

Textový řetězec data ve formátu RFC 3339, section 5.6, YYYY-MM-DD.

Měny – jako klíč číselníku Měny je využíván kód měny podle normy ISO 4217.
3) Číselníky

A) Specifikace způsobů odpovědi dodavatele plynu nebo elektřiny na výzvu orgánu pomoci v hmotné nouzi
1) Dodavatel plynu nebo elektřiny odešle odpověď na výzvu orgánu pomoci v hmotné nouzi jako JSON soubor ve formátu podle části B z datové schránky dodavatele plynu nebo elektřiny.
2) Specifikace způsobu odpovědi dodavatele plynu nebo elektřiny na výzvu orgánu pomoci v hmotné nouzi s využitím odeslání JSON souboru ve formátu podle části B z datové schránky dodavatele plynu nebo elektřiny:

B) Formát
Odpověď dodavatele plynu nebo elektřiny je orgánem pomoci v hmotné nouzi přijímána výhradně ve formátu JSON.

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

Pole	Typ	Popis
id	string	Id výzvy, na niž je odpovídáno.
supplierId	string	Každý dodavatel plynu nebo elektřiny obdrží jednoznačný identifikátor od Ministerstva práce a sociálních věcí.
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 se žá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/clientId	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.
Data/pointOfDelivery	object	Data odběrného místa.
Data/pointOfDelivery/ean	string	Číslo odběrného místa elektřiny, pokud jde o elektřinu, jinak neuvedeno.
Data/pointOfDelivery/eic	string	Číslo odběrného místa plynu, pokud jde o plyn, jinak neuvedeno.
Data/pointOfDelivery/ruianId	string	Identifikátor adresy v RUIAN.
Data/pointOfDelivery/commodity	string, enum	Komodita. Typ komodity podle číselníku uvedeného v bodu 3.
data/transactions	array	Částky pro požadované období podle výzvy. Typ částky podle číselníku uvedeného v bodu 3.
data/transactions/month	string	Měsíc a rok, podle formátu ISO 8061 (YYYY-MM).
Data/transactions /trType	string, enum	Typ částky. Typ částky podle číselníku uvedeného v bodu 3.
data/transactions/amount	number	Výše částky.
Status	string	Dle číselníku Status uvedeného v bodu 3. Pokud je uveden status NOT_CLIENT, celá část “data” není uvedena.

2) Datové typy

month

Textový řetězec data ve formátu ISO 8061 YYYY-MM.

Kód	Typ komodity
E	elektřina
G	plyn

Status:
3) Číselníky

Kód	Popis
OK	Nemusí být uveden, vše v pořádku.
NOT_CLIENT	Klient v žádné části požadovaného období nebyl majitelem daného odběrného místa.
NOT_CLIENT_FULL_TIME	Klient je/byl majitelem tohoto odběrného místa, ale ne pro celé požadované období – pro dané odběrné místo tedy mohou být data vrácena jen pro část požadovaného období.

Typ komodity:
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 zákazníka)	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 vrácení, to znamená 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ů).