POČETNA SPI SC servis

Metoda dohvatiSCDokumente

OpisVraća podatke o dokumentima iz LC SPI salda kontija

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
dohvatiSCDokumenteRequest
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
DatumZadnjegPreuzimanja Datum prema kojem će se filtrirati podaci u dohvatu.
Ako se ne pošalje željeni datum tada se dohvaćaju svi podaci.
Podaci se filtriraju prema datumu i vremenu nastanka ili naknadne promjene.
datetime 0..1
DatDokumentaOd Početni datum dokumenta od kojeg se vrši dohvat date 0..1
DatDokumentaDo Završni datum dokumenta do kojeg se vrši dohvat date 0..1
ZahtjevGUID GUID Zahtjeva. Dohvaćanje SC dokumenata nastalih po određenom zahtjevu. string(36) 0..1
dokumenti0..n
dokument1..n
DokVrsta Određuje vrstu dokumenta
R – račun(IRA, URA)
S – storno(KKI, KKS, KDI, KDS)
O – odobrenje(KKO, KDO)
T – dodatno terećenje(KKT, KKX, KDT, KDX)
K – kamata(KKK, KDK)
string(1) 0..1
KDVrsta K – kupac; D – dobavljač string(1) 0..1
ParSifra Šifra partnera iz LC SPI sustava. Za filtriranje dokumenata prema poslanoj LC SPI šifri partnera.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(10) 0..1
ParOIB OIB partnera. Za filtriranje dokumenata prema poslanim OIB – ima partnera.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(11) 0..1
ParGUID Jedinstveni identifikator partnera po kojem se može vršiti filtriranje dokumenata za tog partnera.
Ako nije poslano ne vrši se filtriranje po ovom elementu.
string(36) 0..1
DokBrojRacuna Broj računa string(30) 0..1
DokBrojUgovora Broj ugovora string(25) 0..1
DokGUID GUID Dokumenta string(36) 0..1
ERacunGUID Globalni jedinstveni identifikator zaprimljenog ili izdanog eRačuna string(36) 0..1
/dokument
/dokumenti
/dohvatiSCDokumenteRequest

* Filteri (neobavezni) filtriraju response listu na način da se iz kataloga dokumenata LC SPI sustava izdvajaju samo podaci koji sadrže vrijednost poslanu u navedenim filterima.
* Filtriranje po poslanim filterima se vrši na način potpunog uparivanja, odnosno vraća se podatak iz LC SPI kataloga kojem je pripadajući podatak identična poslanoj vrijednosti filtera.
* U slučaju da 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
dohvatiSCDokumenteResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
ZahtjevGUIDGUID Zahtjeva iz requesta.
Vraća se samo u slučaju da je u requestu metode poslan.
string(36)0..1
dokumenti{Or0..1
dokument1..n
DokGUIDGlobalni jedinstveni identifikator. Koristi se za daljnju identifikaciju dokumenta u LC SPI sustavustring(36)1..1
DokVrstaOdređuje vrstu dokumenta
R – račun (IRA, URA)
S – storno (KKI, KKS, KDI, KDS)
O – odobrenje (KKO, KDO)
T – dodatno terećenje (KKT, KKX, KDT, KDX)
K – kamata (KKK, KDK)
string(1)1..1
DokKnjigaVrsta pomoćne knjige:
R – redovni
P – predračun
U – uvoz
I - izvoz
O – osobna potrošnja
string(1)0..1
BrojKnjigeBroj u knjizi koji je dodijeljen unutar LC SPI sustava.string(10)1..1
TdSifraTip dokumenta u LC SPI sustavu – nije obavezan podatak.string(2)0..1
DokOpisOpis dokumentastring(300)0..1
KDVrstaK – kupac; D - dobavljačstring(1)1..1
DatDokumentaDatum dokumentadatetime1..1
DatDospijecaDatum dospijećadatetime1..1
DatKnjizenjaDatum knjiženjadatetime1..1
DatIsporukeDatum isporukedatetime0..1
DatPlacanjaDatum plaćanjadatetime0..1
DatOvjereDatum ovjeredatetime0..1
ValutaTroznačna valuta prema ISO 4217 standardu.
Označava osnovnu valutu u kojoj su vraćeni iznosi dokumenta.
Od datuma uvođenja EUR-a se vraća u responseu kao obavezan element.
string(3)0..1
partner0..1
ParSifraŠifra partnera iz LC SPI sustavastring(10)1..1
ParOIBOIB partnerastring(11)0..1
ParGUIDJedinstveni identifikator partnerastring(36)0..1
ParPDVIDPDV ID broj partnerastring(22)0..1
ParNazivNaziv poslovnog partnerastring(40)1..1
ParNazivIIDodatni naziv poslovnog partnerastring(40)0..1
ParVrstaD – domaći partner; E – EU partner; S – strani partnerstring(1)1..1
/partner
PnboModelModel poziva na broj odobrenjastring(4)0..1
PnboBrojPoziv na broj odobrenjastring(30)0..1
PnbzModelModel poziva na broj zaduženjastring(4)0..1
PnbzBrojPoziv na broj zaduženjastring(30)0..1
RIznosUkupan iznos robe prije odbijanja popusta i prije uračunavanja poreza
OBAVEZAN je ako se ne šalje UIznos
decimal(18,2)usluga 10..1
RRabatIznos rabata za robudecimal(18,2)0..1
RScontoIznos cassa sconto za robudecimal(18,2)0..1
RNetoNeto iznos robe s uračunatim popustima bez poreza
OBAVEZAN je ako se ne šalje UNeto
decimal(18,2)usluga 10..1
RPorezIznos poreza za robu
OBAVEZAN je ako se ne šalje UPorez
decimal(18,2)usluga 10..1
RBrutoUkupan iznos za robu sa svim popustima i porezima
OBAVEZAN je ako se ne šalje UBruto
decimal(18,2)usluga 10..1
UIznosUkupan iznos usluge prije odbijanja popusta i prije uračunavanja poreza
OBAVEZAN je ako se ne šalje RIznos
decimal(18,2)roba 10..1
URabatIznos rabata za uslugudecimal(18,2)0..1
UScontoIznos cassa sconto za uslugudecimal(18,2)0..1
UNetoNeto iznos usluge s uračunatim popustima bez poreza
OBAVEZAN je ako se ne šalje RNeto
decimal(18,2)roba 10..1
UPorezIznos poreza za uslugu
OBAVEZAN je ako se ne šalje RPorez
decimal(18,2)roba 10..1
UBrutoUkupan iznos za usluge sa svim popustima i porezima
OBAVEZAN je ako se ne šalje RBruto
decimal(18,2)roba 10..1
UkBrutoUkupan iznos računa (RBruto + UBruto)decimal(18,2)1..1
DevValutaŠifra strane valutestring(3)0..1
DevDatumDatum tečaja strane valutedate0..1
DevTecajIznos tečaja strane valutedecimal(18,6)0..1
DevRIznosDevizni iznos robedecimal(18,2)0..1
DevUIznosDevizni iznos uslugedecimal(18,2)0..1
UcdBrojBroj uvozne carinske deklaracijestring(15)0..1
IcdBrojBroj izvozne carinske deklaracijestring(10)0..1
DokBrojRacunaBroj računastring(30)0..1
DokBrojUgovoraBroj ugovorastring(25)0..1
MtSifraŠifra mjesta troška iz LC SPI sustava.string(15)0..1
MtNazivNaziv mjesta troškastring(40)0..1
PoreznaOznakaPS – redovan dokument
PE – porezna evidencija
SC – ne ulazi u obračun poreza
string(2)0..1
PlacNacin(G)otovinsko; (B)ezgotovinskostring(1)0..1
PlacIznosPlaćeni iznos računadecimal(18,2)0..1
ZatvorenDA – potpuno zatvoren; NE – nije u potpunosti zatvorenstring(2)0..1
SifraNamjeneŠifra namjene (propisana)string(4)0..1
VRPSifraŠifra vrste prihoda prema Naredbi o načinu uplaćivanja prihoda proračuna, obveznih doprinosa te prihoda za financiranje drugih javnih potrebastring(4)0..1
ERacunGUIDGlobalni jedinstveni identifikator vezanog zaprimljenog ili izdanog eRačunastring(36)0..1
poreznastruktura0..1
ps1..n
PsTipR – roba; U - uslugastring(1)1..1
PsPorezPostoPostotak porezadecimal(18, 2)1..1
PsOsnovicaIznos osnovice porezadecimal(18, 2)1..1
PsPorezIznosIznos porezadecimal(18, 2)1..1
PsKategorija1 - Oporezivo
2 - Ne podliježe
3 - Oslobođeno (Izvoz)
4 - Oslobođeno (tuzemstvo)
5 - Oslobođeno (ostalo)
6 - Isporuka EU
7 - Stjecanje EU
8 - Sastavljanje i postavljanje dobara u EU
9 - Nova prijevozna sredstva
10 - Prijenos porezne obveze (oporezivo)
11 - Prijenos porezne obveze (neoporezivo)
12 - Isporuke na daljinu EU
13 - Obavljene usluge osobama bez sjedišta u RH (neop)
14 - Naknadno oslobođenje izvoza (tax free)
15 - Obračunati PDV po uvozu
16 - Trostrani posao (posrednik)
17 - Može se odbiti
18 - Ne može se odbiti
19 - Reexport
20 - Primljene isporuke od PO bez sjedišta u RH
21 - Obavljene usluge osobama bez sjedišta u RH
string(3)1..1
PsPnkIznosIznos povratne naknadedecimal(18, 2)0..1
/ps
/poreznastruktura
/dokument
/dokumenti
greskaOr}0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom dohvata podatkastring(300)1..1
/greska
/dohvatiSCDokumenteResponse

* U odgovoru metode dohvatiSCDokumenteResponse 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:dohvatiSCDokumenteRequest> <v0:VsID>SC</v0:VsID> <!--Optional:--> <v0:dokumenti> <!--Zero or more repetitions:--> <v0:dokument> <!--Optional:--> <v0:DokGUID>F8D2D558-A70E-4472-A849-25EAEADF50F5</v0:DokGUID> </v0:dokument> </v0:dokumenti> </v0:dohvatiSCDokumenteRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns3:dohvatiSCDokumenteResponse 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:dokumenti> <ns3:dokument> <ns3:DokGUID>F8D2D558-A70E-4472-A849-25EAEADF50F5</ns3:DokGUID> <ns3:DokVrsta>R</ns3:DokVrsta> <ns3:DokKnjiga>R</ns3:DokKnjiga> <ns3:BrojKnjige>20/0000026</ns3:BrojKnjige> <ns3:TdSifra/> <ns3:DokOpis>Račun</ns3:DokOpis> <ns3:KDVrsta>K</ns3:KDVrsta> <ns3:DatDokumenta>2020-10-10T00:00:00</ns3:DatDokumenta> <ns3:DatDospijeca>2020-10-31T00:00:00</ns3:DatDospijeca> <ns3:DatKnjizenja>2020-12-31T00:00:00</ns3:DatKnjizenja> <ns3:partner> <ns3:ParSifra>0462861</ns3:ParSifra> <ns3:ParGUID>F8D2D558-A70E-4472-A849-25EAEADF50F4</ns3:ParGUID> <ns3:ParPDVID/> <ns3:ParNaziv>KONZUM D.O.O.</ns3:ParNaziv> <ns3:ParNazivII/> <ns3:ParVrsta>E</ns3:ParVrsta> </ns3:partner> <ns3:PnboModel>HR99</ns3:PnboModel> <ns3:PnboBroj/> <ns3:PnbzModel>HR99</ns3:PnbzModel> <ns3:PnbzBroj/> <ns3:RIznos>3000.00</ns3:RIznos> <ns3:RRabat>1000.00</ns3:RRabat> <ns3:RSconto>1000.00</ns3:RSconto> <ns3:RNeto>1000.00</ns3:RNeto> <ns3:RPorez>100.00</ns3:RPorez> <ns3:RBruto>1000.00</ns3:RBruto> <ns3:UIznos>3000.00</ns3:UIznos> <ns3:URabat>1000.00</ns3:URabat> <ns3:USconto>1000.00</ns3:USconto> <ns3:UNeto>1000.00</ns3:UNeto> <ns3:UPorez>100.00</ns3:UPorez> <ns3:UBruto>1000.00</ns3:UBruto> <ns3:UkBruto>2000.00</ns3:UkBruto> <ns3:DevValuta>HRK</ns3:DevValuta> <ns3:DevDatum>2020-05-31</ns3:DevDatum> <ns3:DevTecaj>1.000000</ns3:DevTecaj> <ns3:DevRIznos>1000.00</ns3:DevRIznos> <ns3:DevUIznos>1000.00</ns3:DevUIznos> <ns3:IcdBroj/> <ns3:DokBrojRacuna>20/0000026</ns3:DokBrojRacuna> <ns3:PoreznaOznaka>PS</ns3:PoreznaOznaka> <ns3:PlacNacin>B</ns3:PlacNacin> <ns3:PlacIznos>0.00</ns3:PlacIznos> <ns3:Zatvoren>NE</ns3:Zatvoren> <ns3:VRPSifra/> </ns3:dokument> </ns3:dokumenti> </ns3:dohvatiSCDokumenteResponse> </soap:Body> </soap:Envelope>