POČETNA SPI SC servis

Metoda spremiStavkeKontiranjaDokumenata

OpisSpremanje podataka o kontiranju dokumenata unutar LC SPI baze podataka.

Specifikacija ulaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiStavkeKontiranjaDokumenataRequest
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
GodinaPoslovna godinasmallint1..1
dokumenti1..1
dokument1..n
DokGUIDGlobalni jedinstveni identifikator iz vanjskog sustava. Koristi se za identifikaciju dokumenta u LC SPI sustavustring(36)1..1
kontiranja1..1
kontiranje1..n
RbRedni broj stavke kontiranjasmallint1..1
DatumDatum stavkedate1..1
PozSifraŠifra pozicijestring(8)0..1
KonKontoKontostring(12)1..1
MtSifraŠifra mjesta troška iz LC SPI sustava.string(15)0..1
DugujeIznos na dugovnoj stranidecimal(18,2)1..1
PotrazujeIznos na potražnoj stranidecimal(18,2)1..1
ValutaTroznačna šifra valute 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
OpisOpis stavke kontiranjastring(200)0..1
/kontiranje
/kontiranja
/dokument
/dokumenti
/spremiStavkeKontiranjaDokumenataRequest

* Ako kontiranje za dokument ne postoji u LC SPI sustavu tada se ovom metodom dodaje.
* Metoda prije spremanja kontiranja izvršiti potrebne provjere i ako neka od provjera nije zadovoljena tada će metoda vratiti grešku u odgovoru.
* Spremanje podataka o kontiranju dokumenata dozvoljeno je samo u slučaju kada operater dodijeljen vanjskom sustavu ima prava za dodavanje stavki kontiranja u LC SPI sustav, a u suprotnom će metoda vratiti grešku u izlaznom XML-u.
* Nije moguće slanje djelomičnog kontiranja za pojedini dokument.

Specifikacija izlaznog XML-a:

Struktura Opis Tip podatka Uvjet Broj pojavljivanja elementa
spremiStavkeKontiranjaDokumenataResponse
VsIDIdentifikator vanjskog sustava (dogovara se)string(36)1..1
GodinaPoslovna godinasmallint1..1
dokumenti1..1
dokument1..n
DokGUIDGlobalni jedinstveni identifikator iz vanjskog sustava. Koristi se za identifikaciju dokumenta u LC SPI sustavustring(36)1..1
kontiranja0..1
kontiranje1..n
RbRedni broj stavke kontiranjasmallint1..1
DatumDatum stavkedate1..1
PozSifraŠifra pozicijestring(8)0..1
KonKontoKontostring(12)1..1
MtSifraŠifra mjesta troška iz LC SPI sustava.string(15)0..1
DugujeIznos na dugovnoj stranidecimal(18,2)1..1
PotrazujeIznos na potražnoj stranidecimal(18,2)1..1
ValutaTroznačna šifra valute prema ISO 4217 standardu.
Označava osnovnu valutu u kojoj su poslani iznosi dokumenta.
Od datuma uvođenja EUR-a će se vraćati kao obavezan element
string(3)0..1
OpisOpis stavke kontiranjastring(200)0..1
/kontiranje
/kontiranja
greska0..1
Greska 0 – nema greške;
1 - greška (nije pronađen dokument sa poslanim identifikatorom)
2 – greška (dokument je već kontiran);
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 (nepostojeće mjesto troška)
7 – greška (suma dugovne i potražne strane je različita);
8 – greška (neispravna valuta kontiranja);
tinyint1..1
OpisGreskeOpis 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
greska0..1
Greska1 – greškatinyint1..1
OpisGreskeOpis greške prilikom spremanja podatkastring(300)1..1
/greska
/spremiStavkeKontiranjaDokumenataResponse

* 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 mjesto troška prema vrijednosti elementa MtSifra metoda vraća grešku o nemogućnosti spremanja stavaka kontiranja za dokument radi nepoznate pozicije, konta na poziciji ili mjesta troška.
* Ako u LC SPI sustavu već postoji kontiranje za poslani dokument tada će se spremanje podatka o kontiranju ignorirati, a u izlaznom XML-u će se za taj dokument vratiti greška sa adekvatnim opisom.

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:spremiStavkeKontiranjaDokumenataRequest> <v0:VsID>SC</v0:VsID> <v0:Godina>2020</v0:Godina> <v0:dokumenti> <!--1 or more repetitions:--> <v0:dokument> <v0:DokGUID>F8D2D558-A70E-4472-A849-25EAEADF50F5</v0:DokGUID> <v0:kontiranja> <!--1 or more repetitions:--> <v0:kontiranje> <v0:Rb>1</v0:Rb> <v0:Datum>2020-05-31</v0:Datum> <v0:KonKonto>611110</v0:KonKonto> <v0:Duguje>2000</v0:Duguje> <v0:Potrazuje>2000</v0:Potrazuje> <v0:Valuta>HRK</v0:Valuta> </v0:kontiranje> </v0:kontiranja> </v0:dokument> </v0:dokumenti> </v0:spremiStavkeKontiranjaDokumenataRequest> </soapenv:Body> </soapenv:Envelope>

Primjer responsea:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:spremiStavkeKontiranjaDokumenataResponse 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"> <ns2:VsID>SC</ns2:VsID> <ns2:Godina>2020</ns2:Godina> <ns2:dokumenti> <ns2:dokument> <ns2:DokGUID>F8D2D558-A70E-4472-A849-25EAEADF50F5</ns2:DokGUID> <ns2:kontiranja> <ns2:kontiranje> <ns2:Rb>1</ns2:Rb> <ns2:Datum>2020-05-31</ns2:Datum> <ns2:KonKonto>611110</ns2:KonKonto> <ns2:Duguje>2000.00</ns2:Duguje> <ns2:Potrazuje>2000.00</ns2:Potrazuje> <ns2:Valuta>HRK</ns2:Valuta> </ns2:kontiranje> </ns2:kontiranja> </ns2:dokument> </ns2:dokumenti> </ns2:spremiStavkeKontiranjaDokumenataResponse> </soap:Body> </soap:Envelope>