POČETNA SPI SC servis

Metoda dohvatiNarudzbeniceLista

Opis Dohvati listu narudžbenica

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
dohvatiNarudzbeniceListaRequest
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
Godina Filter – Godina narudžbenice smallint 1..1
narudzbenice {Or 1..1
DatumNarudzbeniceOd Filter – Datum izrade narudžbenice date 0..1
DatumNarudzbeniceDo Filter – Datum izrade narudžbenice date 0..1
BrojUgovora Filter – Šifra Broja ugovora na kojeg je vezana narudžbenica string(25) 0..1
PartnerSifra Filter – Šifra partnera iz LCSPI sustava string(10) 0..1
PartnerOIB Filter – OIB partnera iz LCSPI sustava string(11) 0..1
PartnerNaziv Filter – Naziv ponuditelja iz LCSPI sustava. Moguće filtriranje po dijelu naziva string(40) 0..1
OrgNivoSifra Filter – Šifra Nivoa iz LCSPI sustava string(9) 0..1
RowGuid Globalni jedinstveni identifikator u sustavu string(36) 0..1
StatusNarudzbenice Oznaka statusa: 1 – U pripremi, 2 – Odobrena, 3 – Odbijena, 4 – Stornirana tinyint 0..1
ZatvorenaNarudzbenica Oznaka: 1 – Zatvorene narudžbenice, 2 – Otvorene narudžbenice tinyint 0..1
narudzbenica Or} 0..n
RowGuid Globalni jedinstveni identifikator u sustavu string(36) 1..1
/ narudzbenica
/ narudzbenice
/ dohvatiNarudzbeniceListaRequest

* 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 godina je obavezan tj. obavezno je poslati barem godinu za koju se dohvaćaju narudžbenice
* Moguće je kombinirati više filtera pri čemu se filtriranje vrši po svim poslanim vrijednostima istih. Moguće je dohvatiti određenu narudžbenicu. Ako se ne proslijedi nivo dohvaća se narudžbenica bez nivoa

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
dohvatiNarudzbeniceListaResponse
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
Godina Filter – Godina narudžbenice smallint 1..1
narudzbenice {Or 1..1
narudzbenica 1..n
DatumNarudzbenice Datum izrade narudžbenice date 1..1
BrojNarudzbenice Broj narudžbenice u SPI sustavu string(10) 1..1
BrojUgovora Šifra Broja ugovora na kojeg je vezana narudžbenica string(25) 0..1
PartnerSifra Šifra partnera iz LCSPI sustava string(10) 0..1
PartnerOIB OIB partnera iz LCSPI sustava string(11) 0..1
PartnerNaziv Naziv partnera iz LCSPI sustava. string(40) 1..1
IznosNarudzbeniceNeto Vrijednost narudžbenice bez PDV-a decimal(18,2) 1..1
IznosNarudzbenicePDV Vrijednost PDV-a narudžbenice decimal(18,2) 1..1
IznosNarudzbeniceBruto Vrijednost narudžbenice s PDV-om decimal(18,2) 1..1
CPVOznakaGlavna Šifra CPV oznake string(10) 0..1
OrgNivoSifra Šifra Nivoa iz LCSPI sustava string(9) 0..1
RowGuid Globalni jedinstveni identifikator u sustavu string(36) 0..1
/ narudzbenica
/ narudzbenice
greska Or} 1..1
Greska 1 - greška tinyint 1..1
OpisGreške Opis greške prilikom dohvata podataka string(300) 1..1
/ greska
/ dohvatiNarudzbeniceListaResponse

* U odgovoru metode dohvatiNarudzbeniceLista se vraća lista podataka.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenalc127/v0.1"> <soapenv:Header /> <soapenv:Body> <v0:dohvatiNarudzbeniceListaRequest> <v0:VsID>SC</v0:VsID> <v0:Godina>2023</v0:Godina> <v0:narudzbenice> <!--Optional:--> <v0:DatumNarudzbeniceOd>2023-07-01</v0:DatumNarudzbeniceOd> <!--Optional:--> <v0:DatumNarudzbeniceDo>2023-07-30</v0:DatumNarudzbeniceDo> </v0:narudzbenice> </v0:dohvatiNarudzbeniceListaRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns4:dohvatiNarudzbeniceListaResponse xmlns:ns7="http://www.spi.hr/ws/razmjena/sc/v0.1" xmlns:ns6="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02" xmlns:ns5="http://www.spi.hr/ws/razmjena/sc/razmjenalc125/v0.1" xmlns:ns4="http://www.spi.hr/ws/razmjena/sc/razmjenalc127/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:Godina>2023</ns4:Godina> <ns4:narudzbenice> <ns4:narudzbenica> <ns4:DatumNarudzbenice>2023-07-25</ns4:DatumNarudzbenice> <ns4:BrojNarudzbenice>23R0000302</ns4:BrojNarudzbenice> <ns4:PartnerNaziv>"AUTOPRIJEVOZNIK"</ns4:PartnerNaziv> <ns4:IznosNarudzbeniceNeto>2.00</ns4:IznosNarudzbeniceNeto> <ns4:IznosNarudzbenicePDV>0.50</ns4:IznosNarudzbenicePDV> <ns4:IznosNarudzbeniceBruto>2.50</ns4:IznosNarudzbeniceBruto> <ns4:RowGuid>F26C6ABD-B6A6-4062-A52F-795130A4082B</ns4:RowGuid> </ns4:narudzbenica> <ns4:narudzbenica> <ns4:DatumNarudzbenice>2023-07-25</ns4:DatumNarudzbenice> <ns4:BrojNarudzbenice>23R00001</ns4:BrojNarudzbenice> <ns4:PartnerNaziv>SVAN D.O.O.</ns4:PartnerNaziv> <ns4:IznosNarudzbeniceNeto>200.00</ns4:IznosNarudzbeniceNeto> <ns4:IznosNarudzbenicePDV>0.00</ns4:IznosNarudzbenicePDV> <ns4:IznosNarudzbeniceBruto>200.00</ns4:IznosNarudzbeniceBruto> <ns4:RowGuid>0FDB76F5-DFDC-4E3A-B37B-F9BCECC846E7</ns4:RowGuid> </ns4:narudzbenica> </ns4:narudzbenice> </ns4:dohvatiNarudzbeniceListaResponse> </soap:Body> </soap:Envelope>

Primjer dohvata podataka za narudžbenice iz 2019. Godine za razdoblje od 1.1. do 31.3.:

-- OBVEZNI PARAMETRI DECLARE @Godina SMALLINT= 2019; DECLARE @DatumNarudzbeniceOd DATETIME= '2019-01-01'; DECLARE @DatumNarudzbeniceDo DATETIME= '2019-03-31'; -- OPCIONALNI PARAMETRI SELECT nar.DatumNarudzbenice, nar.BrojNarudzbenice, par.Naziv, nar.VrijednostNarudzbeniceBezPDV, nar.VrijednostNarudzbenicePDV, nar.VrijednostNarudzbeniceSPDV, CPVG.Naziv, niv.NAZIV FROM LC127_Narudzbenica nar INNER JOIN LCZAJ_Partneri par ON par.PartneriID = nar.PartneriID LEFT JOIN LCZAJ_Nivoi niv ON niv.NivoiID = nar.NivoiID LEFT JOIN LC127_CPVGlavniRjecnik AS CPVG ON CPVG.CPVGlavniRjecnikID = nar.CPVGlavniRjecnikID WHERE nar.Godina = @Godina AND nar.DatumNarudzbenice >=IIF(@DatumNarudzbeniceOd IS NOT NULL, @DatumNarudzbeniceOd, NAR.DatumNarudzbenice) AND nar.DatumNarudzbenice <= IIF(@DatumNarudzbeniceDo IS NOT NULL, @DatumNarudzbeniceDo, NAR.DatumNarudzbenice);