POČETNA SPI SC servis

Metoda spremiUgovore

OpisMetoda služi za spremanje ugovora u LC SPI registar ugovora.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiUgovoreRequest
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
PoslovnaGodinaGodina bazesmallint0..1
ugovori1..1
ugovor1..n
DokGUIDIdentifikator ugovora u LC SPI sustavustring(36)1..1
GodinaGodina ugovora.smallint1..1
BrojUgovoraBroj ugovorastring(25)0..1
TipDokumentaNaziv tipa dokumenta
Sadrži atribut @sifra varchar (3)– šifra tipa dokumenta u LC SPI bazi – 1..1
string(40)1..1
<TipDokumenta sifra="UGO">UGOVOR</TipDokumenta>
DatumSklapanjaDatum sklapanja ugovoradate1..1
OpisUgovoraOpis ugovorastring(200)1..1
RbUgovoraRedni broj ugovorastring(10)0..1
EvBrojPostupkaEvidencijski broj postupkastring(20)0..1
KlasaKlasifikacijska oznaka ugovorastring(30)0..1
UrBrojUrudžbeni broj ugovorastring(30)0..1
TipUgovoraNaziv tipa ugovora
Sadrži atribut @sifra varchar (5)– šifra tipa ugovora u LC SPI bazi – 1..1
string(100)0..1
<TipUgovora sifra="UJNR">Ugovor o javnoj nabavi robe</TipUgovora >
VrijediDoDatum do kada vrijedi ugovordatetime0..1
PartnerNaziv partnera iz LC SPI sustava.
Sadrži atribute:
@sifra varchar (10)– šifra partnera – 1..1
@oib char (11)– OIB partnera – 0..1
@pdvid varchar (22)– PDVID broj partnera – 0..1
string(80)0..1
<Partner sifra="2074" oib="16687620362" pdvid="" >Pero Perić</Partner >
BrojUgovoraPartneraBroj ugovora partnerastring(50)0..1
ProcVrijNabaveNetoProcijenjena neto vrijednost nabavedecimal(18,2)0..1
ProcVrijNabavePDVProcijenjena vrijednost porezadecimal(18,2)0..1
ProcVrijNabaveBrutoProcijenjena bruto vrijednost nabavedecimal(18,2)0..1
ProcVrijNabaveBrutoValutaProcijenjena bruto vrijednost nabave u stranoj valuti
Sadrži atribut:
@valuta varchar (3)– troznačna oznaka valute – 1..1
decimal(18,2)0..1
<ProcVrijNabaveBrutoValuta valuta="EUR">25000.00</ProcVrijNabaveBrutoValuta>
KonacnaVrijNetoKonačna neto vrijednost ugovoradecimal(18,2)0..1
KonacnaVrijPDVKonačna vrijednost poreza ugovoradecimal(18,2)0..1
KonacnaVrijBrutoKonačna bruto vrijednost ugovoradecimal(18,2)0..1
RealiziranaVrijRealizirana vrijednost ugovoradecimal(18,2)0..1
UstupanjeOznaka da li se može izvršiti ustupanje vrijednosti
0 - ne može se ustupati (default)
1 - može se ustupati
bit0..1
UstupanjeVrijNetoNeto vrijednost koja se ustupadecimal(18,2)0..1
UstupanjaVrijBrutoBruto vrijednost koja se ustupadecimal(18,2)0..1
UstupanjeOpisOpis dijela ustupanjastring(4000)0..1
PodizvodjaciPodizvođači – opisni podatakstring(4000)0..1
GodinaPocetkaGodina početkasmallint0..1
GodinaZavrsetkaGodina završetkasmallint0..1
RokPocetkaRok početkadatetime0..1
RokZavrsetkaRok završetkadatetime0..1
StvarniPocetakStvarni datum početkadatetime0..1
StvarniZavrsetakStvarni datum završetkadatetime0..1
RokIsporukeUDanimaRok isporuke u danimasmallint0..1
RokPlacanjaUDanimaRok plaćanja u danimasmallint0..1
OpisPlacanjaOpis plaćanjastring(4000)0..1
DonosPlacanjaDonos plaćanjadecimal(18,2)0..1
NapomenaNapomena na ugovorustring(500)0..1
OdjelNaziv odjela. Sadrži atribut
@sifra smallint – šifra odjela u LC SPI bazi – 1..1
string(80)0..1
<Odjel sifra="73">Ured grada</Odjel >
MjestoTroskaNaziv mjesta troška. Sadrži atribut
@sifra varchar (15)– šifra mjesta troška u LC SPI bazi – 1..1
string(40)0..1
<MjestoTroska sifra="0004">Ured grada</MjestoTroska>
RazdjelNaziv razdjela. Sadrži atribut
@sifra varchar (30)– šifra razdjela u LC SPI bazi – 1..1
string(100)0..1
<Razdjel sifra="0004">Upravni odjel za društvene djelatnosti</Razdjel>
UgovorNeodredjenoUgovor na neodređeno vrijeme
0 – na određeno (default);
1 – na neodređeno
bit0..1
DokGUIDPrethodniAko je ugovor aneks, ovdje se sprema GUID izvornog ugovora po kojem je aneks nastaostring(36)0..1
StatusIzvrsenOznaka izvršenosti ugovora (0-neizvršen; 1-izvršen)bit0..1
URLDokumentaURL adresa dokumenta, npr.:
- URL do datoteke dokumenta
- URL na dokument u vanjskom sustavu
string(16000)0..1
/ugovor
/ugovori
/spremiUgovoreRequest

* Parametar PoslovnaGodina definira u koju SPI bazu želimo unijeti ugovor. Podatak nije obvezan. Ako se ne unese, Ugovor se prenosi u posljednju aktivnu godinu.
* BrojUgovora konzultira parametar u LCW125 za automatsko generiranje ugovora. Ako je uključen, BrojUgovora se automatski generira. Ako je isključen, sprema se BrojUgovora poslan metodom.
* RbUgovora se automatski generira prema početnom brojaču 'RUG' unutar SPI sustava.

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiUgovoreResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
PoslovnaGodinaGodina bazesmallint0..1
ugovori{Or0..1
ugovor1..n
DokGUIDIdentifikator ugovora u LC SPI sustavustring(36)1..1
status1..1
Greska0 – nema greške;
1 – greška (nije spremljeno);
2 – već postoji u LC SPI sustavu
tinyint1..1
OpisGreskeOpis greške u slučaju da dokument nije u uspješno obrađen u LC SPI sustavu.
– obavezan za Greska <> 0
string(300)Greska=00..1
/status
/ugovor
/ugovori
greskaOr}0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom dohvata podatkastring(300)1..1
/greska
/spremiUgovoreResponse

* Spremanje ugovora u LC SPI bazu se vrši samo za one ugovore koji uspješno prođu provjeru podataka dok se oni ugovori koji imaju bilo kakvu grešku u podacima ne spremaju.
* U dogovoru metode se u oba slučaja vraća status greške za svaki pojedini ugovor kako je u specifikaciji navedeno.
* Ukoliko dođe do globalne greške (nedostupan servis, neuspjela prijava i sl.) tada se ista vraća u odgovoru bez povratnih podataka o ugovorima i u tom slučaju nije došlo do nikakve obrade unutar LC SPI sustava.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1"> <soapenv:Header/> <soapenv:Body> <v0:spremiUgovoreRequest> <v0:VsID>SC</v0:VsID> <v0:ugovori> <!--1 or more repetitions:--> <v0:ugovor> <v0:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</v0:DokGUID> <v0:Godina>2020</v0:Godina> <v0:BrojUgovora>20/0001</v0:BrojUgovora> <v0:TipDokumenta sifra="UGO">UGOVOR</v0:TipDokumenta> <v0:DatumSklapanja>2020-03-31</v0:DatumSklapanja> <v0:OpisUgovora>Ugovor o javnoj nabavi uredskog materijala</v0:OpisUgovora> </v0:ugovor> </v0:ugovori> </v0:spremiUgovoreRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns4:spremiUgovoreResponse 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"> <ns4:VsID>SC</ns4:VsID> <ns4:ugovori> <ns4:ugovor> <ns4:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</ns4:DokGUID> <ns4:status> <ns4:Greska>0</ns4:Greska> </ns4:status> </ns4:ugovor> </ns4:ugovori> </ns4:spremiUgovoreResponse> </soap:Body> </soap:Envelope>