Aquasoft, spol. s r. o.
Popis struktury XML rozhraní pro hromadné hlášení změn pojišťovnami, agenty (PA) a makléři (PM) Pro potřeby České národní banky vypracoval řešitel systému ISPOZ – společnost AQUASOFT, spol. s r.o.
Autor: Aquasoft, spol. s r.o. (www.aquasoft.cz) Verze dokumentu: 1.1 Poslední aktualizace: 7.6.2006 Počet stran dokumentu: 7
1/7
Aquasoft, spol. s r. o.
1 Obsah 1 2 3 4
Obsah ............................................................................................................................... 2 Úvod, účel dokumentu............................................................................................... 2 Důležité pokyny k hromadnému podání žádostí ............................................. 3 Popis struktury XML rozhraní.................................................................................. 4 4.1 Základní struktura souboru ............................................................................. 4 4.2 Identifikace žadatele .......................................................................................... 4 4.3 Popis změn ............................................................................................................. 5 5 Příloha – Příklady hromadného hlášení změn .................................................. 6
2 Úvod, účel dokumentu Tento dokument popisuje strukturu XML rozhraní pro hromadné hlášení změn subjektů zapsaných v registru pojišťovacích zprostředkovatelů a samostatných likvidátorů pojistných událostí. Dokument shrnuje důležité technické pokyny, popisuje základní strukturu XML rozhraní, popisuje použité číselníky a obsahuje ukázku XML souboru s hromadným hlášením změn.
Použité zkratky: Zkratka Popis PZ pojišťovací zprostředkovatel PA pojišťovací agent PM pojišťovací makléř VPA vázaný pojišťovací agent VPZ výhradní pojišťovací zprostředkovatel PPZ podřízený pojišťovací zprostředkovatel EHP Evropský hospodářský prostor PO právnická osoba FO fyzická osoba
2/7
Aquasoft, spol. s r. o.
3 Důležité pokyny k hromadnému podání žádostí
• Aktuální informace k hromadnému hlášení změn se nacházejí na internetové adrese http://ispoz.cnb.cz/. • Nutnou podmínkou hromadného podání žádostí je vytvoření XML souboru s údaji zadávanými v žádosti dle příslušné specifikace. • Popis rozhraní v tomto souboru má spíše vysvětlující charakter. Přesná formální definice struktury rozhraní je k dispozici ve formě XDS schématu na výše uvedené internetové adrese. • Formální správnost sestaveného souboru XML pro hromadné podání lze ověřit vůči XSD schématu, které je zveřejněné na výše uvedené internetové adrese. • Upozorňujeme, že hromadná podání nesplňující předepsaný formát XML nebudou zpracována.
3/7
Aquasoft, spol. s r. o.
4 Popis struktury XML rozhraní 4.1 Základní struktura souboru < HromadneHlaseniZmen>
identifikace žadatele sekvence jednotlivých změn Doplňující informace 1. Dokument lze pořídit v jakémkoli obvyklém kódování (Windows-1250, iso-8859-2, UTF-8 a jiné). Je nutné kódování správně uvést v hlavičce XML souboru. Hlavičku XML souboru je nutno uvést. 2. Záleží na pořadí elementů na stejné hierarchické úrovni. Záleží na hierarchii. 3. Data se uvádějí ve formátu yyyyMMdd (vždy osm znaků). 4. Povinné elementy musejí obsahovat příslušnou hodnotu (nesmějí mít prázdný obsah). 5. Prázdné nepovinné elementy nelze do souboru uvádět. 6. Z důvodu urychlení zpracování nesmí soubor obsahovat XML poznámky (). 7. Formální popis struktury je k dispozici ve formě XSD schématu na internetových stránkách systému ISPOZ – http://ispoz.cnb.cz.
4.2 Identifikace žadatele Na začátku souboru se nachází identifikace žadatele. Pro identifikaci žadatele se použije právě jedna z následujících tří možností. 1. Pokud je žadatelem pojišťovna, vyplní se základní identifikační údaje pojišťovny – název a identifikační číslo - v elementu ZadatelPojistovna. Pojišťovny mohou podávat hromadně změny pro VPZ, VPA a PA.
2. Pokud je žadatelem pojišťovací agent nebo makléř, vyplní se registrační číslo v registru PZ, název v registru a identifikační číslo u PO nebo datum narození u FO do elementu ZadatelPOFO. Pojišťovací agenti a makléři mohou podávat hromadné změny za své PPZ.
4/7
povinné povinné povinné povinné povinné
--> --> --> pro PO--> pro FO-->
Aquasoft, spol. s r. o.
4.3 Popis změn Požadované změny k jednotlivým podřízeným subjektům jsou zaobaleny elementem Subjekt. Popis struktury s komentářem k vyplňování hodnot jednotlivých elementů následuje. Formální popis struktury je k dispozici ve formě XSD schématu na internetových stránkách systému ISPOZ – http://ispoz.cnb.cz. <Subjekt>
povinné povinné povinné povinné povinné povinné
--> --> --> pro PO --> pro FO --> -->
Vysvětlivky ke struktuře popisu změn 1. Povinné elementy jsou vyznačeny. 2. Všechny datumové údaje musí být zadány ve formátu yyyyMMdd.
5/7
Aquasoft, spol. s r. o.
5 Příloha – Příklady hromadného hlášení změn 2 001753PA Urbášek Milan 19440404 <Subjekt> 001752PPZ Urbášek Milan 19440404 <Subjekt> 000002PPZ Novák Jan 19661205 Novy 2 NN 40763587 <Subjekt> 000002PM Kabeš Karel 13763831 Novy <Subjekt>
6/7
Aquasoft, spol. s r. o. 000005PM Čásenský jan 31011100 Novy <Subjekt> 000006VPA AQ Pojist 00123587 Novy
7/7
