POČETNA
SPI SC servis
Metoda dohvatiNaselja
Specifikacija ulaznog XML-a:
| Struktura |
Opis |
Tip podatka |
Uvjet |
Broj pojavljivanja elementa |
| dohvatiNaseljaRequest |
| 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 | 1..n |
| NasSifra | Filter - Šifra naselja iz LC SPI sustava
Filtriraju se podaci sa identičnom vrijednošću filtera | bigint | | 0..1 |
| NasNaziv | Filter - Naziv naselja
Filtriraju se podaci koji sadrže poslanu vrijednost filtera | string(25) | | 0..1 |
| /naselje |
| /naselja |
| /mjesto |
| /mjesta |
| /drzava |
| /drzave |
| /dohvatiNaseljaRequest |
* Filteri (neobavezni) filtriraju response listu na način da se iz kataloga naselja 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 |
| dohvatiNaseljaResponse |
| 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 | | 0..1 |
| NasNaziv | Naziv naselja | string(25) | | 1..1 |
| /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 |
| /dohvatiNaseljaResponse |
* U odgovoru metode dohvatiNaseljaResponse 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:dohvatiNaseljaRequest>
<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>
<!--Zero or more repetitions:-->
<v0:naselje>
<v0:NasSifra>3374902</v0:NasSifra>
<v0:NasNaziv>DUBRAVA</v0:NasNaziv>
</v0:naselje>
</v0:naselja>
</v0:mjesto>
</v0:mjesta>
</v0:drzava>
</v0:drzave>
</v0:dohvatiNaseljaRequest>
</soapenv:Body>
</soapenv:Envelope>
Primjer responsea:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:dohvatiNaseljaResponse
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:naselje>
</ns3:naselja>
</ns3:mjesto>
</ns3:mjesta>
</ns3:drzava>
</ns3:drzave>
</ns3:dohvatiNaseljaResponse>
</soap:Body>
</soap:Envelope>