MeR TPP sustav digitalnog bankarstva

v1/getBankStatements - POST

Opis: Dohvat bankovnog izvatka (camt.53) - POST

URL (test): ../v1/getBankStatements

URL (produkcija): ../v1/getBankStatements

Specifikacija requesta - JSON:

Parametri: NEMA

	Opis	Tip podatka	Obavezno
.
header			1..1
Content-Type	Moguće su sljedeće vrijednosti: application/xml text/plain	string	1..1
X-Request-ID	Jedinstveni identifikator REST zahtjeva (requesta), jedinstven za svaki REST poziv.	UUID	1..1
body			1..1
username	Jedinstveni identifikator korisnika	string	1..1
password	Password	string	1..1
companyId	OIB pravne osobe	string	1..1
companyBu	Oznaka podružnice ili druge izdvojene poslovne jedinice.	string	0..1
softwareId	Jedinstvena oznaka poslovnog sustava (ERP)	string	1..1
merDateFrom	Datum od u ISO formatu YYYY-MM-DD Dohvat izvoda prema datumu izvoda.	ISODate	1..1
merDateTo	Datum do u ISO formatu YYYY-MM-DD. Dohvat izvoda prema datumu izvoda.	ISODate	1..1
merFormat	U slučaju kad je na PSD2 API kanalu dostupno više različith fromata izvdoa potrebno je navesti koji izvod se traži. Mogući su: camt.052 camt.053 camt.054 mt940 mt942	UUID	0..1
consentStatus	Ima li račun aktivnu privolu. 1 – Filtrira samo izvode za račune koji imaju aktivnu privolu (defaultno ponašanje) 0 – Filtrira samo izvode za račune koji nemaju aktivnu privolu 2 – Filtrira sve izvode Parametar je opcionalan, a ukoliko se parametar ne dostavi, sustav defaultno filtrira samo izvode za račune koji imaju aktivnu privolu. Ovo ima za posljedicu da sustav neće po defaultu vraćati podatke o računima, u ovom slučaju podatke o izvodima, za koje nema aktivnu privolu.	integer	0..1
debtorAccount	Pretraživanje po računu platitelja.	Account Reference	0..1

Specifikacija response - JSON:

	Opis	Tip podatka	Obavezno
.
header			1..1
Content-Type	application/xml	string	1..1
X-Request-ID	Jedinstveni identifikator requesta, jedinstven za svaki REST poziv.	UUID	1..1
body			1..n
format	Format datoteke za download (camt.053)	string	1..1
messageIdentification	Identifikacija poruke.	string	1..1
creationDatetime	Datum kreiranja poruke.	datetime	1..1
fromDate	Datum i vrijeme OD kojeg su obuhvaćene transakcije u poruci.	string	1..1
toDate	Datum i vrijeme DO kojeg su obuhvaćene transakcije u poruci.	string	1..1
downloadLink	Link za download poruke dnevnog izvatka.	string	1..1
vbdi	Vodeći broj depozitne institucije.	string	1..1
bic	BIC banke.	string	1..1
bankName	Naziv banke.	string	1..1
identification	Identifikacijski broj.	string	1..1
lglSequenceNumber	???	string	1..1
filename	Naziv datoteke.	string	1..1
accounts	Podaci o računu		1..1
iban	IBAN.	string	1..1
currency	Valuta IBAN-a.	string	1..1
cashAccountType	Tip transakcijskog računa.	string	1..1
merChangeTime	Datum i vrijeme razmjene podataka.	datetime	1..1

Primjer JSON - POST request:

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

		{

			"username": "username",
			"password": "password",
			"companyId": "OIB tvrtke",
			"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"
			}
		]