POČETNA SPI SC servis

Metoda spremiLokacije

Ako lokacija ne postoji u sustavu tada se ovom metodom dodaje.
Metoda će pokušati spremati mjesta samo u slučaju kada operater dodijeljen vanjskom sustavu ima prava za dodavanje lokacije u sustav, a u suprotnom će metoda vratiti grešku u izlaznom XML-u.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiLokacijeRequest
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
lokacije1..1
lokacija1..n
LokSifraŠifra lokacijestring(10)1..1
LokNazivNaziv lokacijestring(100)1..1
RazinaHijerarhijska struktura lokacije (1 – prva razina lokacije, 2- druga razina…)tinyint1..1
AdresaAdresa lokacijestring(40)0..1
LokNadSifraŠifra nadređene lokacijestring(10)0..1
/ lokacija
/ lokacije
/ spremiLokacijeRequest

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiLokacijeResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
lokacije{Or0..1
lokacija1..n
LokSifraŠifra lokacijestring(10)1..1
LokNazivNaziv lokacijestring(100)1..1
status1..1
Greska 0 – nema greške;
1 – greška (nije spremljeno);
2 – spremljeno (ali ne svi podaci);
3 – već postoji u sustavu
tinyint 1..1
OpisGreskeOpis greške prilikom spremanja podatka
– obavezan za Greska <> 0
string(300)Greska = 00..1
/ status
/ lokacija
/ lokacije
greskaOr}0..1
Greska1 - greškatinyint1..1
OpisGreškeOpis greške prilikom dohvata podatakastring(300)1..1
/ greska
/ spremiLokacijeResponse

* Ako u sustavu nije pronađena lokacija prema vrijednosti elementa LokSifra metoda vraća grešku o nemogućnosti spremanja lokacije radi nepoznate lokacije.
* Ako u sustavu već postoji mjesto po LokSifra tada će se spremanje podatka o lokaciji ignorirati, a u izlaznom XML-u će se prikazati kao greška spremanja podatka.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenarp/v0.1"> <soapenv:Header/> <soapenv:Body> <v0:spremiLokacijeRequest> <v0:VsID>SC</v0:VsID> <v0:lokacije> <!--1 or more repetitions:--> <v0:lokacija> <v0:LokSifra>001</v0:LokSifra> <v0:LokNaziv>GRAD SAMOBOR</v0:LokNaziv> <v0:Razina>1</v0:Razina> <!--Optional:--> <v0:Adresa>Vinska 6</v0:Adresa> </v0:lokacija> </v0:lokacije> </v0:spremiLokacijeRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:spremiLokacijeResponse 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"> <ns2:VsID>SC</ns2:VsID> <ns2:lokacije> <ns2:lokacija> <ns2:LokSifra>001</ns2:LokSifra> <ns2:LokNaziv>GRAD SAMOBOR</ns2:LokNaziv> <ns2:status> <ns2:Greska>0</ns2:Greska> <ns2:OpisGreske/> </ns2:status> </ns2:lokacija> </ns2:lokacije> </ns2:spremiLokacijeResponse> </soap:Body> </soap:Envelope>