POČETNA SPI SC servis

Metoda kreirajSCDokumente

OpisSprema financijske dokumente o u LC SPI salda konte

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
kreirajSCDokumenteRequest
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
DjelomicnaObrada Oznaka koja omogućuje djelomičnu obradu podataka:
True – podaci koji zadovoljavaju uvijete za upis u LC SPI sustav se upisuju, dok se popis neispravnih podataka vraća u kreirajSCDokumenteResponse. Iznimka je kada nije zadovoljena xsd shema pri čemu se odbijaju svi podaci.
False – ako bilo koji podatak ne zadovoljava uvijete za spremanje u LC SPI sustav tada se odbijaju i svi ostali podaci i niti jedan neće biti upisan u LC SPI sustav.
Ako element nije poslan tada se smatra da je njegov status False.
true/false 0..1
dokumenti0..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
DokGUIDVezaGlobalni jedinstveni identifikator dokumenta (računa) iz vanjskog sustava koji se stornira, za koji se odobrava umanjenje iznosa ili po kojem nastaje dodatno terećenje.
Ovo je identifikator ranije poslanog dokumenta u LC SPI sustav po kojem se vrši dodatna radnja.
OBAVEZAN je kada je DokVrsta = 'S','O','T','K'
string(36)S,O,T,K0..1
TdSifraTip dokumenta u LC SPI sustavu – nije obavezan podatak.
Za korištenje vanjski sustav treba kod sebe evidentirati.
string(2)0..1
SifraZaRasporedivanjeNa osnovu ovog podatka je moguće u LC SPI sustavu vršiti dodatno raspoređivanje u financijama po organizacijskim nivoima. Prethodno je potrebno dogovoriti pravila za raspoređivanje.
Za korištenje vanjski sustav treba na osnovu dogovorenih pravila ovaj podatak puniti.
string(20)0..1
DokOpisOpis dokumenta
Ako je DokVrsta = 'R' i KDVrsta = 'K' i tip partnera u SC SPI sustavu <> 5-Ostalo maksimalna količina znakova je 60.
string(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 poslani iznosi dokumenta.
Od datuma uvođenja EUR-a će se provjeravati kao obavezan element
string(3)0..1
ParSifraŠifra partnera iz LC SPI sustavastring(10)1..1
RacBrojBroj računa (IBAN) partnerastring(40)0..1
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čuna
Ako je DokVrsta = 'R' i KDVrsta = 'D' maksimalna duljina je 30 znakova.
U ostalim slučajevima je maksimalno dozvoljeno 14 znakova
string(30)0..1
DokKnjigaR – redovni
P – predračun
U – uvoz
O – osobna potrošnja
string(1)0..1
MtSifraŠifra mjesta troška iz LC SPI sustava.string(15)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
PozSifraŠifra pozicijestring(8)0..1
KonKontoKontostring(12)0..1
URLDokumentaURL adresa dokumenta, npr.:
- URL do datoteke dokumenta
- URL na dokument u vanjskom sustavu
string(16000)0..1
ugovori0..1
ugovor1..n
GodinaUgovoraGodina ugovorasmallint0..1
BrojUgovoraBroj ugovorastring(25)1..1
IznosZaUgovorIznos dokumenta koji se veže za pripadajući ugovordecimal(18,2)1..1
/ugovor
/ugovori
narudzbenice0..1
narudzbenica1..n
RowGuidGlobalni jedinstveni identifikator u sustavustring(36)1..1
IznosZaNarudzbenicuIznos koji se veže za pripadajuću narudžbenicudecimal(18,2)1..1
/narudzbenica
/narudzbenice
VRPSifraŠifra vrste prihoda prema Naredbi o načinu uplaćivanja prihoda proračuna, obveznih doprinosa te prihoda za financiranje drugih javnih potreba.Šalje se samo za dokumente kupca, a kada je poslano za dokumente dobavljača tada se ignorira.string(4)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
PsKategorijaD – podliježe porezu; N – ne podliježe
1 - 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
/kreirajSCDokumenteRequest

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
kreirajSCDokumenteResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
dokumenti1..1
dokument1..n
DokGUIDGlobalni jedinstveni identifikator. Koristi se za daljnju identifikaciju dokumenta u LC SPI sustavustring(36)1..1
KorSifraŠifra korisnika u LC SPI sustavu na kojeg je dokument kreiran.
– obavezan za Greska <> 1
string(2)Greska <> 10..1
NivSifraŠifra organizacijskog nivoa u LC SPI sustavu na kojem je dokument kreiran.
– obavezan za Greska <> 1
string(9)Greska <> 10..1
DokVrstaVrsta dokumenta nastala u LC SPI sustavu (URR, IRR, KKI, KDI…)
– obavezan za Greska <> 1
string(3)Greska <> 10..1
BrojKnjigeBroj u knjizi koji je dodijeljen unutar LC SPI sustava.
– obavezan za Greska <> 1
string(10)Greska <> 10..1
status1..1
Greska0 – nema greške;
1 – greška (nije spremljeno);
2 – spremljeno (ali ne svi podaci);
3 – već postoji u LC SPI sustavu
tinyint1..1
OpisGreskeOpis greške u slučaju da dokument nije u potpunosti uspješno obrađen u LC SPI sustavu.
– obavezan za Greska <> 0
string(300)Greska = 00..1
/status
/dokument
/dokumenti
/kreirajSCDokumenteResponse

* Ako u LC SPI sustavu već postoji dokument po DokGUID tada će se spremanje podatka o dokumentu 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/razmjenasc/v0.1"> <soapenv:Header/> <soapenv:Body> <v0:kreirajSCDokumenteRequest> <v0:VsID>SC</v0:VsID> <v0:dokumenti> <!--1 or more repetitions:--> <v0:dokument> <v0:DokGUID>F8D2D558-A70E-4472-A849-25EAEADF50F5</v0:DokGUID> <v0:DokVrsta>R</v0:DokVrsta> <!--Optional:--> <v0:DokOpis>Račun</v0:DokOpis> <v0:KDVrsta>K</v0:KDVrsta> <v0:DatDokumenta>2020-10-10T15:00:00.000</v0:DatDokumenta> <v0:DatDospijeca>2020-10-31T15:07:38.6875000-05:00</v0:DatDospijeca> <v0:DatKnjizenja>2020-12-31T15:00:00.000</v0:DatKnjizenja> <v0:ParSifra>0462861</v0:ParSifra> <v0:RIznos>3000</v0:RIznos> <!--Optional:--> <v0:RRabat>1000</v0:RRabat> <!--Optional:--> <v0:RSconto>1000</v0:RSconto> <!--Optional:--> <v0:RNeto>1000</v0:RNeto> <!--Optional:--> <v0:RPorez>100</v0:RPorez> <!--Optional:--> <v0:RBruto>1000</v0:RBruto> <!--Optional:--> <v0:UIznos>3000</v0:UIznos> <!--Optional:--> <v0:URabat>1000</v0:URabat> <!--Optional:--> <v0:USconto>1000</v0:USconto> <!--Optional:--> <v0:UNeto>1000</v0:UNeto> <!--Optional:--> <v0:UPorez>100</v0:UPorez> <!--Optional:--> <v0:UBruto>1000</v0:UBruto> <v0:UkBruto>1000</v0:UkBruto> <!--Optional:--> <v0:DevValuta>HRK</v0:DevValuta> <!--Optional:--> <v0:DevDatum>2020-05-31</v0:DevDatum> <!--Optional:--> <v0:DevTecaj>1</v0:DevTecaj> <!--Optional:--> <v0:DevRIznos>1000</v0:DevRIznos> <!--Optional:--> <v0:DevUIznos>1000</v0:DevUIznos> </v0:dokument> </v0:dokumenti> </v0:kreirajSCDokumenteRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns3:kreirajSCDokumenteResponse 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:KorSifra>01</ns3:KorSifra> <ns3:NivSifra/> <ns3:DokVrsta>IRR</ns3:DokVrsta> <ns3:BrojKnjige>20/0000026</ns3:BrojKnjige> <ns3:status> <ns3:Greska>0</ns3:Greska> <ns3:OpisGreske/> </ns3:status> </ns3:dokument> </ns3:dokumenti> </ns3:kreirajSCDokumenteResponse> </soap:Body> </soap:Envelope>