POČETNA SPI SC servis

Metoda spremiRaspodjeluPoPozicijamaDokumenta

Opis Metoda za spremanje raspodjele dokumenta po pozicijama.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiRaspodjeluPoPozicijamaDokumentaRequest
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
Godina Poslovna godina dokumenata za koje se sprema raspodjela smallint 1..1
dokumenti 1..1
dokument 1..n
DokGUID Globalni jedinstveni identifikator iz vanjskog sustava. Koristi se za identifikaciju dokumenta u LC SPI sustavu string(36) 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) 1..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.
Od datuma uvođenja EUR-a će se provjeravati kao obavezan element
string(3) 0..1
/raspodjela
/raspodjele
/dokument
/dokumenti
/spremiRaspodjeluPoPozicijamaDokumentaRequest

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiRaspodjeluPoPozicijamaDokumentaResponse
VsID Identifikator vanjskog sustava (dogovara se) string(36) 1..1
Godina Poslovna godina smallint 1..1
dokumenti 1..1
dokument 1..n
DokGUID Globalni jedinstveni identifikator iz vanjskog sustava. Koristi se za identifikaciju dokumenta u LC SPI sustavu string(36) 1..1
greska 0..1
Greska 0 – nema greške;
1 - greška (nije pronađen dokument sa poslanim identifikatorom);
2 – greška (dokument ima raspodjelu);
3 – greška (nepostojeća pozicija u aktivnom planu);
4 – greška (nepostojeći konto);
5 - greška (nepostojeći konto na poziciji za aktivni plan);
6 – greška (suma raspodjele ne odgovara iznosu dokumenta);
7 – greška (dokument pripada početnom stanju);
8 – greška (neispravna valuta raspodjele);
tinyint 1..1
OpisGreske Opis greške u slučaju da dokument nije uspješno obrađen u LC SPI sustavu.
– obavezan za Greska <> 0
string(300) 1..1
/greska
/dokument
/dokumenti
greska 0..1
Greska 1 – greška tinyint 1..1
OpisGreske Opis greške prilikom spremanja podatka string(300) 1..1
/greska
/spremiRaspodjeluPoPozicijamaDokumentaResponse

* Metoda omogućuje spremanje raspodjele po pozicijama za dokumente: Ulazni račun i Knjižni zapis.

* 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.

* Slanje valute je obvezno ukoliko je datum pozivanja metode veći ili jednak datumu uvođenja eura definranom u parametrima LCW099, u suprotnom je opcionalno. Poslana valuta mora biti prema ISO 4217 standardu.

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:spremiRaspodjeluPoPozicijamaDokumentaRequest> <v0:VsID>SC</v0:VsID> <v0:Godina>2023</v0:Godina> <v0:dokumenti> <!--1 or more repetitions:--> <v0:dokument> <v0:DokGUID>9A349EAB-3326-EE11-8110-00145ED6B470</v0:DokGUID> <!--Optional:--> <v0:raspodjele> <!--1 or more repetitions:--> <v0:raspodjela> <v0:PozSifra>R2661</v0:PozSifra> <v0:KonKonto>42211112</v0:KonKonto> <v0:Iznos>8000</v0:Iznos> <!--Optional:--> <v0:Valuta>EUR</v0:Valuta> </v0:raspodjela> <v0:raspodjela> <v0:PozSifra>R1510</v0:PozSifra> <v0:KonKonto>4221111</v0:KonKonto> <v0:Iznos>500</v0:Iznos> <!--Optional:--> <v0:Valuta>EUR</v0:Valuta> </v0:raspodjela> </v0:raspodjele> </v0:dokument> </v0:dokumenti> </v0:spremiRaspodjeluPoPozicijamaDokumentaRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:spremiRaspodjeluPoPozicijamaDokumentaResponse 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:DokGUID>9A349EAB-3326-EE11-8110-00145ED6B470</ns2:DokGUID> <ns2:greska> <ns2:Greska>0</ns2:Greska> <ns2:OpisGreske /> </ns2:greska> </ns2:dokument> </ns2:dokumenti> </ns2:spremiRaspodjeluPoPozicijamaDokumentaResponse> </soap:Body> </soap:Envelope>