Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Spletni servis EPEZSS024000ServicesWS Verzija: 1.0 Datum zadnje spremembe : 1.12.2014
Zgodovina dokumenta Verzije # Oznaka verzije Spremembe Avtorji Datum 1.0 Osnovni dokument Domen Dolar 01.12.2014 Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 2 od 17
Kazalo 1 Lokacija spletni storitev... 4 1.1 Prijava v sistem SFIZSS001001ServicesWS pridobitev žetona GUID... 4 2 Spletna storitev storitev EPEZSS024000ServicesWS... 5 2.1 checkeclaimstatus... 6 2.1.1 Parametri za klic (Request)... 6 2.1.2 Odgovor (Response)... 6 2.2 geteclaim... 8 2.2.1 Parametri za klic (Request)... 8 2.2.2 Odgovor (Response)... 8 2.3 geteclaimlist... 10 2.3.1 Parametri za klic (Request)... 10 2.3.2 Odgovor (Response)... 10 2.4 sendeclaim... 12 2.4.1 Parametri za klic (Request)... 12 2.4.2 Odgovor (Response)... 14 2.5 getversion... 16 2.5.1 Parametri za klic (Request)... 16 2.5.2 Odgovor (Response)... 16 Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 3 od 17
1 Lokacija spletni storitev Servisi se nahajajo na lokaciji: https://<zpiz>/sfizss001001/sfizss001001servicesws?wsdl https://<zpiz>>/epezss024000/epezss024000servicesws?wsdl Sheme, ki se uporabljajo: ZPIZOvojnica-v.2.0.xsd ECLAIM.xsd xmldsig-core-schema.xsd ZPIZOdgovorServis-v.1.2.xsd 1.1 Prijava v sistem SFIZSS001001ServicesWS pridobitev žetona GUID Za prijavo v sistem se uporabi servis SFIZSS001001ServicesWS, ki je opisan v dokumentu SFIZ - Tehnična dokumentacija - SFIZSS001001 Prijava v sistem-v.1.1.doc. Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 4 od 17
2 Spletna storitev storitev EPEZSS024000ServicesWS Spletna storitev je namenjena oddaji evlog direktno preko storitev BiZPIZ in ne preko portala BiZPIZ. Storitev vsebuje naslednje metode: sendeclaim Metoda za oddajo evloge z njenimi priponkami. Pri pripravi evloge mora biti pripravljena tudi ustrezna ovojnica, ki omogoča oddajo dokumenta. V ovojnici je vpisana tudi referenčna oznaka, na podlagi katere se lahko po zajemu kontrolira njeno stanje. checkeclaimstatus Metoda za preverjanje statusa poslane evloge. Pri vhodnem parametru se vpiše referenčno oznako vloge na podlagi katere sistem vrne njen status. geteclaimlist Metoda za preverjanje ali nas v sistemu čaka kakšna vloga za prevzem. Glede na vpisane datume nam sistem vrne seznam vlog, ki nas čakajo (ResponseReferenceCode). geteclaim Metoda ua prevzem posdamezne evloge iz sistema. Kot vhodni parameter se vpiše kodo odgovora vloge. getversion Metoda za preverjanje verzije servisa. Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 5 od 17
2.1 checkeclaimstatus 2.1.1 Parametri za klic (Request) Parameter Tip Opis guid String Identifikacijski žeton (točno 36 znakov) refcode String Referenčna oznaka poslane vloge Primer zahtevka: 2.1.2 Odgovor (Response) Rezultat metode v primeru napak: <?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor Rezultat="- 1"><NapakaSeznam><Napaka element="guid or refcode" koda="006">no data found!</napaka></napakaseznam></odgovor></todgovorservis> Rezultat metode v primeru brez napak: Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 6 od 17
<?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor Rezultat="1"><EclaimResponse><status>5</status><statusDescription>Transmission of receipt</statusdescription><receiveddate>2014-06- 19T12:10:10.000Z</receivedDate></EclaimResponse></Odgovor></tOdgovorServis> Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 7 od 17
2.2 geteclaim 2.2.1 Parametri za klic (Request) Parameter Tip Opis guid String Identifikacijski žeton (točno 36 znakov) refcoderes String Referenčna oznaka odgovora poslane vloge Primer zahtevka: 2.2.2 Odgovor (Response) Rezultat metode če ima evloga priponke: Rezultat metode če evloga nima priponk: Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 8 od 17
Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 9 od 17
2.3 geteclaimlist 2.3.1 Parametri za klic (Request) Parameter Tip Opis guid String Identifikacijski žeton (točno 36 znakov) datefrom String Datum od dateto String Datum do Primer zahtevka: 2.3.2 Odgovor (Response) Rezultat metode v primeru, ko najde evloge: <?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor Rezultat="1"><EclaimResponseList><EclaimResponse><status>01</status><statusDescription>eVloga začasno shranjena</statusdescription><sentdate>2014-06- 18T17:57:36.000Z</sentDate><ResponseReferenceCode>EODGOVOR00000000000000000000000000000093</Re sponsereferencecode><senderreferencecode>evlogezpiz000000000000000000000000000476</senderrefer encecode></eclaimresponse></eclaimresponselist></odgovor></todgovorservis> Rezultat metode v primeru, ko ne najde evlog: Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 10 od 17
<?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor Rezultat="1"/></tOdgovorServis> Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 11 od 17
2.4 sendeclaim 2.4.1 Parametri za klic (Request) Parameter Tip Opis guid String Identifikacijski žeton (točno 36 znakov) eclaimxml String Vsebina vloge v XML attachments List<byte[]> Priponke (opcijsko) Primer eclaimxml: <?xml version="1.0" encoding="utf-8"?> <ov:ovojnica xmlns:ov="http://sheme.zpiz.si/zpizovojnica" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="ov:Ovojnica" Verzija="2.0"> <ov:glava> <ov:posiljatelj Posiljatelj_DR="SI" Posiljatelj_DS="12345678" Posiljatelj_EK="000"/> <ov:prejemnik Prejemnik_DR="SI" Prejemnik_DS="85876500" Prejemnik_EK="000"/> <ov:test>0</ov:test> <ov:oblika>xml</ov:oblika> <ov:oznaka Tip="EX-DE-02" Verzija="01052014"/> <ov:up_oznaka>eodgovor00000000000000000000000000000129</ov:up_oznaka> <ov:datum_cas_priprave Cas="13:15:47" Datum="2015-03-18"/> <ov:podpisano>1</ov:podpisano> <ov:sifrirano>0</ov:sifrirano> <ov:kanal Tip="S" Vir="P"/> </ov:glava> <ov:telo Id="ov:Telo"> <ECLAIM id="ex-de-02" version="01052014"> <DATA> <SERNUMMAGTAPE>1235465-ADAKJG-251</SERNUMMAGTAPE> <SHIPMENTNO>12054</SHIPMENTNO> <PRODDT>2014-06-12</PRODDT> <SENDER>Deutsche Rentenversicherung Nord. Friedrich-Ebert-Damm 245. 22159 Hamburg, Germany</SENDER> <RECIPIENT>ZPIZ - Zavod za pokojninsko zavarovanje, SI1000 Ljubljana, Slovenia</RECIPIENT> <RECNO>20000</RECNO> <DATE_SENT>2014-06-13</DATE_SENT> <INQUIERER>LOGGEDUSER</INQUIERER> <CLAIM_REF_CODE>:IDVLOGEODDANE</CLAIM_REF_CODE> </DATA> <ATTACHMENTS> <ATTACHMENT filename="priponka1.pdf" hash="a40186a2468c40a0b48e1c5c06224995f6ebc3d9" length="53363" mimetype="application/pdf" refoznaka="eodgovor00000000000000000000000000000129"/> </ATTACHMENTS> </ECLAIM> </ov:telo> <ov:podpis> <ds:signature Id="6a2b19a0-142d-45cc-94a6-9ba5a9af8566"> <ds:signedinfo> <ds:canonicalizationmethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <ds:signaturemethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <ds:reference URI="#ov:Telo"> <ds:transforms> Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 12 od 17
<ds:transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/> </ds:transforms> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>hzpg6v2vmqphsg9pyqgeb5jf1mc=</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue>eh3j41aito5qc88nx775wpjd8qqatep5tscuztl28vwdw5quntlas0lovnm+xytv+phv BsqwBiRG 5ZJZtPxLHzZVeuc+XcFn2n23NRgXJQy2hvLB9+xmOnjrytodJGwg5TqDmaVagk6PoT8n7ufCSp2x +B+bd8tAXuaGcvtTAi7gnIrfaykZ70XcEqBnBTeI8xn47NBPAmUjU6X/BuHudmY6fN1u0eShjBnp +bgdxupaq7jjqjevkj0lfimai9gjb+5vtj0ums5fmrkhoehhhjbiyfqvfeuofcem3/ssxoxbtqyy KCch1n6qFu0SaF9lttdD/S1+CPtOdVu/cp/ALw==</ds:SignatureValue> <ds:keyinfo> <ds:keyvalue> <ds:rsakeyvalue> <ds:modulus>saazbmaop36nonq3wb55/rhvbdgxk4puepn9tmis6i5lvj3fmx6sv5clhkddzd7nl5vktxrhmq1 O uowg/g5ek9zfwpkska3ax7vko4zd9zh1hp3x0ifod11c26/vb6pyxqgqmhz+yjlmf+rfrsokrpdu +0Cgp18IW8ReglhMnidoMR1JFXuyz0PdawX8sGc8ZD8gdr8ms0AaCOcwMa4NsRt+35LUcs/soDJl u0kzx1af/kxvjpxmxfh4dbjuanq6p8qtgrx6fey6lzrdx7hozdg3ptp0vyyx8g+zpje9mstgzcmh 04Gg+dkb5fdDUeL1lbB4cc/uypx4S2btvBOiCQ==</ds:Modulus> <ds:exponent>aqab</ds:exponent> </ds:rsakeyvalue> </ds:keyvalue> <ds:x509data> <ds:x509subjectname>2.5.4.5=#130d32343632393333373130303737+cn=tlxwas03.zpiz.si,ou=zpiz - 85876500,OU=org-web,OU=sigen-ca,O=state-institutions,C=si</ds:X509SubjectName> <ds:x509certificate>miifvdccbdygawibagieo0t26zanbgkqhkig9w0baqufada9mqswcqydvqqgewjzate bmbkga1ue ChMSc3RhdGUtaW5zdGl0dXRpb25zMREwDwYDVQQLEwhzaWdlbi1jYTAeFw0xMzA1MjkxMTA1MDha Fw0xODA1MjkyMTM4MzBaMIGaMQswCQYDVQQGEwJzaTEbMBkGA1UEChMSc3RhdGUtaW5zdGl0dXRp b25zmrewdwydvqqlewhzawdlbi1jyteqma4ga1uecxmhb3jnlxdlyjeymbyga1uecxmpwlbjwiat IDg1ODc2NTAwMS8wFAYDVQQFEw0yNDYyOTMzNzEwMDc3MBcGA1UEAxMQVExYV0FTMDMuenBpei5z atccasiwdqyjkozihvcnaqebbqadggepadccaqocggebalagswzgkkd+p6j6t8g+ef0yb2w4fyuk bnjzfbtceuiozvy9xtmekr+qpysnxwxezzebyk164zkntrqfhvxurcvwx8d5ljgtwf+7yjugxfwy dyad8dinzg9dqtuv72+j8subkdic/so5zn/q367diqzw7vtaokdfcfvexojytj4nadedsrv7ss9d 3WsF/LBnPGQ/IHa/JrNAGgjnMDGuDbEbft+S1HLP7KAyZbtJM19Wn/ysVSaVzMXx+A2ybgJ0OqfK k4k8en3moi80xv+4agq4n6bt9l8sl/ips6yxpzkk4gqjb9obopnzg+x3q1hi9zwwehhp7sqceetm 7bwTogkCAwEAAaOCAfwwggH4MA4GA1UdDwEB/wQEAwIFoDBBBgNVHSAEOjA4MDYGCysGAQQBr1kC AQMCMCcwJQYIKwYBBQUHAgEWGWh0dHA6Ly93d3cuY2EuZ292LnNpL2Nwcy8wHwYDVR0RBBgwFoEU c2vydmvylmfkbwluqhpwaxouc2kwge4ga1udhwsb5jcb4zbwofsguqrqme4xczajbgnvbaytannp MRswGQYDVQQKExJzdGF0ZS1pbnN0aXR1dGlvbnMxETAPBgNVBAsTCHNpZ2VuLWNhMQ8wDQYDVQQD EwZDUkwyNjUwgYiggYWggYKGV2xkYXA6Ly94NTAwLmdvdi5zaS9vdT1zaWdlbi1jYSxvPXN0YXRl LWluc3RpdHV0aW9ucyxjPXNpP2NlcnRpZmljYXRlUmV2b2NhdGlvbkxpc3Q/YmFzZYYnaHR0cDov L3d3dy5zaWdlbi1jYS5zaS9jcmwvc2lnZW4tY2EuY3JsMCsGA1UdEAQkMCKADzIwMTMwNTI5MTEw NTA4WoEPMjAxODA1MjkyMTM4MzBaMB8GA1UdIwQYMBaAFHF7igYfMQVVq2ASd0cgHgOIGOyJMB0G A1UdDgQWBBQFQq4dqgnnxZf8kAlbRnvoqXgtxTAJBgNVHRMEAjAAMBkGCSqGSIb2fQdBAAQMMAob BFY4LjEDAgOoMA0GCSqGSIb3DQEBBQUAA4IBAQA7nFuO9wztqGRO2Zc12RiRDhEllplOXa5rdtRz BdcQbJbZQO98gDpjiiYCdKxyp7QQVbLmtlf0FL8AZwejEkZjcCTn9AztPRbuEuhS5iBZOL0n2Nwj g0yuy8g/n+oflwrhoihqak2qm4/yk9xwpsgutyo1pgntgy4eh3hp0qamso+/o1oc4jsjin67hjuh Y1DxH4dd5YppgS13sVZonlW++OHiiGUIqBVASEgUFjvPPYp98sdzAfAE8bFjAMoXPpER5Gf1PwR2 9OIoMC1rJ5NPuXMNs5UZnwUi2kSZvmrTf1U3bU/yj88FmZJpcE/s7GGz/7t4jY17+B5hTuJMyjRH</ds:X509Certifica te> </ds:x509data> </ds:keyinfo> </ds:signature> </ov:podpis> </ov:ovojnica> Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 13 od 17
Primer zahtevka brez priponk: Primer zahtevka s priponkami: 2.4.2 Odgovor (Response) Primer odgovora z napakami: Tip String Opis <?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor reponseid="19f7065a-530e-4162-8552- f00d431f1770" Rezultat="- 1"><NapakaSeznam><Napaka element="//ov:ovojnica/ov:glava/ov:up_oznaka" koda="004">duplicate value! Value must be unique!</napaka></napakaseznam></odgovor></to Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 14 od 17
dgovorservis> Možne so naslenje vrste napak: Koda Opis Vzrok 001 Value is empty! Manjka obvezno polje 002 Value is invalid!.. Vrednost ni pravilna oz. ni pravilna glede na ostale vrednosti. 003 Attachments not allowed! evloga ne sme vsebovati priponk 004 Duplicate value! Value must be unique! Vrednost iz Up_Oznaka že obstaja v EP.VLOGE_ODDANE.TX_REFERENČNA_OZNAKA Primer odgovora brez napak: Tip String Opis <?;?xml version="1.0" encoding="utf-8" standalone="yes"?><todgovorservis><odgovor reponseid="40a7aebe-8b54-456d-bdc0-8b0269a685cd" Rezultat="1"/></tOdgovorServis> Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 15 od 17
2.5 getversion 2.5.1 Parametri za klic (Request) Primer zahtevka: <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.epezss024000.zpiz.si/"> <soapenv:header/> <soapenv:body> <ws:getversion/> </soapenv:body> </soapenv:envelope> 2.5.2 Odgovor (Response) Tip Opis String - Primer odgovora: Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 16 od 17
3 Priloge 3.1 SFIZSS001001ServicesWS WSDL 3.2 EPEZSS024000ServicesWS WSDL https://www.zpiz.si/bizpiztest/sfizss001001/sfizss001001servicesws/sfizss001001servicesws.wsdl https://www.zpiz.si/bizpiztest/epezss024000/epezss024000servicesws/epezss024000servicesws.wsdl Storitve evlog BiZPIZ (EPEZ) Tehnična dokumentacija Stran 17 od 17