POČETNA SPI SC servis

Metoda spremiRaspodjeluPoPozicijamaDokumentaV2 (verzija 2)

Opis Metoda za spremanje raspodjele dokumenta po pozicijama.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiRaspodjeluPoPozicijamaDokumentaRequest
VsID Identifikator sustava koji upućuje zahtijev string(36) 1..1
Godina Poslovna godina dokumenata za koje se sprema raspodjela smallint 1..1
DokVrsta Vrsta dokumenta u LC SPI sustavu
Enumeracija:
„SCD192“ – salda konti dokument (ulazni račun ili knjižni zapis)
„UGO125“ – ugovor
"NAR127" – narudžbenica
string(40) 1..1
DokGUID Identifikator dokumenta uniqueidentifier 1..1
raspodjele 1..1
raspodjela 1..n
PozSifra Šifra pozicije string(8) 1..1
KonKonto Konto troška vezan za poziciju. Dohvaća se metodom dohvatiKontaNaPozicijama. string(12) 0..1
MtSifra Šifra mjesta troška. Ukoliko je na poziciji evidentirano mjesto troška, ovaj podatak je obavezan. string(15) 0..1
OdjSifra Šifra odjela. Ukoliko je na poziciji evidentiran odjel, ovaj podatak je obavezan. string(12) 0..1
Iznos Iznos po poziciji (suma iznosa u raspodjeli mora odgovarati vrijednosti UkBruto sa dokumenta) decimal(18,2) 1..1
Valuta Troznačna šifra valute prema ISO 4217 standardu.
Označava osnovnu valutu u kojoj su poslani iznosi.
string(3) 0..1
CPVSifra CPV Oznaka glavnog rječnika string(10) 0..1
VratiCPVOznaku Na zahtjev vraća u Responseu Šifru CPV oznake
false - ne vraća CPV oznaku
true - vraća CPV oznaku
bit 0..1
PsKategorija D – 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) 0..1
PDVSifra Šifra porezne stope - dohvatiStopePDV
string(8) 0..1
/raspodjela
/raspodjele
/spremiRaspodjeluPoPozicijamaDokumenta

Crveno označena polja još nisu dostupna.

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiRaspodjeluPoPozicijamaDokumentaResponse
VsID Identifikator sustava koji upućuje zahtijev string(36) 1..1
Godina Poslovna godina smallint 1..1
DokVrsta Vrsta dokumenta u LC SPI sustavu
Enumeracija:
„SCD192“ – salda konti dokument (ulazni račun ili knjižni zapis)
„UGO125“ – ugovor
"NAR127" – narudžbenica
string(40) 1..1
DokGUID Identifikator dokumenta uniqueidentifier 1..1
raspodjele {Or 1..1
raspodjela 1..n
PozSifra Šifra pozicije string(8) 1..1
KonKonto Konto troška vezan za poziciju. string(12) 0..1
MtSifra Šifra mjesta troška string(15) 0..1
OdjSifra Šifra odjela string(12) 0..1
Iznos Iznos po poziciji decimal(18,2) 1..1
Valuta Troznačna šifra valute prema ISO 4217 standardu.
Označava osnovnu valutu u kojoj su poslani iznosi.
string(3) 0..1
CPVSifra CPV Oznaka glavnog rječnika string(10) 0..1
PsKategorija D – 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) 0..1
PDVSifra Šifra porezne stope - dohvatiStopePDV
string(8) 0..1
greska 1..1
Greska 0 – Nema greške
1 - Nije pronađen dokument s poslanim identifikatorom
2 – Dokument ima raspodjelu
3 – Nepostojeća pozicija u aktivnom planu
4 - Nepostojeći konto
5 - Nepostojeći konto na poziciji za aktivni plan
6 - Suma raspodjele ne odgovara iznosu dokumenta
7 - Dokument pripada početnom stanju
8 - Mjesto troska ne postoji u katalogu
9 - Mjesto troska je neaktivno u katalogu
10 - Odjel ne postoji u katalogu
11 - Mjesto troska je razlicito na stavci plana
12 - Odjel je različit na stavci plana
13 - CPV oznaka nije aktivna ili ne posoji u glavnom rječniku CPV-a
tinyint 1..1
OpisGreske Opis greške u slučaju da zapis nije uspješno ažuriran u sustavu.
– obavezan za Greska <> 0
string(300) 0..1
/greska
/raspodjela
/raspodjele
greska Or} 1..1
Greska 1 – greška (globalna);
2 - greška (poslovna godina je zatvorena);
3 - greška (nije pronađen dokument sa poslanim identifikatorom);
4 – greška (dokument već ima raspodjelu);
5 – greška (suma raspodjele ne odgovara iznosu dokumenta)
tinyint 1..1
OpisGreske Opis greške prilikom ažuriranja podatka string(300) 1..1
/greska
/spremiRaspodjeluPoPozicijamaDokumentaResponse

* Ako u LC SPI sustavu nije pronađena pozicija u aktivnom planu prema vrijednosti elementa PozSifra, konto na zadanoj poziciji prema vrijednosti elementa KonKonto i ukoliko suma vrijednosti elementa Iznos ne odgovara ukupnom iznosu dokumenta, metoda vraća grešku o nemogućnosti spremanja stavaka raspodjele za dokument radi nepoznate pozicije, konta na poziciji ili neodgovarajućih iznosa raspodjele.

* Ako u LC SPI sustavu već postoji raspodjela za poslani dokument tada će se spremanje podatka o raspodjeli ignorirati, a u izlaznom XML-u će se za taj dokument vratiti greška sa adekvatnim opisom.

* Ukoliko konto nije poslan, tada će se dodijeliti prvi konto troška vezan za poziciju. Navedeno vrijedi samo za narudžbenice. Za ostale dokumente, ukoliko se ne pošalje konto, metoda će vratiti grešku.

* Za ugovore moguće je poslati manji iznos raspodjele od same vrijednosti ugovora, za sve ostale dokumente metoda će vratiti grešku.

Primjer requesta:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v0="http://www.spi.hr/ws/razmjena/sc/razmjenarp/v0.1"> <soapenv:Header /> <soapenv:Body> <v0:spremiRaspodjeluPoPozicijamaDokumentaV2Request> <v0:VsID>SC</v0:VsID> <v0:Godina>2023</v0:Godina> <v0:DokVrsta>UGO125</v0:DokVrsta> <v0:DokGUID>2514A4A8-E62A-EE11-8110-00145ED6B470</v0:DokGUID> <v0:raspodjele> <!--1 or more repetitions:--> <v0:raspodjela> <v0:PozSifra>R0034</v0:PozSifra> <!--Optional:--> <v0:KonKonto>322110</v0:KonKonto> <!--Optional:--> <v0:OdjSifra>000 001</v0:OdjSifra> <v0:Iznos>5000.00</v0:Iznos> <!--Optional:--> <v0:Valuta>EUR</v0:Valuta> <!--Optional:--> <v0:CPVSifra>30192000-1</v0:CPVSifra> <!--Optional:--> <v0:VratiCPVOznaku>1</v0:VratiCPVOznaku> </v0:raspodjela> <v0:raspodjela> <v0:PozSifra>R0175</v0:PozSifra> <!--Optional:--> <v0:KonKonto>3221118</v0:KonKonto> <!--Optional:--> <v0:OdjSifra>000 001</v0:OdjSifra> <v0:Iznos>5000.00</v0:Iznos> <!--Optional:--> <v0:Valuta>EUR</v0:Valuta> <!--Optional:--> <v0:CPVSifra>30192000-1</v0:CPVSifra> <!--Optional:--> <v0:VratiCPVOznaku>1</v0:VratiCPVOznaku> </v0:raspodjela> </v0:raspodjele> </v0:spremiRaspodjeluPoPozicijamaDokumentaV2Request> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:spremiRaspodjeluPoPozicijamaDokumentaV2Response 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"> <ns2:VsID>SC</ns2:VsID> <ns2:Godina>2023</ns2:Godina> <ns2:dokumenti> <ns2:dokument> <ns2:DokVrsta>UGO125</ns2:DokVrsta> <ns2:DokGUID>2514A4A8-E62A-EE11-8110-00145ED6B470</ns2:DokGUID> <ns2:raspodjele> <ns2:raspodjela> <ns2:PozSifra>R0034</ns2:PozSifra> <ns2:KonKonto>322110</ns2:KonKonto> <ns2:OdjSifra>000 001</ns2:OdjSifra> <ns2:Iznos>5000.00</ns2:Iznos> <ns2:Valuta>EUR</ns2:Valuta> <ns2:CPVSifra>30192000-1</ns2:CPVSifra> </ns2:raspodjela> <ns2:raspodjela> <ns2:PozSifra>R0175</ns2:PozSifra> <ns2:KonKonto>3221118</ns2:KonKonto> <ns2:OdjSifra>000 001</ns2:OdjSifra> <ns2:Iznos>5000.00</ns2:Iznos> <ns2:Valuta>EUR</ns2:Valuta> <ns2:CPVSifra>30192000-1</ns2:CPVSifra> </ns2:raspodjela> </ns2:raspodjele> </ns2:dokument> </ns2:dokumenti> </ns2:spremiRaspodjeluPoPozicijamaDokumentaV2Response> </soap:Body> </soap:Envelope>