(microsoft word - sfiz - tehni\350na dokumentacija - redi ... - tehnična... · web...

$: (Microsoft Word - SFIZ - Tehni\350na dokumentacija - REDI ... - Tehnična... · Web viewRegistracija podataka – elemenata (struktura) koje će nositelji međusobno razmjenjivati$
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


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



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.


Slika 1 - Koncept sinkronizacije osoba i razmjene na primjeru ZPIZ - drugi nositelj osiguranja

Irina, 05/08/15,

Nositelj osiguranja


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).


2 Opis procesa razmjene podataka među nositeljima osiguranja

Irina, 05/08/15,

Registracija nositelja osiguranjaRegistracija osoba Slanje izmjena i obavješćivanjeNZ1 Registracija podataka (eZahtjev REDI-001) Popis za potvrđivanje registracija Potvrđivanje registracija (eZahtjev REDI-003) Poslane izmjene (REDI-004)NZ2 Start Registriraj osobe (eZahtjev REDI-002) Preuzimanje izmjenaEndSustav REDI Registracija nositelja Registriranje podataka Registriranje osobe i priprema popisa za potvrđivanje Potvrđivanje registracijaObrada izmjena


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.



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


Nositelj osiguranja NZ2

Portal

HTTPS

Irina, 05/08/15,

BPM Uređivanje sink.WAS Registracija osobaSFIZSSRG1000SOAP (HTTPS)Reg. OsobaBROKERAžuriranje osobeARMSFIZSS001001IzmjeneSFIZSSRGU000SOAP (HTTPS)SOAP (HTTPS)IzmjeneMQObavješćivanjeDBRegistar osobaORACLERegistar REDI


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:


http://ws.sfizssrgi000.zpiz.si/

http://schemas.xmlsoap.org/soap/envelope/


<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.


institutionFrom String Nositelj koji potvrđuje zahtjeve

institutionTo String Nositelj za kojeg su zahtjevi

xmIR XML Ulazni XML s podacima osoba


<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>


http://schemas.xmlsoap.org/soap/encoding/

http://www.w3.org/2001/XMLSchema-

http://www.w3.org/2001/XMLSchema










<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:


<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"









http://www.w3.org/2001/XMLSchema-instance









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.


Institution String Nositelj osiguranja

xmlF XML Popis za postavljanje zastavica


<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:


<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











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.


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


http://ws.sfizssrgu000.zpiz.si/


http://schemas.xmlsoap/



http://schemas/

http://ws.sfizssrgi000/



String Funkcija vraća XML strukturu za registraciju podataka (prepareXML2Send(XML-S).xsd).

Primjer odgovora:


<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.


institution String Nositelj osiguranja

ident String Njegov identifikator

identVal String Vrijednost identifikatora


<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:


<ns1:checkFlag4MeResponse xmlns:ns1="http://ws.sfizssrgu000.zpiz.si"><return>1</return> </ns1:checkFlag4MeResponse> </soapenv:Body>

</soapenv:Envelope>















4.4.3 saveDataXML

Metoda za slanje izmjena u sustav.


Parameter Tip Opisinstitution Nositelj koji šalje podatkexmlS Podaci u XML-S strukturi.


<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:


<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











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


<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:


<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


http://ws.sfizssrgu000/










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


https://www.zpiz.si/bizpiz-test/SFIZSSRGU000/services/Sfizssrgu000ServiceWS/WEB-

https://www.zpiz.si/bizpiz-test/SFIZSSRGI000/services/Sfizssrgi000ServiceWS/WEB-

https://www.zpiz.si/bizpiz-

http://schemas.xmlsoap/



http://schemas/

(microsoft word - sfiz - tehni\350na dokumentacija - redi ... - tehnična... · web...

Documents