POČETNA
SPI SC servis
Metoda dohvatiMjesta
Specifikacija ulaznog XML-a:
| Struktura |
Opis |
Tip podatka |
Uvjet |
Broj pojavljivanja elementa |
| dohvatiMjestaRequest |
| VsID |
Identifikator vanjskog sustava (dogovara se) |
string(36) |
|
1..1 |
| drzave | 1..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
Filtriraju se podaci sa identičnom vrijednošću filtera | string(10) | | 0..1 |
| MjeNaziv | Filter - Naziv mjesta
Filtriraju se podaci koji sadrže poslanu vrijednost filtera | string(25) | | 0..1 |
| /mjesto |
| /mjesta |
| /drzava |
| /drzave |
| /dohvatiMjestaRequest |
* Filteri (neobavezni) filtriraju response listu na način da se iz kataloga mjesta 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 |
| dohvatiMjestaResponse |
| VsID |
Identifikator vanjskog sustava (dogovara se) |
string(36) |
|
1..1 |
| drzave | 1..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 |
| /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 |
| /dohvatiMjestaResponse |
* U odgovoru metode dohvatiMjestaResponse 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:dohvatiMjestaRequest>
<v0:VsID>SC</v0:VsID>
<v0:drzave>
<!--1 or more repetitions:-->
<v0:drzava>
<v0:DrzNaziv>REPUBLIKA SLOVENIJA</v0:DrzNaziv>
<v0:DrzSifra>RS</v0:DrzSifra>
<v0:mjesta>
<!--1 or more repetitions:-->
<v0:mjesto>
<v0:MjePtBroj>00</v0:MjePtBroj>
<v0:MjeNaziv>BREŽICE</v0:MjeNaziv>
</v0:mjesto>
</v0:mjesta>
</v0:drzava>
</v0:drzave>
</v0:dohvatiMjestaRequest>
</soapenv:Body>
</soapenv:Envelope>
Primjer responsea:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:dohvatiMjestaResponse
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>RS</ns3:DrzSifra>
<ns3:DrzNaziv>REPUBLIKA SLOVENIJA</ns3:DrzNaziv>
<ns3:mjesta>
<ns3:mjesto>
<ns3:MjePtBroj>00</ns3:MjePtBroj>
<ns3:MjeNaziv>BREŽICE</ns3:MjeNaziv>
</ns3:mjesto>
</ns3:mjesta>
</ns3:drzava>
</ns3:drzave>
</ns3:dohvatiMjestaResponse>
</soap:Body>
</soap:Envelope>