Metoda dohvatiUgovore

Opis

Metoda služi za dohvaćanje ugovora iz LC SPI aplikacije Registar ugovora prema zadanim filterima u ulaznom parametru.

Specifikacija ulaznog XML-a:

Struktura	Opis	Tip podatka	Uvjet	Broj pojavljivanja elementa
dohvatiUgovoreRequest
VsID	Identifikator vanjskog sustava (dogovara se)	string(36)		1..1
ugovori	Filteri grupe ugovora	1..1
Godina	Godina ugovora.	smallint	{Or	0..1
DatumSklapanjaOd	Datum sklapanja od kojega se žele dohvatiti ugovori	date		0..1
DatumSklapanjaDo	Datum sklapanja od kojega se žele dohvatiti ugovori	date		0..1
SifraTipaUgovora	Šifra tipa ugovora	string(5)		0..1
ParSifra	Šifra partnera iz LC SPI sustava. Za filtriranje partnera prema poslanim šiframa. Ako nije poslano ne vrši se filtriranje po ovom elementu.	string(10)		0..1
ParOIB	OIB partnera. Za filtriranje partnera prema poslanim OIB – ima. Ako nije poslano ne vrši se filtriranje po ovom elementu.	string(11)		0..1
ParPDVID	PDV ID broj partnera. Za filtriranje partnera prema poslanim PDVID brojevima. Ako nije poslano ne vrši se filtriranje po ovom elementu.	string(22)		0..1
ParNaziv	Naziv partnera. Za dodatno filtriranje partnera po dijelu naziva odnosno po elementima ParNaziv i ParNazivII iz odgovora (responsa) ove metode. Ako nije poslano ne vrši se filtriranje po ovom elementu	string(40)		0..1
Klasa	Filtriranje ugovora po klasifikacijskoj oznaci. Ako nije poslano ne vrši se filtriranje po ovom elementu.	string(30)		0..1
DatumIzmjeneOd	Filtriranje ugovora prema početnom datumu izmjene u katalogu. Podaci se filtriraju prema datumu i vremenu nastanka ili naknadne promjene. Ako nije poslano ne vrši se filtriranje po ovom elementu.	datetime		0..1
DatumIzmjeneDo	Filtriranje ugovora prema završnom datumu izmjene u katalogu. Podaci se filtriraju prema datumu i vremenu nastanka ili naknadne promjene. Ako nije poslano ne vrši se filtriranje po ovom elementu.	datetime		0..1
StatusIzvrsen	Filter – Oznaka izvršenosti ugovora (0-neizvršen; 1-izvršen).	bit		0..1
ugovor	Filteri za pojedini ugovor	0..n
DokGUID	Identifikator ugovora u LC SPI sustavu	string(36)		0..1
BrojUgovora	Broj ugovora	string(25)		0..1
UrBroj	Filtriranje ugovora po urudžbenom broju. Ako nije poslano ne vrši se filtriranje po ovom elementu.	string(30)	Or}	0..1
/ugovor
/ugovori
/dohvatiUgovoreRequest

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

dohvatiUgovoreRequest

VsID

Identifikator vanjskog sustava (dogovara se)

string(36)

1..1

ugovori

Filteri grupe ugovora

1..1

Godina

Godina ugovora.

smallint

{Or

0..1

DatumSklapanjaOd

Datum sklapanja od kojega se žele dohvatiti ugovori

date

0..1

DatumSklapanjaDo

Datum sklapanja od kojega se žele dohvatiti ugovori

date

0..1

SifraTipaUgovora

Šifra tipa ugovora

string(5)

0..1

ParSifra

Šifra partnera iz LC SPI sustava. Za filtriranje partnera prema poslanim šiframa.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

string(10)

0..1

ParOIB

OIB partnera. Za filtriranje partnera prema poslanim OIB – ima.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

string(11)

0..1

ParPDVID

PDV ID broj partnera. Za filtriranje partnera prema poslanim PDVID brojevima.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

string(22)

0..1

ParNaziv

Naziv partnera. Za dodatno filtriranje partnera po dijelu naziva odnosno po elementima ParNaziv i ParNazivII iz odgovora (responsa) ove metode.
Ako nije poslano ne vrši se filtriranje po ovom elementu

string(40)

0..1

Klasa

Filtriranje ugovora po klasifikacijskoj oznaci.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

string(30)

0..1

DatumIzmjeneOd

Filtriranje ugovora prema početnom datumu izmjene u katalogu.
Podaci se filtriraju prema datumu i vremenu nastanka ili naknadne promjene.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

datetime

0..1

DatumIzmjeneDo

Filtriranje ugovora prema završnom datumu izmjene u katalogu.
Podaci se filtriraju prema datumu i vremenu nastanka ili naknadne promjene.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

datetime

0..1

StatusIzvrsen

Filter – Oznaka izvršenosti ugovora (0-neizvršen; 1-izvršen).

bit

0..1

ugovor

Filteri za pojedini ugovor

0..n

DokGUID

Identifikator ugovora u LC SPI sustavu

string(36)

0..1

BrojUgovora

Broj ugovora

string(25)

0..1

UrBroj

Filtriranje ugovora po urudžbenom broju.
Ako nije poslano ne vrši se filtriranje po ovom elementu.

string(30)

Or}

0..1

/ugovor

/ugovori

/dohvatiUgovoreRequest

* Filteri filtriraju Response listu na način da se iz kataloga ugovora LC SPI sustava izdvajaju samo podaci koji sadrže vrijednost poslanu u navedenim filterima.
* Tag ugovori je obavezan tj. obavezno je poslati bar jedan od filtera kako bi se reducirala količina podataka u odgovoru metode te umanjila mogućnost greške radi prevelike količine podataka.
* Moguće je kombinirati više filtera pri čemu se filtriranje vrši po svim poslanim vrijednostima istih.

Specifikacija izlaznog XML-a:

Struktura	Opis	Tip podatka	Broj pojavljivanja elementa
dohvatiUgovoreResponse
VsID	Identifikator vanjskog sustava (dogovara se)	string(36)	1..1
ugovori	0..1
ugovor	1..n
DokVrsta	Vrsta dokumenta u LC SPI sustavu „UGO125“ – ugovor (fiksno)	string(40)	1..1
DokGUID	Identifikator ugovora u LC SPI sustavu	string(36)	1..1
Godina	Godina ugovora.	smallint	1..1
BrojUgovora	Broj ugovora	string(25)	1..1
TipDokumenta	Naziv 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>
DatumSklapanja	Datum sklapanja ugovora	date	1..1
OpisUgovora	Opis ugovora	string(200)	1..1
RbUgovora	Redni broj ugovora	string(10)	0..1
EvBrojPostupka	Evidencijski broj postupka	string(20)	0..1
Klasa	Klasifikacijska oznaka ugovora	string(30)	0..1
UrBroj	Urudžbeni broj ugovora	string(30)	0..1
TipUgovora	Naziv 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 >
VrijediDo	Datum do kada vrijedi ugovor	datetime	0..1
Partner	Naziv 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 >
BrojUgovoraPartnera	Broj ugovora partnera	string(50)	0..1
ProcVrijNabaveNeto	Procijenjena neto vrijednost nabave	decimal(18,2)	0..1
ProcVrijNabavePDV	Procijenjena vrijednost poreza	decimal(18,2)	0..1
ProcVrijNabaveBruto	Procijenjena bruto vrijednost nabave	decimal(18,2)	0..1
ProcVrijNabaveBrutoValuta	Procijenjena 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>
KonacnaVrijNeto	Konačna neto vrijednost ugovora	decimal(18,2)	0..1
KonacnaVrijPDV	Konačna vrijednost poreza ugovora	decimal(18,2)	0..1
KonacnaVrijBruto	Konačna bruto vrijednost ugovora	decimal(18,2)	0..1
RealiziranaVrij	Realizirana vrijednost ugovora	decimal(18,2)	0..1
Ustupanje	Oznaka da li se može izvršiti ustupanje vrijednosti 0 - ne može se ustupati (default) 1 - može se ustupati	bit	0..1
UstupanjeVrijNeto	Neto vrijednost koja se ustupa	decimal(18,2)	0..1
UstupanjaVrijBruto	Bruto vrijednost koja se ustupa	decimal(18,2)	0..1
UstupanjeOpis	Opis dijela ustupanja	string(4000)	0..1
Podizvodjaci	Podizvođači – opisni podatak	string(4000)	0..1
GodinaPocetka	Godina početka	smallint	0..1
GodinaZavrsetka	Godina završetka	smallint	0..1
RokPocetka	Rok početka	datetime	0..1
RokZavrsetka	Rok završetka	datetime	0..1
StvarniPocetak	Stvarni datum početka	datetime	0..1
StvarniZavrsetak	Stvarni datum završetka	datetime	0..1
RokIsporukeUDanima	Rok isporuke u danima	smallint	0..1
RokPlacanjaUDanima	Rok plaćanja u danima	smallint	0..1
OpisPlacanja	Opis plaćanja	string(4000)	0..1
DonosPlacanja	Donos plaćanja	decimal(18,2)	0..1
Napomena	Napomena na ugovoru	string(500)	0..1
Odjel	Naziv odjela. Sadrži atribut @sifra smallint – šifra odjela u LC SPI bazi – 1..1	string(80)	0..1
<Odjel sifra="73">Ured grada</Odjel >
MjestoTroska	Naziv 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>
Razdjel	Naziv 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>
UgovorNeodredjeno	Ugovor na neodređeno vrijeme 0 – na određeno (default); 1 – na neodređeno	bit	0..1
DokGUIDPrethodni	Ako je ugovor aneks, ovdje se vraća GUID izvornog ugovora po kojem je aneks nastao	string(36)	0..1
StatusIzvrsen	Oznaka izvršenosti ugovora (0-neizvršen; 1-izvršen)	bit	0..1
DatumVrijemeIzmjene	Datum i vrijeme zadnje izmjene ugovora	datetime	1..1
privitci	0..1
privitak	1..n
PrivitakGUID	Identifikator privitka u LC SPI sustavu	string(36)	1..1
PrivitakNaziv	Naziv privitka	string(30)	1..1
/privitak
/privitci
/ugovor
/ugovori
greska		0..1
Greska	1 – greška	tinyint	1..1
OpisGreske	Opis greške prilikom dohvata podatka	string(300)	1..1
/greska
/dohvatiUgovoreResponse

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

dohvatiUgovoreResponse

VsID

Identifikator vanjskog sustava (dogovara se)

string(36)

1..1

ugovori

0..1

ugovor

1..n

DokVrsta

Vrsta dokumenta u LC SPI sustavu
„UGO125“ – ugovor (fiksno)

string(40)

1..1

DokGUID

Identifikator ugovora u LC SPI sustavu

string(36)

1..1

Godina

Godina ugovora.

smallint

1..1

BrojUgovora

Broj ugovora

string(25)

1..1

TipDokumenta

Naziv 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>

DatumSklapanja

Datum sklapanja ugovora

date

1..1

OpisUgovora

Opis ugovora

string(200)

1..1

RbUgovora

Redni broj ugovora

string(10)

0..1

EvBrojPostupka

Evidencijski broj postupka

string(20)

0..1

Klasa

Klasifikacijska oznaka ugovora

string(30)

0..1

UrBroj

Urudžbeni broj ugovora

string(30)

0..1

TipUgovora

Naziv 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 >

VrijediDo

Datum do kada vrijedi ugovor

datetime

0..1

Partner

Naziv 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 >

BrojUgovoraPartnera

Broj ugovora partnera

string(50)

0..1

ProcVrijNabaveNeto

Procijenjena neto vrijednost nabave

decimal(18,2)

0..1

ProcVrijNabavePDV

Procijenjena vrijednost poreza

decimal(18,2)

0..1

ProcVrijNabaveBruto

Procijenjena bruto vrijednost nabave

decimal(18,2)

0..1

ProcVrijNabaveBrutoValuta

Procijenjena bruto vrijednost nabave u stranoj valuti
Sadrži atribut:
@valuta varchar (3)– troznačna oznaka valute – 1..1

decimal(18,2)

0..1

KonacnaVrijNeto

Konačna neto vrijednost ugovora

decimal(18,2)

0..1

KonacnaVrijPDV

Konačna vrijednost poreza ugovora

decimal(18,2)

0..1

KonacnaVrijBruto

Konačna bruto vrijednost ugovora

decimal(18,2)

0..1

RealiziranaVrij

Realizirana vrijednost ugovora

decimal(18,2)

0..1

Ustupanje

Oznaka da li se može izvršiti ustupanje vrijednosti
0 - ne može se ustupati (default)
1 - može se ustupati

bit

0..1

UstupanjeVrijNeto

Neto vrijednost koja se ustupa

decimal(18,2)

0..1

UstupanjaVrijBruto

Bruto vrijednost koja se ustupa

decimal(18,2)

0..1

UstupanjeOpis

Opis dijela ustupanja

string(4000)

0..1

Podizvodjaci

Podizvođači – opisni podatak

string(4000)

0..1

GodinaPocetka

Godina početka

smallint

0..1

GodinaZavrsetka

Godina završetka

smallint

0..1

RokPocetka

Rok početka

datetime

0..1

RokZavrsetka

Rok završetka

datetime

0..1

StvarniPocetak

Stvarni datum početka

datetime

0..1

StvarniZavrsetak

Stvarni datum završetka

datetime

0..1

RokIsporukeUDanima

Rok isporuke u danima

smallint

0..1

RokPlacanjaUDanima

Rok plaćanja u danima

smallint

0..1

OpisPlacanja

Opis plaćanja

string(4000)

0..1

DonosPlacanja

Donos plaćanja

decimal(18,2)

0..1

Napomena

Napomena na ugovoru

string(500)

0..1

Odjel

Naziv odjela. Sadrži atribut
@sifra smallint – šifra odjela u LC SPI bazi – 1..1

string(80)

0..1

<Odjel sifra="73">Ured grada</Odjel >

MjestoTroska

Naziv 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>

Razdjel

Naziv 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>

UgovorNeodredjeno

Ugovor na neodređeno vrijeme
0 – na određeno (default);
1 – na neodređeno

bit

0..1

DokGUIDPrethodni

Ako je ugovor aneks, ovdje se vraća GUID izvornog ugovora po kojem je aneks nastao

string(36)

0..1

StatusIzvrsen

Oznaka izvršenosti ugovora (0-neizvršen; 1-izvršen)

bit

0..1

DatumVrijemeIzmjene

Datum i vrijeme zadnje izmjene ugovora

datetime

1..1

privitci

0..1

privitak

1..n

PrivitakGUID

Identifikator privitka u LC SPI sustavu

string(36)

1..1

PrivitakNaziv

Naziv privitka

string(30)

1..1

/privitak

/privitci

/ugovor

/ugovori

greska

0..1

Greska

1 – greška

tinyint

1..1

OpisGreske

Opis greške prilikom dohvata podatka

string(300)

1..1

/greska

/dohvatiUgovoreResponse

* U odgovoru metode dohvatiUgovore se vraća unija podataka iz kataloga prema poslanim filterima.
* Ukoliko ugovor sadrži privitke na sebi, u dogovoru metode se vraćaju identifikatori istih kako bi se omogućio dohvat privitaka putem metode dohvatiPrivitke
.

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:dohvatiUgovoreRequest>
					<v0:VsID>SC</v0:VsID>
					<v0:ugovori>
						<!--Zero or more repetitions:-->
						<v0:ugovor>
							<!--Optional:-->
							<v0:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</v0:DokGUID>
							<!--Optional:-->
							<v0:BrojUgovora>20/0001</v0:BrojUgovora>
						</v0:ugovor>
					</v0:ugovori>
				</v0:dohvatiUgovoreRequest>
				</soapenv:Body>
			</soapenv:Envelope>
        

Primjer responsea:

			<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
				<soap:Body>
				<ns4:dohvatiUgovoreResponse 
						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:DokVrsta>UGO125</ns4:DokVrsta>
							<ns4:DokGUID>F8D2D449-A70E-4472-A849-25EAEADF50F6</ns4:DokGUID>
							<ns4:Godina>2020</ns4:Godina>
							<ns4:BrojUgovora>20/0001</ns4:BrojUgovora>
							<ns4:TipDokumenta sifra="UGO">UGOVOR</ns4:TipDokumenta>
							<ns4:DatumSklapanja>2020-03-31</ns4:DatumSklapanja>
							<ns4:OpisUgovora>Ugovor o javnoj nabavi uredskog materijala</ns4:OpisUgovora>
							<ns4:RbUgovora>0</ns4:RbUgovora>
							<ns4:EvBrojPostupka/>
							<ns4:BrojUgovoraPartnera/>
							<ns4:ProcVrijNabaveNeto>0.00</ns4:ProcVrijNabaveNeto>
							<ns4:ProcVrijNabavePDV>0.00</ns4:ProcVrijNabavePDV>
							<ns4:ProcVrijNabaveBruto>0.00</ns4:ProcVrijNabaveBruto>
							<ns4:KonacnaVrijNeto>0.00</ns4:KonacnaVrijNeto>
							<ns4:KonacnaVrijPDV>0.00</ns4:KonacnaVrijPDV>
							<ns4:KonacnaVrijBruto>0.00</ns4:KonacnaVrijBruto>
							<ns4:RealiziranaVrij>0.00</ns4:RealiziranaVrij>
							<ns4:Ustupanje>false</ns4:Ustupanje>
							<ns4:UstupanjeOpis/>
							<ns4:Podizvodjaci/>
							<ns4:OpisPlacanja/>
							<ns4:DonosPlacanja>0.00</ns4:DonosPlacanja>
							<ns4:Napomena/>
							<ns4:UgovorNeodredjeno>false</ns4:UgovorNeodredjeno>
							<ns4:StatusIzvrsen>false</ns4:StatusIzvrsen>
							<ns4:DatumVrijemeIzmjene>2022-08-10T13:09:26</ns4:DatumVrijemeIzmjene>
						</ns4:ugovor>
					</ns4:ugovori>
				</ns4:dohvatiUgovoreResponse>
				</soap:Body>
			</soap:Envelope>
        