Příloha č. 1
účinné od 1. 10. 2025 účinné od 1. 10. 2025Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy
účinné od 1. 10. 2025
účinné od 1. 10. 2025A) Specifikace komunikace mezi peněžním ústavem a orgánem pomoci v hmotné nouzi
účinné od 1. 10. 20251) 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”.
účinné od 1. 10. 20252) 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”.
účinné od 1. 10. 2025B) Formát a struktura datové zprávy
účinné od 1. 10. 2025Datová 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:
účinné od 1. 10. 2025 Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy 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:
účinné od 1. 10. 2025•
účinné od 1. 10. 2025SOAP-Envelope
účinné od 1. 10. 2025○ SOAP-Header
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Zprava
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Signature
účinné od 1. 10. 2025○ SOAP-Body
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Davka
účinné od 1. 10. 2025•
účinné od 1. 10. 2025Dotaz (kolekce)
účinné od 1. 10. 2025○ Dotazujici
účinné od 1. 10. 2025○ DSubjekt
účinné od 1. 10. 20252) 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:
účinné od 1. 10. 2025•
účinné od 1. 10. 2025SOAP-Envelope
účinné od 1. 10. 2025○ SOAP-Header
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Zprava
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Signature
účinné od 1. 10. 2025○ SOAP-Body
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Davka
účinné od 1. 10. 2025•
účinné od 1. 10. 2025Odpoved (kolekce)
účinné od 1. 10. 2025o Dotaz
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Dotazujici
účinné od 1. 10. 2025■
účinné od 1. 10. 2025Dsubjekt
účinné od 1. 10. 2025o Odpovidajici
účinné od 1. 10. 2025o DSubjekt
účinné od 1. 10. 2025o Ucet (0..n)
účinné od 1. 10. 2025o Chyba (místo DSubjekt a Ucet)
účinné od 1. 10. 2025C) Obsah datové zprávy
účinné od 1. 10. 20251) Dotaz obsahuje prvky Davka, Dotaz, Dotazujici a DSubjekt ve struktuře podle části B. Každý prvek se skládá z atributů.
účinné od 1. 10. 2025a) Prvek Davka
účinné od 1. 10. 2025Jeden soubor může obsahovat dotaz na více subjektů. Prvek
Davka obsahuje dotazy na jednotlivé subjekty.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Davka | | identifikace dávky |
| Id | Identifikátor pro podpis – musí být „Davka“ |
| CisloDavky | číslo dávky (dotazu) |
| Pocet | počet dotazů/odpovědí v dávce |
| KodFU | kód dotazujícího se orgánu pomoci v hmotné nouzi |
| JmenoFU | název dotazujícího se orgánu pomoci v hmotné nouzi |
| KodBanky | identifikační kód dotazovaného peněžního ústavu |
| JmenoBanky | název dotazovaného peněžního ústavu |
| DatumCasDotazu | datum a čas generování dotazu |
| CisloDavkyOdpovedi | číslo odpovědi (pouze v odpovědi) |
| DatumCasOdpovedi | datum a čas generování odpovědi (pouze v odpovědi) |
b) Prvek
Dotaz účinné od 1. 10. 2025Prvek Dotaz obsahuje identifikaci osoby a identifikaci dotazujícího se.
účinné od 1. 10. 2025Identifikace dotazu
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Dotaz | | |
| TypDotazu | Uvede se "02" |
| KodDotazu | Kód dotazu |
c) Prvek
Dotazujici účinné od 1. 10. 2025Identifikace dotazující se osoby.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Dotazujici | | |
| Jmeno | Odpovědná osoba, jméno |
| Cislo | Odpovědná osoba, identifikační číslo |
d) Prvek
DSubjekt účinné od 1. 10. 2025Identifikace osoby, které se dotaz týká.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
DSubjekt | | |
| RC | rodné číslo klienta |
| Typ | Typ klienta |
| Jmeno | Jméno |
| Ulice | Ulice |
| Obec | Obec |
| PSC | Poštovní směrovací číslo |
2) Odpověď obsahuje prvky
Davka,
Odpoved,
Dotaz,
Dotazujici,
DSubjekt,
Odpovidajici,
Ucet a
Chyba.
účinné od 1. 10. 2025Prvky 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.
účinné od 1. 10. 2025a) Prvek Odpoved
účinné od 1. 10. 2025Prvek
Odpoved obsahuje data o účtech osoby, které se dotaz týká, případně chybu, pokud peněžní ústav danou osobu nerozpozná.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Odpoved | | Identifikace odpovědi |
| KodDotazu | Kód dotazu |
b) Prvek
Odpovidajici účinné od 1. 10. 2025Identifikace pracovníka odpovědného za správnost a úplnost odpovědi na straně peněžního ústavu.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Odpovidajici | | |
| Jmeno | Jméno |
| Cislo | Číslo pracovníka |
c) Prvek
Ucet účinné od 1. 10. 2025Identifikace účtu. Jeden záznam pro každý jeden nalezený účet.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Ucet | | |
| CisloUctu1 | 1. část čísla účtu |
| CisloUctu2 | 2. část čísla účtu |
| KodBanky | Kód peněžního ústavu |
| SpecSymbolICS | Specifický symbol |
| TypUctu | Typ účtu |
| KodMeny | Měna |
| Zustatek | Zůstatek |
| Datum | Den stanoveného zůstatku |
d) Prvek
Chyba účinné od 1. 10. 2025Prvek
Chyba se vytváří v případě chyby vzniklé při zpracování odpovědi.
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Prvek | Atribut | Popis |
Chyba | | |
| Kod | Chybový kód (následující tabulka) |
| Popis | Text chyby |
V komunikaci mezi orgánem pomoci v hmotné nouzi a peněžním ústavem jsou rozpoznávány tyto chyby s těmito kódy:
Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy Chybový kód | Chybová zpráva | Komentář |
-100 | Chybný kód banky | V headeru dotazu je chybný kód peněžního ústavu, který dotaz přijal. |
-101 | Chybný autentikační kód | Došlo k chybě při kontrole autentikačního kódu, resp. podpisu. |
-200 | Chybný typ dotazu | Typ dotazu je jiný než 01 / 02 / 03 / 04. |
-201 | Chybí identifikace dotazujícího se subjektu | XML element dot:Dotazujici chybí nebo obsahuje některé prázdné atributy. |
-300 | Chybí identifikace klienta | U dotazů typu 01 a 02 chybí element dot:DSubjekt nebo obsahuje pouze prázdné atributy. |
-303 | Chybná identifikace klienta pomocí RČ | U dotazů typu 01 a 02 element dot:DSubjekt obsahuje chybnou hodnotu atributu rodného čísla. |
-304 | Nejednoznačná identifikace klienta prostřednictvím RČ | U dotazů typu 01 a 02 je při generování odpovědi nalezeno více vlastníků (klientů) evidovaných pod jedním rodným číslem. |
3)Atributy prvků dotazu a odpovědi jsou vyplněny podle následujících pravidel:
účinné od 1. 10. 2025 Příloha č. 1 Specifikace komunikace mezi orgány pomoci v hmotné nouzi a peněžním ústavem a formát, obsah a struktura datové zprávy 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. |