spremiStavkePlana

Metoda spremiStavkePlana

Ako stavka plana ne postoji u sustavu otvorena tada se ovom metodom dodaje.
Metoda će pokušati dodati stavke plana ukoliko ne postoje unutar sustava, a u suprotnom će metoda vratiti informaciju u izlaznom XML-u.

Specifikacija ulaznog XML-a:

Struktura	Opis	Tip podatka	Broj pojavljivanja elementa
spremiStavkePlanaRequest
VsID	Identifikator vanjskog sustava (dogovara se)	string(36)	1..1
stavkePlana	1..1
stavkaPlana	1..n
RBPlanaProracuna	Redni broj plana na kojeg se vežu stavke	smallint	1..1
Iznos	Iznos planirane stavke	decimal(18, 2)	1..1
IznosRealizacije	Iznos realizacije planirane stavke	decimal(18, 2)	0..1
Godina	Označava godinu u kojoj se plan nalazi	smallint	1..1
OrgKlasSifra	Šifra razdjela	string(30)	0..1
OdjSifra	Šifra odjela	string(12)	0..1
KorProrSifra	Šifra korisnika	string(10)	0..1
ProKlasSifra	Šifra programa	string(15)	0..1
IzvSifra	Šifra izvora financiranja	string(10)	0..1
LokSifra	Šifra lokacije	string(10)	0..1
FunKlasSifra	Šifra funkcijske klasifikacije	string(9)	0..1
KonKonto	Konto iz kataloga (dohvatiKontniPlan)	string(12)	1..1
PozSifra	Šifre Pozicije	string(8)	0..1
MtSifra	Šifra mjesta troška	string(15)	0..1
VrstaStavkePlana	Oznaka pozicije prihod (P) ili rashod (R)	string(1)	0..1
Valuta	Troznačna valuta prema ISO 4217 standardu. Označava osnovnu valutu u kojoj su poslani iznosi dokumenta.*	string(3)	0..1
/ stavkaPlana
/ stavkePlana
/ spremiStavkePlanaRequest

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

spremiStavkePlanaRequest

VsID

Identifikator vanjskog sustava (dogovara se)

string(36)

1..1

stavkePlana

1..1

stavkaPlana

1..n

RBPlanaProracuna

Redni broj plana na kojeg se vežu stavke

smallint

1..1

Iznos

Iznos planirane stavke

decimal(18, 2)

1..1

IznosRealizacije

Iznos realizacije planirane stavke

decimal(18, 2)

0..1

Godina

Označava godinu u kojoj se plan nalazi

smallint

1..1

OrgKlasSifra

Šifra razdjela

string(30)

0..1

OdjSifra

Šifra odjela

string(12)

0..1

KorProrSifra

Šifra korisnika

string(10)

0..1

ProKlasSifra

Šifra programa

string(15)

0..1

IzvSifra

Šifra izvora financiranja

string(10)

0..1

LokSifra

Šifra lokacije

string(10)

0..1

FunKlasSifra

Šifra funkcijske klasifikacije

string(9)

0..1

KonKonto

Konto iz kataloga (dohvatiKontniPlan)

string(12)

1..1

PozSifra

Šifre Pozicije

string(8)

0..1

MtSifra

Šifra mjesta troška

string(15)

0..1

VrstaStavkePlana

Oznaka pozicije prihod (P) ili rashod (R)

string(1)

0..1

Valuta

Troznačna valuta prema ISO 4217 standardu. Označava osnovnu valutu u kojoj su poslani iznosi dokumenta.*

string(3)

0..1

/ stavkaPlana

/ stavkePlana

/ spremiStavkePlanaRequest

* - Od datuma uvođenja EUR-a će se provjeravati kao obavezan element

Specifikacija izlaznog XML-a:

Struktura	Opis	Tip podatka	Uvjet	Broj pojavljivanja elementa
spremiStavkePlanaResponse
VsID	Identifikator vanjskog sustava (dogovara se)	string(36)		1..1
stavkePlana	{Or	0..1
stavkaPlana	1..n
RBrojPlana	Redni broj plana na kojeg se vežu stavke	smallint		1..1
OznakaPozicije	Oznaka šifre Pozicije	string(8)		0..1
status	1..1
Greska	0 – nema greške; 1 – greška (nije spremljeno); 2 – spremljeno (ali ne svi podaci); 3 – već postoji u sustavu 8 – neispravna valuta	tinyint		1..1
OpisGreske	Opis greške prilikom spremanja podatka – obavezan za Greska <> 0	string(300)	Greska = 0	0..1
/ status
/ stavkaPlana
/ stavkePlana
greska	Or}	0..1
Greska	1 - greška	tinyint		1..1
OpisGreške	Opis greške prilikom dohvata podataka	string(300)		1..1
/ greska
/ spremiStavkePlanaResponse

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

spremiStavkePlanaResponse

VsID

Identifikator vanjskog sustava (dogovara se)

string(36)

1..1

stavkePlana

{Or

0..1

stavkaPlana

1..n

RBrojPlana

Redni broj plana na kojeg se vežu stavke

smallint

1..1

OznakaPozicije

Oznaka šifre Pozicije

string(8)

0..1

status

1..1

Greska

0 – nema greške;
1 – greška (nije spremljeno);
2 – spremljeno (ali ne svi podaci);
3 – već postoji u sustavu
8 – neispravna valuta

tinyint

1..1

OpisGreske

Opis greške prilikom spremanja podatka
– obavezan za Greska <> 0

string(300)

Greska = 0

0..1

/ status

/ stavkaPlana

/ stavkePlana

greska

Or}

0..1

Greska

1 - greška

tinyint

1..1

OpisGreške

Opis greške prilikom dohvata podataka

string(300)

1..1

/ greska

/ spremiStavkePlanaResponse

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:spremiStavkePlanaRequest>
					<v0:VsID>SC</v0:VsID>
					<v0:stavkePlana>
						<!--1 or more repetitions:-->
						<v0:stavkaPlana>
							<v0:RBPlanaProracuna>2</v0:RBPlanaProracuna>
							<v0:Iznos>10000.00</v0:Iznos>
							<v0:Godina>2020</v0:Godina>
							<!--Optional:-->
							<v0:IznosRealizacije>31000.00</v0:IznosRealizacije>
							<!--Optional:-->
							<v0:OrgKlasSifra>002</v0:OrgKlasSifra>
							<!--Optional:-->
							<v0:OdjSifra>001</v0:OdjSifra>
							<!--Optional:-->
							<v0:KorProrSifra>K1001</v0:KorProrSifra>
							<!--Optional:-->
							<v0:ProKlasSifra>A011000T100001</v0:ProKlasSifra>
							<!--Optional:-->
							<v0:IzvSifra>1.</v0:IzvSifra>
							<!--Optional:-->
							<v0:LokSifra>111380</v0:LokSifra>
							<!--Optional:-->
							<v0:FunKlasSifra>0210</v0:FunKlasSifra>
							<v0:KonKonto>6111</v0:KonKonto>
							<!--Optional:-->
							<v0:PozSifra>P0001</v0:PozSifra>
							<!--Optional:-->
							<v0:MtSifra>M031</v0:MtSifra>
							<!--Optional:-->
							<v0:VrstaStavkePlana>P</v0:VrstaStavkePlana>
							<!--Optional:-->
							<v0:Valuta>HRK</v0:Valuta>
						</v0:stavkaPlana>
					</v0:stavkePlana>
				</v0:spremiStavkePlanaRequest>
				</soapenv:Body>
			</soapenv:Envelope>
		

Primjer responsea:

			<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
				<soap:Body>
				<ns2:spremiStavkePlanaResponse 
						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:stavkePlana>
						<ns2:stavkaPlana>
							<ns2:RBrojPlana>2</ns2:RBrojPlana>
							<ns2:OznakaPozicije>P0001</ns2:OznakaPozicije>
							<ns2:status>
							<ns2:Greska>0</ns2:Greska>
							<ns2:OpisGreske/>
							</ns2:status>
						</ns2:stavkaPlana>
					</ns2:stavkePlana>
				</ns2:spremiStavkePlanaResponse>
				</soap:Body>
			</soap:Envelope>
		