POČETNA
SPI SC servis
Metoda dohvatiDrzave
|
Opis
|
Vraća podatke o državama iz kataloga LC SPI baze |
Specifikacija ulaznog XML-a:
| Struktura |
Opis |
Tip podatka |
Uvjet |
Broj pojavljivanja elementa |
| dohvatiDrzaveRequest |
|
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 |
|
/drzava
|
|
/drzave
|
| /dohvatiDrzaveRequest |
* Filteri (neobavezni) filtriraju response listu na način da se iz kataloga država 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 |
| dohvatiDrzaveResponse |
|
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 |
|
/drzava
|
|
/drzave
|
|
greska
|
0..1 |
|
Greska
|
1 – greška |
tinyint |
|
1..1 |
|
OpisGreske
|
Opis greške prilikom dohvata podatka |
string(300) |
|
1..1 |
|
/greska
|
| /dohvatiDrzaveResponse |
* U odgovoru metode dohvatiDrzaveResponse 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:dohvatiDrzaveRequest>
<v0:VsID>SC</v0:VsID>
<v0:drzave>
<v0:drzava>
<v0:DrzSifra>02</v0:DrzSifra>
<v0:DrzNaziv>PORTUGAL</v0:DrzNaziv>
</v0:drzava>
</v0:drzave>
</v0:dohvatiDrzaveRequest>
</soapenv:Body>
</soapenv:Envelope>
Primjer responsea:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
<soap:Body>
<ns3:dohvatiDrzaveResponse
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>02</ns3:DrzSifra>
<ns3:DrzNaziv>PORTUGAL</ns3:DrzNaziv>
</ns3:drzava>
</ns3:drzave>
</ns3:dohvatiDrzaveResponse>
</soap:Body>
</soap:Envelope>