Metoda prihvatiFinancijskePodatke

Opis

Prihvat i priprem podataka financijskih kartica koji će biti vidljivi na portalu nakon registracije korisnika ovisno o dodijeljenim ovlaštenjima za pregled istih

Specifikacija ulaznog XML-a:

Struktura	Opis	Tip podatka	Broj pojavljivanja elementa
prihvatiFinancijskePodatkeRequest
VsID	Identifikator vanjskog sustava	string(36)	1..1
korisnici		1..1
korisnik	1..n
OIB	Osobni identifikacijski broj registriranog korisnika financijskih kartica	string(11)	1..1
Sifra	Šifra registriranog korisnika financijskih kartica	string(10)	1..1
Naziv	Naziv registriranog korisnika financijskih kartica	string(80)	1..1
Adresa	Adresa registriranog korisnika financijskih kartica. Ulica i kućni broj	string(80)	1..1
PostaBroj	Broj pošte registriranog korisnika financijskih kartica	string(10)	1..1
Sjediste	Naziv sjedišta (pošte) registriranog korisnika financijskih kartica	string(40)	1..1
dokumenti	1..1
dokument	1..n
GUID	Globalni jedinstveni identifikator zapisa	string(36)	1..1
SifraUstanove	Šifra ustanove (proračuna/korisnika proračuna)	string(2)	1..1
NazivUstanove	Naziv ustanove (proračuna/korisnika proračuna)	string(80)	1..1
Vrsta	Oznaka vrste dokumenta R – račun I – ispravak (storno) O – odobrenje umanjenja potraživanja T – dodatno terećenje (troškovi) K – kamata U - uplata	string(1)	1..1
Godina	Godina u kojoj je dokument nastao	smallint	1..1
BrojRacuna	Broj računa	string(40)	1..1
OznakaKnjige	Oznaka pomoćne knjige	string(10)	1..1
EvidencijskiBroj	Evidencijski broj dokumenta (u pomoćnoj knjizi)	string(30)	1..1
Datum	Datum dokumenta	date	1..1
DatumDospijeca	Datum dospijeća plaćanja	date	1..1
VjerovnikNaziv	Naziv vjerovnika	string(100)	1..1
VjerovnikAdresa	Adresa vjerovnika	string(80)	1..1
VjerovnikSjediste	Sjedište vjerovnika	string(50)	1..1
VjerovnikIBAN	IBAN vjerovnika na koji se vrši plaćanje	string(40)	1..1
Opis	Opis sa dokumenta	string(160)	1..1
ModelPNBO	Model poziva na broj primatelja	string(4)	1..1
PNBO	Poziv na broj primatelja	string(22)	1..1
ModelPNBZ	Model poziva na broj platitelja	string(4)	0..1
PNBZ	Model poziva na broj platitelja	string(22)	0..1
Zaduzeno	Iznos kojim se korisnika tereti	decimal(18,2)	1..1
Uplaceno	Uplaćeni iznos od strane korisnika	decimal(18,2)	1..1
Saldo	Saldo zaduženja	decimal(18,2)	1..1
Valuta	Troznačna šifra valute	string(3)	0..1
SifraNamjene	Šifra namjene	string(4)	0..1
/dokument
/dokumenti
/korisnik
/korisnici
/prihvatiFinancijskePodatkeRequest

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

prihvatiFinancijskePodatkeRequest

VsID

Identifikator vanjskog sustava

string(36)

1..1

korisnici

1..1

korisnik

1..n

OIB

Osobni identifikacijski broj registriranog korisnika financijskih kartica

string(11)

1..1

Sifra

Šifra registriranog korisnika financijskih kartica

string(10)

1..1

Naziv

Naziv registriranog korisnika financijskih kartica

string(80)

1..1

Adresa

Adresa registriranog korisnika financijskih kartica. Ulica i kućni broj

string(80)

1..1

PostaBroj

Broj pošte registriranog korisnika financijskih kartica

string(10)

1..1

Sjediste

Naziv sjedišta (pošte) registriranog korisnika financijskih kartica

string(40)

1..1

dokumenti

1..1

dokument

1..n

GUID

Globalni jedinstveni identifikator zapisa

string(36)

1..1

SifraUstanove

Šifra ustanove (proračuna/korisnika proračuna)

string(2)

1..1

NazivUstanove

Naziv ustanove (proračuna/korisnika proračuna)

string(80)

1..1

Vrsta

Oznaka vrste dokumenta
R – račun
I – ispravak (storno)
O – odobrenje umanjenja potraživanja
T – dodatno terećenje (troškovi)
K – kamata
U - uplata

string(1)

1..1

Godina

Godina u kojoj je dokument nastao

smallint

1..1

BrojRacuna

Broj računa

string(40)

1..1

OznakaKnjige

Oznaka pomoćne knjige

string(10)

1..1

EvidencijskiBroj

Evidencijski broj dokumenta (u pomoćnoj knjizi)

string(30)

1..1

Datum

Datum dokumenta

date

1..1

DatumDospijeca

Datum dospijeća plaćanja

date

1..1

VjerovnikNaziv

Naziv vjerovnika

string(100)

1..1

VjerovnikAdresa

Adresa vjerovnika

string(80)

1..1

VjerovnikSjediste

Sjedište vjerovnika

string(50)

1..1

VjerovnikIBAN

IBAN vjerovnika na koji se vrši plaćanje

string(40)

1..1

Opis

Opis sa dokumenta

string(160)

1..1

ModelPNBO

Model poziva na broj primatelja

string(4)

1..1

PNBO

Poziv na broj primatelja

string(22)

1..1

ModelPNBZ

Model poziva na broj platitelja

string(4)

0..1

PNBZ

Model poziva na broj platitelja

string(22)

0..1

Zaduzeno

Iznos kojim se korisnika tereti

decimal(18,2)

1..1

Uplaceno

Uplaćeni iznos od strane korisnika

decimal(18,2)

1..1

Saldo

Saldo zaduženja

decimal(18,2)

1..1

Valuta

Troznačna šifra valute

string(3)

0..1

SifraNamjene

Šifra namjene

string(4)

0..1

/dokument

/dokumenti

/korisnik

/korisnici

/prihvatiFinancijskePodatkeRequest

Specifikacija izlaznog XML-a:

Struktura	Opis	Tip podatka	Uvjet	Broj pojavljivanja elementa
prihvatiFinancijskePodatkeResponse
VsID	Identifikator vanjskog sustava	string(36)		1..1
dokumenti	{Or	0..1
dokument	1..n
GUID	Globalni jedinstveni identifikator zapisa	string(36)		1..1
greska	1..1
Greska	0 – nema greške; 1 – greška (nije spremljeno); 2 – korisnik nije registriran za prikazivanje financijskih kartica 3 – već postoji u LC SPI sustavu	tinyint		1..1
OpisGreske	Opis greške u slučaju da zapis nije uspješno spremljen u sustavu. – obavezan za Greska <> 0	string(300)	Greska <> 0	1..1
/greska
/dokument
/dokumenti
greska	Or}	0..1
Greska	1 – greška	tinyint		1..1
OpisGreske	Opis greške prilikom dohvata podatka – obavezan za Greska <> 0	string(300)	Greska <> 0	1..1
/greska
/prihvatiFinancijskePodatkeResponse

Struktura

Opis

Tip podatka

Uvjet

Broj pojavljivanja elementa

prihvatiFinancijskePodatkeResponse

VsID

Identifikator vanjskog sustava

string(36)

1..1

dokumenti

{Or

0..1

dokument

1..n

GUID

Globalni jedinstveni identifikator zapisa

string(36)

1..1

greska

1..1

Greska

0 – nema greške;
1 – greška (nije spremljeno);
2 – korisnik nije registriran za prikazivanje financijskih kartica
3 – već postoji u LC SPI sustavu

tinyint

1..1

OpisGreske

Opis greške u slučaju da zapis nije uspješno spremljen u sustavu.
– obavezan za Greska <> 0

string(300)

Greska <> 0

1..1

/greska

/dokument

/dokumenti

greska

Or}

0..1

Greska

1 – greška

tinyint

1..1

OpisGreske

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

string(300)

Greska <> 0

1..1

/greska

/prihvatiFinancijskePodatkeResponse

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:prihvatiFinancijskePodatkeRequest>
						<v0:VsID>TST GRAD</v0:VsID>
						<v0:korisnici>
							<!--1 or more repetitions:-->
							<v0:korisnik>
								<v0:OIB>99934761522</v0:OIB>
								<v0:Sifra>0123722</v0:Sifra>
								<v0:Naziv> LABUS DRAŽEN.</v0:Naziv>
								<v0:Adresa>HRVATSKIH BRANITELJA 54</v0:Adresa>
								<v0:PostaBroj>44320</v0:PostaBroj>
								<v0:Sjediste>KUTINA</v0:Sjediste>
								<v0:dokumenti>
									<!--1 or more repetitions:-->
									<v0:dokument>
										<v0:GUID>01ebbe1f-6c3a-402a-a3b6-175eeab9a3b0</v0:GUID>
										<v0:SifraUstanove>01</v0:SifraUstanove>
										<v0:NazivUstanove>GRAD KUTINA</v0:NazivUstanove>
										<v0:Vrsta>R</v0:Vrsta>
										<v0:Godina>2021</v0:Godina>
										<v0:BrojRacuna>1234568</v0:BrojRacuna>
										<v0:OznakaKnjige>1</v0:OznakaKnjige>
										<v0:EvidencijskiBroj>21/0030331</v0:EvidencijskiBroj>
										<v0:Datum>2021-05-25</v0:Datum>
										<v0:DatumDospijeca>2021-05-25</v0:DatumDospijeca>
										<v0:VjerovnikNaziv>GRAD KUTINA</v0:VjerovnikNaziv>
										<v0:VjerovnikAdresa>Trg kralja Tomislava 12</v0:VjerovnikAdresa>
										<v0:VjerovnikSjediste>KUTINA</v0:VjerovnikSjediste>
										<v0:VjerovnikIBAN>HR3323400091822000008</v0:VjerovnikIBAN>
										<v0:Opis>TEST</v0:Opis>
										<v0:ModelPNBO>HR00</v0:ModelPNBO>
										<v0:PNBO>12134</v0:PNBO>
										<!--Optional:-->
										<v0:ModelPNBZ>00</v0:ModelPNBZ>
										<!--Optional:-->
										<v0:PNBZ>335</v0:PNBZ>
										<v0:Zaduzeno>100.00</v0:Zaduzeno>
										<v0:Uplaceno>0.00</v0:Uplaceno>
										<v0:Saldo>100.00</v0:Saldo>
									</v0:dokument>
								</v0:dokumenti>
							</v0:korisnik>
						</v0:korisnici>
					</v0:prihvatiFinancijskePodatkeRequest>
				</soapenv:Body>
			</soapenv:Envelope>
		

Primjer responsea:

			<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
				<soap:Body>
					<ns3:prihvatiFinancijskePodatkeResponse 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>TST GRAD</ns3:VsID>
						<ns3:dokumenti>
							<ns3:dokument>
								<ns3:GUID>01ebbe1f-6c3a-402a-a3b6-175eeab9a3b0</ns3:GUID>
								<ns3:greska>
									<ns3:Greska>0</ns3:Greska>
									<ns3:OpisGreske />
								</ns3:greska>
							</ns3:dokument>
						</ns3:dokumenti>
					</ns3:prihvatiFinancijskePodatkeResponse>
				</soap:Body>
			</soap:Envelope>
		