MeR TPP sustav digitalnog bankarstva

Metoda: v1/getBankStatements - POST

URL (test): https://testapi.e-plati.hr/api/v1/getBankStatements
URL (produkcija): LCZAJ_VanjskiSustavi.RESTUrl + /v1/getBankStatements

1. Kontrola prava pristupa

Za kontrolu prava korištenja metode potrebno je ispitati postojanje dodatka licenci:

Aplikacija	Dodatak licenci	Opis
192	MeRAIS-bS	MeR AIS Digitalno bankarstvo – dohvat SEPA izvatka

2. Opis rada metode

Metoda vrši dohvat dnevnih izvadaka registriranih IBAN-a preko MeR TTP servisa eBankarstva.

Koraci obrade:

1. Vrši se dohvat parametara iz LCSPI tablice LCZAJ_VanjskiSustavi za VsID = MeRAIS.
URL servisa - adresa servisa.
KorisnickoIme - za autentifikaciju na servis.
Zaporka - za autentifikaciju na servis.

2. Vrši se pozivanje metode web servisa v1/getBankStatements.
Priprema se vrši na način opisan u tablici u nastavku

3. Pozivanje metode web servisa (request) se logira u tablicu LCZAJ_VanjskiSustaviLog.

4. Logira se odgovor metode web servisa (response) u tablicu LCZAJ_VanjskiSustaviLog.

5. Vrši se dohvaćanje datoteka izvadaka preko linkova za download koje vraća pozvana metoda u svom odgovoru.

6. Dohvaćene SEPA datoteke izvatka (camt.053) se šalju u postojeću proceduru za prihvat i prepoznavanje izvadaka.

3. Punjenje ulaznog JSON-a metode:

	Opis	O
.
header		1..1
Content-Type	application/json	DA
X-Request-ID	NEWID() - spremanje u NOVU KOLONU LCZAJ_VanjskiSustaviLog.RowGUID	DA
body		1..1
username	LCZAJ_VanjskiSustavi.KorisnickoIme	DA
password	LCZAJ_VanjskiSustavi.Zaporka	DA
companyId	LCZAJ_OsobniIdentifikacijskiBrojevi.OIB preko LCZAJ_Korisnici.OsobniIdentifikacijskiBrojeviID	DA
companyBu	''	NE
softwareId	LCZAJ_VanjskiSustavi.SoftwareID - NOVA KOLONA	DA
merDateFrom	Trenutni datum minus 1 dan.	DA
merDateTo	Trenutni datum minus 1 dan.	DA
merFormat	camt.053	DA
consentStatus	2	DA
debtorAccount	LCZAJ_ZiroRacuni.ZIRO gdje je eBankarstvo = 1	NE

Prilozi

Opis servisa - MeR-TPP-API za partnere.pdf.

Nekoliko poslovnih i tehničkih pravila:

minimalno jedan vanjski sustav mora biti označen za rad sa digitalnim bankarstvom

Primjer JSON - POST request:

	
		Content-Type: application/json
		X-Request-ID: d192c1b2-53d6-49e2-a3eb-d1498de1807f

		{
			"username": "tsudic",
			"password": "w7F9p%AV",
			"companyId": "14506572540",
			"companyBu": "",
			"softwareId": "Test-001",
			"merDateFrom": "2023-03-03",    
			"merDateTo": "2023-03-03",
			"merFormat": "camt.053",
			"consentStatus": 2
		}

Primjer JSON - response:

	
		Content-Type: application/json
		X-Request-ID: d192c1b2-53d6-49e2-a3eb-d1498de1807f

		[
			{
				"format": "camt.053",
				"messageIdentification": "BCS2340009.99999999927.202210120001",
				"creationDatetime": "2023-03-04T04:00:00",
				"fromDate": "2023-03-03T00:00:00",
				"toDate": "2023-03-03T23:59:59.999",
				"downloadLink": "https://testapi.e-plati.hr/api/v1/teststatements/camt?statementdate=2023-03-03",
				"vbdi": "2340009",
				"bic": "PBZG HR 2X",
				"bankName": "Privredna banka Zagreb",
				"identification": "51b26bbc00d6448b914514ffae4184d2",
				"lglSequenceNumber": 14,
				"filename": "",
				"accounts": [
					{
						"iban": "",
						"currency": "NOK",
						"cashAccountType": "TRAN"
					}
				],
				"merChangeTime": "2023-05-24T15:06:19.2538416+02:00"
			},
			{
				"format": "camt.053",
				"messageIdentification": "BCS2340009.99999999927.202210120001",
				"creationDatetime": "2023-03-04T04:00:00",
				"fromDate": "2023-03-03T00:00:00",
				"toDate": "2023-03-03T23:59:59.999",
				"downloadLink": "https://testapi.e-plati.hr/api/v1/teststatements/camt?statementdate=2023-03-03",
				"vbdi": "2340009",
				"bic": "PBZG HR 2X",
				"bankName": "Privredna banka Zagreb",
				"identification": "73d3175c50a847b089b3be471e9114c0",
				"lglSequenceNumber": 13,
				"filename": "",
				"accounts": [
					{
						"iban": "",
						"currency": "CHF",
						"cashAccountType": "TRAN"
					}
				],
				"merChangeTime": "2023-05-24T15:06:19.253923+02:00"
			},
			{
				"format": "camt.053",
				"messageIdentification": "BCS2340009.99999999927.202210120001",
				"creationDatetime": "2023-03-04T04:00:00",
				"fromDate": "2023-03-03T00:00:00",
				"toDate": "2023-03-03T23:59:59.999",
				"downloadLink": "https://testapi.e-plati.hr/api/v1/teststatements/camt?statementdate=2023-03-03",
				"vbdi": "2340009",
				"bic": "PBZG HR 2X",
				"bankName": "Privredna banka Zagreb",
				"identification": "8e062747770b4801937046e5506d5238",
				"lglSequenceNumber": 13,
				"filename": "",
				"accounts": [
					{
						"iban": "",
						"currency": "USD",
						"cashAccountType": "TRAN"
					}
				],
				"merChangeTime": "2023-05-24T15:06:19.2539269+02:00"
			},
			{
				"format": "camt.053",
				"messageIdentification": "BCS2340009.99999999927.202210120001",
				"creationDatetime": "2023-03-04T04:00:00",
				"fromDate": "2023-03-03T00:00:00",
				"toDate": "2023-03-03T23:59:59.999",
				"downloadLink": "https://testapi.e-plati.hr/api/v1/teststatements/camt?statementdate=2023-03-03",
				"vbdi": "2340009",
				"bic": "PBZG HR 2X",
				"bankName": "Privredna banka Zagreb",
				"filename": "",
				"accounts": [
					{
						"iban": "",
						"currency": "EUR",
						"cashAccountType": "TRAN"
					}
				],
				"merChangeTime": "2023-05-24T15:06:19.2539281+02:00"
			}
		]