Upload
dangliem
View
218
Download
0
Embed Size (px)
Citation preview
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
SFIZ - Razmjena podataka među nositeljima osiguranja
Tehnička dokumentacija
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS
Verzija: 1.1
Datum zadnje izmjene: 1. 12. 2014.
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 1 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
Povijest dokumenta
Verzije
# Oznaka verzije Izmjene Autori Datum
1.0 Osnovni dokument Domen Dolar 8. 2. 2014.
1.1 Dopunjeno Dopunjeni servisi. Domen Dolar 1. 12. 2014.
Kazalo
1 Uvod.................................................................................................................................................4
2 Opis procesa razmjene podataka među nositeljima osiguranja.......................................................5
3 Rješenje razmjene među nositeljima osiguranja.............................................................................6
4 Internetske usluge REDI za razmjenu podataka.............................................................................7
4.1 Lokacija internetskih usluga.....................................................................................................7
4.2 Prijava u sustav SFIZSS001001ServicesWS – dobivanje žetona GUID.................................7
4.3 Servis Sfizssrgi000ServiceWS.................................................................................................7
4.3.1 prepareXML2Register......................................................................................................74.3.2 registerDataXML.............................................................................................................84.3.3 getFlag4Me......................................................................................................................94.3.4 setFlag4Me.....................................................................................................................104.3.5 getVersion......................................................................................................................11
4.4 Servis Sfizssrgu000ServiceWS..............................................................................................13
4.4.1 prepareXML2Send.........................................................................................................134.4.2 checkFlag4Me................................................................................................................144.4.3 saveDataXML ...............................................................................................................144.4.4 getChangesDataXML.....................................................................................................154.4.5 getVersion......................................................................................................................16
5 Prilzi...............................................................................................................................................18
5.1 SFIZSS001001 ServicesWS WSDL......................................................................................18
5.2 Sfizssrgi000ServiceWS WSDL.............................................................................................18
5.3 Sfizssrgu000ServiceWS WSDL.............................................................................................18
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 2 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
1 Uvod
Sustav za razmjenu podataka među nositeljima osiguranja omogućuje sljedeće funkcije:
1. Registracija podataka – elemenata (struktura) koje će nositelji međusobno razmjenjivati. Ideja je u tome da svaki nositelj za sebe kaže koje podatke želi dobivati od ostalih nositelja. Oni se zatim određuju i putem sporazuma među nositeljima.
2. Registracija osoba u sustav. Nositelj u sustav šalje podatke o osobama (svoj i tuđi identifikator) za koje želi dobivati neke podatke od ostalih nositelja. Na osnovi registracije osoba taj se popis zatim (sustav zastavica) prosljeđuje nositeljima od kojih želimo dobivati izmjene.
3. Sinkronizacija osoba kod koje nositelj potvrđuje popis osoba. Prilikom potvrđivanja može taj popis povezati sa svojim informatičkim sustavom za automatsko slanje izmjena.
4. Slanje izmjena u sustav i provjeravanje izmjena kod kojeg nositelji šalju određene izmjene na osobama te preuzimaju izmjene koje drugi nositelji pošalju njima.
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 3 od 18
Slika 1 - Koncept sinkronizacije osoba i razmjene na primjeru ZPIZ - drugi nositelj osiguranja
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
Slika 2 – Postupak razmjene podataka
Opis postupaka opisan je u dokumentima:1. SFIZ – REDI- Registracija nositelja osiguranja.doc. Glavni je zadatak tog postupka
određivanje podataka za razmjenu i priprema korisničkih pristupa. Riječ je o jednokratnoj aktivnosti.
a. Registracija nositelja – upis podataka korisnika u sustav (podaci digitalnih potvrda). Ti se podaci zatim upotrebljavaju prilikom prijave u sustav.
b. Registracija podataka koje pojedini nositelj želi primati. Svaki nositelj to čini za sebe. Govori koji su identifikatori (EMŠO, OIB, JMBG ...) i koji su podaci za praćenje.
c. Prilikom registracije podataka samo se oni upisuju u sustav. Oni se šalju putem eZahtjeva.
2. SFIZ - REDI- Registracija osoba u sustav.doc. Glavni je zadatak tog postupka međusobno uparivanje identifikatora za pojedine osobe. Riječ je po postupku koji se obično obavi jednom na godinu za pojedinog nositelja.
a. Prilikom registracije osoba nositelj osiguranja u sustav za osobe koje želi pratiti šalje svoj identifikator i identifikator nositelja od kojeg želi primati izmjene. Upisom u sustav pripremljen je popis osoba za drugog nositelja koji ga pregledava.
b. Drugi nositelj preuzima popis, provjerava ga u svojem sustavu i šalje natrag(potvrđuje registraciju) putem eZahtjeva. Time je set osoba koje prvi nositelj želi pratiti potvrđen od drugog nositelja i dnevno obavješćivanje može započeti.
3. SFIZ - REDI- Slanje izmjena i obavješćivanje.doc. U ovom je postupku riječ o izvješćivanju o izmjenama podataka i njihovom preuzimanju. Riječ je o aktivnostima koje će se obavljati vrlo često (dnevno, tjedno).
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 4 od 18
2 Opis procesa razmjene podataka među nositeljima osiguranja
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
a. Drugi nositelj osiguranja šalje izmjene podataka u sustav za osobe koje je potvrdio na popisu za potvrdu registracija. Šalje set podataka koji je prethodno i odredio. Te se izmjene spremaju u sustavu.
b. Prvi nositelj provodi periodične upite. Ako se u odabranom razdoblju pojave neki podaci za njega, on ih preuzima u svoj sustav.
c.
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 5 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
3 Rješenje razmjene među nositeljima osiguranja
Rješenje razmjene temelji se na upotrebi internetskih usluga putem sigurnih puteva. Usluge su dostupne putem HTTPS poveznice upotrebom digitalnih potvrda.
Pripremljene su sljedeće usluge:1. Usluga za registraciju osoba (sinkronizacija identifikatora). Usluga sadržava metode
registerDataXML za uspostavljanje osobe,setFlag4me i getFlag4me za potvrđivanje i pregled popisa.
2. Usluga za slanje i pregled izmjenagetFlag4me za provjeravanje trebaju li se podaci slati u sustav,saveDataXML za slanje izmjena,
getChangesDataXML za pregled izmjena.
Nositelj osiguranja NZ1
eZahtjeva - BiZPIZ1 Registracija podataka2 Registriraj osobe3 Potvrđivanje registracija
Slika 3 - Aplikativna arhitektura razmjene
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 6 od 18
Nositelj osiguranja NZ2
Portal
HTTPS
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
4 Internetske usluge REDI za razmjenu podataka
4.1 Lokacija internetskih usluga
Servisi se nalaze na lokaciji:
https://<ZPIZ>/SFIZSS001001/SFIZSS001001ServicesWS?wsdlhttps://<ZPIZ>/SFIZSSRGI000/services/Sfizssrgi000ServiceWS?wsdlhttps://<ZPIZ>/SFIZSSRGU000/services/Sfizssrgu000ServiceWS?wsdl
4.2 Prijava u sustav SFIZSS001001ServicesWS - dobivanje žetona GUID
Za prijavu u sustav upotrebljava se servis SFIZSS001001ServicesWS koji je opisan u dokumentu SFIZ - Tehnička dokumentacija - SFIZSS001001 Prijava u sustav-v.1.1.doc.
4.3 Servis Sfizssrgi000ServiceWS
Servis je namijenjen za registraciju osoba u sustav i njihovo potvrđivanje.
4.3.1 prepareXML2Register
Metoda omogućuje čitanje strukture XML putem koje registriramo osobe u sustav.
4.3.1.1 Parametri za poziv (Request)Parametar Tip Opisguid String Identifikacijski žeton
institutionFrom String Nositelj koji šalje zahtjeve
institutionTo String Nositelj za kojeg su zahtjevi
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgi000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:prepareXML2Register><institutionFrom>ZPIZOLD</institut ionFrom>
<institutionTo>NOSILEC2OLD</institutionTo> <guid>B48DC6F7-EFA9-9C4E-2401-2FD60364B309</guid> </ws:prepareXML2Register> </soapenv:Body>
</soapenv:Envelope>
4.3.1.2 Odgovor (Response)Tip OpisString Funkcija vraća XML strukturu za registraciju podataka
(prepareXML2Register(XML-R) .xsd).
Primjer odgovora:
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 7 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:prepareXML2RegisterResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"><return> <! [CDATA[<EXDATA><REGISTER_LIST><REGISTER><IDENT_LIST><IDENT NAME="EMSOSL"
INST="ZPIZOLD">SLO EMSO(dužina 13 znakova) M:0 T:C L:13</IDENT><IDENT NAME="PSTEVILKA" INST="ZPIZOLD">ZPIZ broj (dužina 10 znakov-brez presledkov) M:1 T:C L:10</IDENT><IDENT NAME="NOSILEC2-STEV" INST="NOSILEC2OLD">NOSILEC2 številka (11 mestna) M:1 T:C L:10</IDENT><IDENT NAME="EMSONOSILEC2" INST="NOSILEC2OLD">NOSILEC2 EMSO številka M:0 T:C L : 13</IDENT></IDENT_LIST><DATA_LIST><DATA NAME= "NASLOV" INST= "NOSILEC2OLD ">Naslov osebe M:0 T : C L : 30</DATA></DATA_LIST><EDATA_LIST><EDATA NAME="DATE_DEATH" INST= "NOSILEC2OLD">Date of death (dd.mm.yyyy) M:1 T:D L:10</EDATA ><EDATA NAME="UZIVALEC" INST="NOSILEC2OLD">Ime in priimek osebe M:1 T:C L:60</EDATA ></EDATA_LIST></REGISTER></REGISTER_LIST></EXDATA>]] </return> </ns1:prepareXML2RegisterResponse> </soapenv:Body> </soapenv:Envelope>
4.3.2 registerDataXML
Metoda omogućuje registraciju osobe u sustav.
4.3.2.1 Parametri za poziv (Request)Parametar Tip Opisguid String Identifikacijski žeton
institutionFrom String Nositelj koji potvrđuje zahtjeve
institutionTo String Nositelj za kojeg su zahtjevi
xmIR XML Ulazni XML s podacima osoba
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgi000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:registerDataXML><institutionFrom>ZPIZOLD</institut ionFrom> <institutionTo>NOSILEC2OLD</institutionTo>
<xmlR> ! [CDATA[<EXDATA><REGISTER_LIST><REGISTER><IDENT_LIST><IDENT NAME= "EMSOSL" INST="ZPIZOLD">1234567890123</IDENT><IDENT NAME="PSTEVILKA" INST="ZPIZOLD">1234567890</IDENT><IDENT NAME="NOSILEC2-STEV"INST="NOSILEC2OLD">12345678901</IDENT></IDENT_LIST><DATA_LIST><DATA NAME="NASLOV" INST= "NOSILEC2OLD">Naslov osebe za NOSILEC2</DATA></DATA_LIST><EDATA_LIST><EDATA NAME="UZIVALEC" INST="NOSILEC2OLD">Ime in priimek za NOSILEC2</EDATA ></EDATA_LIST></REGISTER></REGISTER_LIST></EXDATA>]]></xmlR> _____________<guid>B48DC6F7-EFA9-9C4E-2401-2FD60364B309</guid>__________________________________________
</ws:registerDataXML> </soapenv:Body> </soapenv:Envelope>
4.3.2.2 Odgovor (Response)Tip OpisString Servis kao odgovor vraća XML -
ZPIZ_ODGOVOR_OUT (ZPIZOdgovorServis- v.1.1.xsd). Ako je osoba uspješno unesena, vraća 1, a u slučaju grešaka -1.
Primjer dobrog odgovora:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 8 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
<ns1:registerDataXMLResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"> <return><![CDATA[<?xml version="1.0" encoding="UTF-8"?> OdgovorServis xmlns:xsi="http://www .w3.org/2001 /XMLSchema-instance "xsi:noNamespaceSchemaLocation="ODGOVOR.xsd"><Odgovor Rezultat="1"><ObvestiloSeznam><Obvestilo koda=""/></ObvestiloSeznam></Odgovor></OdgovorServis>]]></return> </ns1:registerDataXMLResponse> </soapenv:Body> </soapenv:Envelope>
Primjer odgovora s greškom:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:registerDataXMLResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"> <return><![CDATA[<?xml version="1.0" encoding="UTF-8"?> OdgovorServis xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="ODGOVOR.xsd"><Odgovor Rezultat="-1"><NapakaSeznam><Napaka element="" koda="::ERR321">Napaka pri podatkih / mandatory / dolžina IDENT</Napaka></NapakaSeznam><ObvestiloSeznam><Obvestilo koda=""/></ObvestiloSeznam></Odgovor></OdgovorServis>]]></return>
</ns1:registerDataXMLResponse> </soapenv:Body> </soapenv:Envelope> </soapenv:Envelope>
4.3.3 getFlag4Me
Metoda vraća popis svih osoba koje su namijenjene za upisanog nositelja osiguranja.
4.3.3.1 Parametri za poziv (Request)Parameter Tip Opisguid String Identifikacijski žeton
institution String Nositelj osiguranja
flag String 0,1 (0 - samo one koje nisu potvrđene, 1-samo potvrđene) - neobvezno polje
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:ws="http://ws.sfizssrgi000.zpiz.si">
<soapenv:Header/> <soapenv:Body><ws:getFlag4Me>
<institution>NOSILEC2OLD</institution> <guid>B4 8DC6F 7-EFA9-9C4E-2 401-2FD60364B309</guid> </ws:getFlag4Me> </soapenv:Body> </soapenv:Envelope>
4.3.3.2 Odgovor (Response)Tip OpisString Funkcija vraća popis u XML obliku - XML-F
(getFlag4Me(XML-F).xsd)Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:getFlag4MeResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"><return><! [CDATA[ :EXDATA><FLAG_LIST><FLAG><INST>ZPIZOLD</INST><IDENT_LIST><IDENT
NAME="EMSONOSILEC2" INST="NOSILEC2OLD">12345NOSILEC2EMSO12</IDENT><IDENT NAME="NOSILEC2-STEV" INST="NOSILEC2OLD">NOSILEC2123456</IDENT><IDENT NAME="EMSOSL" INST="ZPIZOLD">12345EMSO1234</IDENT><IDENT NAME="PSTEVILKA"
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 9 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
INST="ZPIZOLD">ZPIZ123456</IDENT></IDENT_LIST><FLAGYN>0</FLAGYN><DATE_FROM/><DATE_TO/><SF_STATU S/><TX_NOTE/></FLAG></FLAG_LIST></EXDATA>]]></return> </ns1:getFlag4MeResponse> </soapenv:Body> </soapenv:Envelope>
4.3.4 setFlag4Me
Metoda za postavljanje zastavica osobama.
4.3.4.1 Parametri za poziv (Request)Parametar Tip Opisguid String Identifikacijski žeton
Institution String Nositelj osiguranja
xmlF XML Popis za postavljanje zastavica
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgi000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:setFlag4Me><institution>NOSILEC2OLD</institution> <xmlF><! [CDATA[
:EXDATA><FLAG_LIST><FLAG><INST>ZPIZOLD</INST><IDENT_LIST><IDENT NAME="EMSONOSILEC2" INST="NOSILEC2OLD">123NOSILEC2EMSO12</IDENT><IDENT NAME="NOSILEC2-STEV" INST="NOSILEC2OLD">NOSILEC2123</IDENT><IDENT NAME="EMSOSL" INST="ZPIZOLD">12345EMSO1234</IDENT><IDENT NAME="PSTEVILKA"INST="ZPIZOLD">ZPIZ123456</IDENT></IDENT_LIST><FLAGYN>1</FLAGYN><DATE_FROM>2012-1- 1</DATE_FROM><DATE_TO>2015-1-1</DATE_TO><SF_STATUS>01</SF_STATUS><TX_NOTE>Person exists</TX_NOTE></FLAG></FLAG_LIST></EXDATA ]]></xmlF>
<guid>B48DC6F 7-EFA9-9C4E-2 401-2FD60364B309</guid> </ws:setFlag4Me> </soapenv:Body>
</soapenv:Envelope>
4.3.4.2 Odgovor (Response)Tip Opis
String Servis kao odgovor vraća XML - ZPIZ_ODGOVOR_OUT (ZPIZOdgovorServis- v.1.1.xsd). Ako je osoba uspješno unesena, vraća 1, a u slučaju grešaka -1.
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:setFlag4MeResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"><return><![CDATA[<?xml version=n1.0" encoding="UTF-8"?><OdgovorServis
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="ODGOVOR.xsd"><Odgovor Rezultat="1"><ObvestiloSeznam><Obvestilo koda=""/></ObvestiloSeznam></Odgovor></OdgovorServis>]]></return> </ns1:setFlag4MeResponse> </soapenv:Body> </soapenv:Envelope>
4.3.5 getVersion
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 10 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
Provjeravanje verzije servisa.
4.3.5.1 Parametri za poziv (Request)Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv= "http://schemas.xmlsoap.org/soap/envelope/"xmlns:ws="http://ws.sfizssrgi000 .zpiz.si">
<soapenv:Header/><soapenv:Body>
<ws:getVersion/></soapenv:Body>
</soapenv:Envelope>
4.3.5.2 Odgovor (Response)Tip OpisString Funkcija vraća verziju servisa
Primjer odgovora:<soapenv:Envelope xmlns:soapenv="http://schemas xmlsoap.org/soap/envelope/"xmlns:xsd="http://www. w 3. org /2001/XMLSchema " xmlns:xsi="http://www. w 3. org /2001/XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap org/soap/encoding/">
<soapenv:Body><ns1:getVersionResponse xmlns:ns1="http:/ 'ws.sfizssrgu000.zpiz.si">
<return>v.0.201401270730</return></ns1:getVersionResponse>
</soapenv:Body></soapenv:Envelope>
4.4 Servis Sfizssrgu000ServiceWS
Servis je namijenjen za obavješćivanje o izmjenama u sustavu i njihovo pregledavanje.
4.4.1 prepareXML2Send
Metoda omogućuje čitanje strukture XML putem koje obavješćujemo i izmjenama.
4.4.1.1 Parametri za poziv (Request)Parameter Tip Opisguid String Identifikacijski žeton
institution String Nositelj osiguranja koji će poslati podatke u sustav.
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgu000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:prepareXML2Send><institution>NOSILEC2OLD</institution> <guid>B48DC6F7-EFA9-
9C4E-2401-2FD60364B309</guid> </ws:prepareXML2Send> </soapenv:Body> </soapenv:Envelope>
4.4.1.2 Odgovor (Response)Tip Opis
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 11 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
String Funkcija vraća XML strukturu za registraciju podataka (prepareXML2Send(XML-S).xsd).
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:prepareXML2SendResponse xmlns:ns1="http://ws.sfizssrgu000.zpiz.si"> <return> <! [CDATA[<EXDATA><REGISTER_LIST><REGISTER><IDENT_LIST><IDENT NAME="EMSONOSILEC2" INST="NOSILEC2OLD">NOSILEC2 EMSO številka M:0 T:C L:13</IDENT><IDENT NAME="NOSILEC2-STEV" INST="NOSILEC2OLD">NOSILEC2 številka (11 mestna) M:1 T:C L:10</IDENT></IDENT_LIST><DATA_LIST><DATA NAME="DAT_ROJ" INST= "ZPIZOLD">Datum dojstva (dd.mm.yyyy) M:1 T:D L:10</DATA><DATA NAME="NASLOV" INST="ZPIZOLD">Naslov osebe M:1 T:C L:40</DATA></DATA_LIST><EDATA_LIST><EDATA NAME="DATE_DEATH" INST="ZPIZOLD">Date of death (dd.mm.yyyy) M:1 T:D L:10</EDATA ><EDATA NAME="UZIVALEC" INST="ZPIZOLD">Ime in priimek osebe M:1 T:C L:60</EDATA ></EDATA_LIST></REGISTER></REGISTER_LIST></EXDATA>]] </return> </ns1:prepareXML2SendResponse> </soapenv:Body> </soapenv:Envelope>4.4.2 checkFlag4Me
Metoda putem koje se provjerava moramo li za osobu slati podatke u sustav.
4.4.2.1 Parametri za poziv (Request)Parameter Tip Opisguid String Identifikacijski žeton
institution String Nositelj osiguranja
ident String Njegov identifikator
identVal String Vrijednost identifikatora
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgu000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:checkFlag4Me><institution>NOSILEC2OLD</institution><ident>NOSILEC2-STEV</ident><identVal>NOSILEC2123</identVal><guid>B48DC6F7-EFA9-9C4E-2401-2FD60364B309</guid>
</ws:checkFlag4Me> </soapenv:Body> </soapenv:Envelope>
4.4.2.2 Odgovor (Response)Tip OpisString Funkcija vraća:
- 1 – Osoba postoji- 0 – Nije potrebno slati podatke
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:checkFlag4MeResponse xmlns:ns1="http://ws.sfizssrgu000.zpiz.si"><return>1</return> </ns1:checkFlag4MeResponse> </soapenv:Body>
</soapenv:Envelope>
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 12 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
4.4.3 saveDataXML
Metoda za slanje izmjena u sustav.
4.4.3.1 Parametri za poziv (Request)Parameter Tip Opisguid String Identifikacijski žeton
Parameter Tip Opisinstitution Nositelj koji šalje podatkexmlS Podaci u XML-S strukturi.
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgu000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:saveDataXML><institution>NOSILEC2OLD</institution><xmlS><![CDATA[ EXDATA><REGISTER_LIST><REGISTER><IDENT_LIST><IDENT NAME="EMSONOSILEC2"
INST="NOSILEC2OLD">123NOSILEC2EMSO12</IDENT></IDENT_LIST><DATA_LIST><DATA NAME="NASLOV" INST= "ZPIZOLD">Naslov osebe 2222</DATA></DATA_LIST><EDATA_LIST><EDATA NAME= "UZIVALEC" INST="ZPIZOLD">Domen Domen</EDATA ></EDATA_LIST></REGISTER></REGISTER_LIST></EXDATA ]]></xmlS> <guid>B48DC6F7-EFA9-9C4E-2401-2FD60364B309</guid> </ws:saveDataXML> </soapenv:Body> </soapenv:Envelope>
4.4.3.2 Odgovor (Response)Tip OpisString Servis kao odgovor vraća XML -
ZPIZ_ODGOVOR_OUT (ZPIZOdgovorServis- v.1.1.xsd). Ako je osoba uspješno unesena, vraća 1, a u slučaju grešaka -1.
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:saveDataXMLResponse xmlns:ns1="http://ws.sfizssrgu000.zpiz.si"><return><![CDATA[<?xml version="1.0" encoding="UTF-8"?><OdgovorServis
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xs i:noNamespaceSchemaLocation="ODGOVOR.xsd"><Odgovor Rezultat="1"><NapakaSeznam><Napaka element="" koda=""></Napaka></NapakaSeznam><ObvestiloSeznam><Obvestilo koda=""/></ObvestiloSeznam></Odgovor></OdgovorServis>]]></return> </ns1:saveDataXMLResponse> </soapenv:Body></soapenv:Envelope>___________________________________________________________________________________
4.4.4 getChangesDataXML
Metoda za čitanje izmjena iz sustava.4.4.4.1 Parametri za poziv (Request)
Parameter Tip Opisguid String Identifikacijski žeton
institutionFrom String Nositelj od kojega očekujemo izmjene
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 13 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
institutionTo String Nositelj kojem su izmjene poslane
Parameter Tip OpisdateFrom Datum Datum od
dateTo Datum Datum do
addReq String 1-pripravi v odgovoru tudi vsebino Zahteve (request). Neobvezno polje
Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.sfizssrgu000.zpiz.si"> <soapenv:Header/> <soapenv:Body>
<ws:getChangesDataXML><institutionFrom>ZPIZOLD</institut ionFrom>
<institutionTo>NOSILEC2OLD</institutionTo> <dateFrom>2013-01-01</dateFrom> <dateTo>2014-01-01</dateTo> <guid>B48DC6F7-EFA9-9C4E-2401-2FD60364B309</guid> </ws:getChangesDataXML> </soapenv:Body> </soapenv:Envelope>
4.4.4.2 Odgovor (Response)Tip OpisString Funkcija vraća XML u obliku XML-R za nositelja
Primjer odgovora:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www .w3.org/2001 /XMLSchema " xmlns:xsi="http://www .w3.org/2001 /XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"> <soapenv:Body>
<ns1:prepareXML2RegisterResponse xmlns:ns1="http://ws.sfizssrgi000.zpiz.si"><return><![CDATA[<EXDATA><REGISTER_LIST><REGISTER><IDENT_LIST><IDENT NAME="NOSILEC2- STEV"
INST="NOSILEC2OLD">NOSILEC2123456</IDENT><IDENT NAME="EMSONOSILEC2"INST= "NOSILEC2OLD ">12345NOSILEC2EMSO12</IDENT></IDENT_LIST><DATA_LIST><DATA NAME= "NASLOV" INST= "NOSILEC2OLD">Naslov osebe 22222</DATA></DATA_LIST><EDATA_LIST><EDATA NAME= "UZIVALEC" INST="NOSILEC2OLD">Domen Domen 222</EDATA></EDATA_LIST></REGISTER></REGISTER_LIST></EXDATA>]]> </return> </ns1:prepareXML2RegisterResponse> </soapenv:Body> </soapenv:Envelope>
4.4.5 getVersion
Provjeravanje verzije servisa.
4.4.5.1 Parametri za poziv (Request)Primjer zahtjeva:<soapenv:Envelope xmlns:soapenv= 'http://schemas.xmlsoap.org/soap/envelope/"xmlns:ws="http://ws.sfizssrgu000 .zpiz.si">
<soapenv:Header/><soapenv:Body>
<ws:getVersion/></soapenv:Body>
</soapenv:Envelope>
4.4.5.2 Odgovor (Response)Tip OpisString Funkcija vraća verziju servisa
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 14 od 18
Internetski servis Sfizssrgi000ServiceWS i Sfizssrgu000ServiceWS TA*AVA
Primjer odgovora:<soapenv:Envelope xmlns:soapenv="http://schemas xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www. w 3. org /2001/XMLSchema " xmlns:xsi="http://www. w 3. org /2001/XMLSchema- instance" xmlns:soapenc="http://schemas.xmlsoap org/soap/encoding/">
<soapenv:Body><ns1:getVersionResponse xmlns:ns1="http:/ 'ws.sfizssrgu000.zpiz.si">
<return>v.0.201311291030</return></ns1:getVersionResponse>
</soapenv:Body></soapenv:Envelope>
5 Prilozi
5.1 SFIZSS001001ServicesWS WSDL
https :// www . zpiz . si / bizpiz - test/SFIZSS001001/SFIZSS001001 ServicesWS/SFIZSS001001 ServicesWS.wsdl
5.2 Sfizssrgi000ServiceWS WSDL
https://www.zpiz.si/bizpiz-test/SFIZSSRGI000/services/Sfizssrgi000ServiceWS/WEB- INF/wsdl/Sfizssrgi000ServiceWS.wsdl
5.3 Sfizssrgu000ServiceWS WSDL
https://www.zpiz.si/bizpiz-test/SFIZSSRGU000/services/Sfizssrgu000ServiceWS/WEB- INF/wsdl/Sfizssrgu000ServiceWS.wsdl
SFIZ – Razmjena podataka među nositeljima osiguranja - Tehnička dokumentacija Stranica 15 od 18