POČETNA
SPI SC servis
Metoda dohvatiUlice
Specifikacija ulaznog XML-a:
| Struktura |
Opis |
Tip podatka |
Uvjet |
Broj pojavljivanja elementa |
| dohvatiUliceRequest |
| VsID | Identifikator vanjskog sustava (dogovara se) | string(36) | | 1..1 |
| drzave | 0..1 |
| drzava | 1..n |
| DrzSifra | Filter - Troznačna šifra države | string(3) | | 0..1 |
| DrzNaziv | Filter - Naziv države | string(30) | | 0..1 |
| mjesta | 0..1 |
| mjesto | 1..n |
| MjePtBroj | Filter - PT broj | string(10) | | 0..1 |
| MjeNaziv | Filter - Naziv mjesta | string(25) | | 0..1 |
| naselja | 0..1 |
| naselje | 0..n |
| NasSifra | Filter - Šifra naselja iz LC SPI sustava | bigint | | 0..1 |
| NasNaziv | Filter - Naziv naselja | string(25) | | 0..1 |
| ulice | 0..1 |
| ulica | 0..n |
| UliSifra | Filter - Šifra ulice iz LC SPI sustava
Filtriraju se podaci sa identičnom vrijednošću filtera | bigint | | 0..1 |
| UliNaziv | Filter - Naziv ulice
Filtriraju se podaci koji sadrže poslanu vrijednost filtera | string(40) | | 0..1 |
| /ulica |
| /ulice |
| /naselje |
| /naselja |
| /mjesto |
| /mjesta |
| /drzava |
| /drzave |
| /dohvatiUliceRequest |
* Filteri (neobavezni) filtriraju response listu na način da se iz kataloga ulica LC SPI sustava izdvajaju samo podaci koji sadrže vrijednost poslanu u navedenim filterima.
* Filtriranje po poslanim šiframa se vrši na način potpunog uparivanja, odnosno vraća se podatak iz LC SPI kataloga kojem je pripadajuća šifra identična poslanoj vrijednosti filtera.
* Ukoliko elementi filtera nisu poslani tada se filtriranje na toj razini niti ne vrši.
Specifikacija izlaznog XML-a:
| Struktura |
Opis |
Tip podatka |
Uvjet |
Broj pojavljivanja elementa |
| dohvatiUliceResponse |
| VsID | Identifikator vanjskog sustava (dogovara se) | string(36) | | 1..1 |
| drzave | 0..1 |
| drzava | 1..n |
| DrzSifra | Troznačna šifra države | string(3) | | 1..1 |
| DrzNaziv | Naziv države | string(30) | | 1..1 |
| mjesta | 0..1 |
| mjesto | 1..n |
| MjePtBroj | PT broj | string(10) | | 1..1 |
| MjeNaziv | Naziv mjesta | string(25) | | 1..1 |
| naselja | 0..1 |
| naselje | 1..n |
| NasSifra | Šifra naselja iz LC SPI sustava | bigint | | 1..1 |
| NasNaziv | Naziv naselja | string(25) | | 1..1 |
| ulice | 0..1 |
| ulica | 1..n |
| UliSifra | Šifra ulice iz LC SPI sustava | bigint | | 1..1 |
| UliNaziv | Naziv ulice | string(40) | | 1..1 |
| /ulica |
| /ulice |
| /naselje |
| /naselja |
| /mjesto |
| /mjesta |
| /drzava |
| /drzave |
| greska | 0..1 |
| Greska | 1 – greška | tinyint | | 1..1 |
| OpisGreske | Opis greške prilikom dohvata podatka | string(300) | | 1..1 |
| /greska |
| /dohvatiUliceResponse |
* U odgovoru metode dohvatiUliceResponse se vraća unija podataka iz kataloga prema poslanim filterima.
Primjer requesta:
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenasc/v0.1">
<soapenv:Header/>
<soapenv:Body>
<v0:dohvatiUliceRequest>
<v0:VsID>SC</v0:VsID>
<v0:drzave>
<v0:drzava>
<v0:DrzNaziv>REPUBLIKA HRVATSKA</v0:DrzNaziv>
<v0:DrzSifra>RH</v0:DrzSifra>
<v0:mjesta>
<v0:mjesto>
<v0:MjePtBroj>10000</v0:MjePtBroj>
<v0:MjeNaziv>ZAGREB</v0:MjeNaziv>
<v0:naselja>
<v0:naselje>
<v0:NasSifra>3374902</v0:NasSifra>
<v0:NasNaziv>DUBRAVA</v0:NasNaziv>
<v0:ulice>
<v0:ulica>
<v0:UliNaziv>Kraljeva Ulica</v0:UliNaziv>
<v0:UliSifra>913712</v0:UliSifra>
</v0:ulica>
</v0:ulice>
</v0:naselje>
</v0:naselja>
</v0:mjesto>
</v0:mjesta>
</v0:drzava>
</v0:drzave>
</v0:dohvatiUliceRequest>
</soapenv:Body>
</soapenv:Envelope>
Primjer responsea:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:dohvatiUliceResponse
xmlns:ns6="http://www.spi.hr/ws/razmjena/sc/v0.1"
xmlns:ns5="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02"
xmlns:ns4="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1"
xmlns:ns3="http://www.spi.hr/ws/razmjena/sc/razmjenasc/v0.1"
xmlns:ns2="http://www.spi.hr/ws/razmjena/sc/razmjenarp/v0.1">
<ns3:VsID>SC</ns3:VsID>
<ns3:drzave>
<ns3:drzava>
<ns3:DrzSifra>RH</ns3:DrzSifra>
<ns3:DrzNaziv>REPUBLIKA HRVATSKA</ns3:DrzNaziv>
<ns3:mjesta>
<ns3:mjesto>
<ns3:MjePtBroj>10000</ns3:MjePtBroj>
<ns3:MjeNaziv>ZAGREB</ns3:MjeNaziv>
<ns3:naselja>
<ns3:naselje>
<ns3:NasSifra>3374902</ns3:NasSifra>
<ns3:NasNaziv>DUBRAVA</ns3:NasNaziv>
<ns3:ulice>
<ns3:ulica>
<ns3:UliNaziv>Kraljeva Ulica</ns3:UliNaziv>
<ns3:UliSifra>913712</ns3:UliSifra>
</ns3:ulica>
</ns3:ulice>
</ns3:naselje>
</ns3:naselja>
</ns3:mjesto>
</ns3:mjesta>
</ns3:drzava>
</ns3:drzave>
</ns3:dohvatiUliceResponse>
</soap:Body>
</soap:Envelope>