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
1 Obsah 1 Obsah... 2 2 Úvod, účel dokumentu... 2 3 Důležité pokyny k hromadnému podání žádostí... 3 4 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
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
4 Popis struktury XML rozhraní 4.1 Základní struktura souboru <?xml version="1.0" encoding="windows-1250"?> < HromadneHlaseniZmen> <!-- povinné --> <PocetSubjektu></ PocetSubjektu > <!-- povinné - vyplní se počet subjektů se změnou --> identifikace žadatele sekvence jednotlivých změn </ HromadneHlaseniZmen > 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 (<!-- txt -->). 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. <ZadatelPojistovna> <!-- povinné --> <Nazev></Nazev> <!-- povinné --> <Ico></Ico> <!-- povinné --> </ZadatelPojistovna> 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. <ZadatelPOFO> <!-- povinné --> <RegistracniCislo></ RegistracniCislo > <!-- povinné --> <Nazev></Nazev> <!-- povinné --> <Ico></Ico> <!-- povinné pro PO--> <DatumNarozeni></ DatumNarozeni > <!-- povinné pro FO--> </ZadatelPOFO> 4/7
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. <!-- povinné --> <RegistracniCislo></ RegistracniCislo> <!-- povinné --> <Nazev></ Nazev> <!-- povinné --> <Ico></Ico> <!-- povinné pro PO --> <DatumNarozeni> </ DatumNarozeni> <!-- povinné pro FO --> <!-- povinné --> <VzdelaniDolozeno></ VzdelaniDolozeno> <Operace></ Operace> <!-- povinné --> </ Zprostredkovatel> 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
5 Příloha Příklady hromadného hlášení změn <?xml version="1.0" encoding="utf-8"?> <HromadneHlaseniZmen xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <PocetSubjektu>2</PocetSubjektu> <ZadatelPOFO> <RegistracniCislo>001753PA</RegistracniCislo> <Nazev>Urbášek Milan</Nazev> <DatumNarozeni>19440404</DatumNarozeni> </ZadatelPOFO> <RegistracniCislo>001752PPZ</RegistracniCislo> <Nazev>Urbášek Milan</Nazev> <DatumNarozeni>19440404</DatumNarozeni> <RegistracniCislo>000002PPZ</RegistracniCislo> <Nazev>Novák Jan</Nazev> <DatumNarozeni>19661205</DatumNarozeni> </HromadneHlaseniZmen> <?xml version="1.0" encoding="utf-8"?> <HromadneHlaseniZmen xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <PocetSubjektu>2</PocetSubjektu> <ZadatelPojistovna> <Nazev>NN</Nazev> <Ico>40763587</Ico> </ZadatelPojistovna> <RegistracniCislo>000002PM</RegistracniCislo> <Nazev>Kabeš Karel</Nazev> <Ico>13763831</Ico> 6/7
<RegistracniCislo>000005PM</RegistracniCislo> <Nazev>Čásenský jan</nazev> <DatumNarozeni>31011100</DatumNarozeni> <RegistracniCislo>000006VPA</RegistracniCislo> <Nazev>AQ Pojist</Nazev> <Ico>00123587</Ico> </HromadneHlaseniZmen> 7/7