Basic use cases

Getting statements in SWIFT formats

API allows you to get statements in two formats: MT940 and MT942. MT940 is used for final statements and MT942 for intraday statements. In addition, for intraday statements, you can get the delta (changes) between the already received and the new statement, if any.

Receiving a final statement in MT940 format

To receive an MT940 statement, you should send a GET request to /v1/accounts/{account}/statements/mt940, where {account} is the account number for which the statement is requested.

Important! Information about the readiness of the final statement can be received using the methods described in the section about statements in JSON format.

Request example:

curl -X 'GET'
'https://api.openapi.raiffeisen.ru/api/v1/accounts/4070281000000XXXXXXX/statements/mt940'
-H 'accept: text/plain'
-H 'Id-Token: {YOUR_TOKEN}'
-H 'Authorization: Bearer {YOUR_TOKEN_RECEIVED_WHEN_AUTHORIZED}'

At the same time, the method supports query parameters:

date - date of the requested statement.
field86 - allows you to choose the format in which the 86th field of the statement will be described. Supported values are MT940_OLD and MT940_SEPA. By default - MT940_SEPA
transliteration - sets the need for Cyrillic transliteration in the 86th field

Example of a request to receive a statement for 16.10.2021 with the transliteration of the 86th in the MT940_SEPA (NZP) format

Request:

curl -X 'GET'
'https://api.openapi.raiffeisen.ru/api/v1/accounts/4070281000000XXXXXXX/statements/mt940?date=16.10.2021&field86=MT940_OLD&transliteration=true'
-H 'accept: text/plain'
-H 'Id-Token: {YOUR_TOKEN}'
-H 'Authorization: Bearer {YOUR_TOKEN_RECEIVED_WHEN_AUTHORIZED}'

Response:

:20:GL211016000001 :25:RZBMRUMM/4070281000000XXXXXXX/RUB :28C:00208 :60F:C201116RUB0,00 :61:2110161116D500,00NTRF393//211016PEOI022307 'P'/'O' 393,40101810500000010004 :86:020?00Payment Order?10?20OPLATA STRAHOVYH VZNOSOV NA?21 OBaZATELX NOE MEDICINSKOGO ?22STRAHOVANIa ZA 3 KV.2020 ND?23S NE OBLAGAETSa ?24?25?26?27?28?29?30042007001?3140101810500000010004?32UFK PO VO RONEJSKOi OBLASTI ?33(IFNS ROSSII PO LEVOBEREJNO?34?350?603663052 143?61393?62?63Код дохода ? :61:2110161116D600,00NTRF390//211016PEOI021826 'P'/'O' 390,40101810500000010004 :86:020?00Payment Order?10?20OPLATA STRAHOVYH VZNOSOV NA?21 OBaZATELX NOE MEDICINSKOGO ?22STRAHOVANIa ZA 3 KV.2020 ND?23S NE OBLAGAETSa ?24?25?26?27?28?29?30042007001?3140101810500000010004?32UFK PO VO RONEJSKOi OBLASTI ?33(IFNS ROSSII PO LEVOBEREJNO?34?350?603663052 143?61390?62?63Код дохода ? :62F:D211016RUB106517,64 :64:C211016RUB101253,57

Example of a request to receive a statement for 18.10.2021 with the transliteration of the 86th in the MT940_OLD (NZP) format

Request:

Response:

:20:GL211018000001 :25:RZBMRUMM/4070281000000XXXXXXX/RUB :28C:00210 :60F:C211018RUB81515,04 :61:2110181118D80000,00NTRF396//211018PEOI001212 P/O 396,4070281000000XXXXXXX :86:/ORD/INN 3663052143 УФК по Воронежской области (ИФНС России по Ле вобережному району г.Воронежа)/NPP/396/UIP/0/NZP/оплата УСН за 4 квартал 2020 г. НДС не облагается :62F:C211018RUB1515,04 :64:C211018RUB11515,04

Receiving an intraday statement in MT942 format

To receive MT942 intraday statement, you should send a GET request to /v1/accounts/{account}/statements/mt942, where {account}is the account number for which the statement is requested.

Request example:

curl -X 'GET'
'https://api.openapi.raiffeisen.ru/api/v1/accounts/4070281000000XXXXXXX/statements/mt942'
-H 'accept: text/plain'
-H 'Id-Token: {YOUR_TOKEN}'
-H 'Authorization: Bearer {YOUR_TOKEN_RECEIVED_WHEN_AUTHORIZED}'

At the same time, the method supports query parameters:

field86 - allows you to choose the format in which the 86th field of the statement will be described. Supported values are MT940_OLD and MT940_SEPA. By default - MT940_SEPA
transliteration - sets the need for Cyrillic transliteration in the 86th field

Example of a request for an intraday statement

Response:

:20:SW210122000001 :25:RZBMRUMM/4070281000000XXXXXXX :28C:01006 :34F:RUB0, :13D:2101101229+0300 :61:2101220922D1000,00NTRF704//190321PCIN044330 P/O 223,4070281000000XXXXXXX :86:020?00Payment Order?10?20НДС 12%?21?22?23?24?25?26?27?28?29?30044 525700?3140702810700001470239?32ООО Арт Базар Пром?33?34?35?60770 6804648?61704?62?63Код дохода ? :61:2101220922D1000,00NTRF705//190321PCIN044330 P/O 223,4070281000000XXXXXXX :86:020?00Payment Order?10?20НДС 12%?21?22?23?24?25?26?27?28?29?30044 525700?3140702810700001470239?32ООО Арт Базар Пром?33?34?35?60770 6804648?61705?62?63Код дохода ? :61:2101220922C1000,00NTRF706//190321PCIN044330 P/O 223,4070281000000XXXXXXX :86:020?00Payment Order?10?20НДС 12%?21?22?23?24?25?26?27?28?29?30044 525700?3140702810700001470239?32ООО Арт Базар Пром?33?34?35?60770 6804648?61706?62?63Код дохода ? :90D:2RUB2000,00 :90C:1RUB1000,00

Getting the delta between any intraday statement and the last new one

This scenario allows you to receive all new transactions that have not yet been included in one of the intraday statements.

Imagine that transactions A, B and C are performed during the day.

After transaction A, after some time we will request an intraday statement. It will show information about transaction A. Statement number 00001.

After that we will perform transactions B and C.

Now, if we request a delta, indicating that we want to get a delta regarding statement number 00001, we will receive a statement in which only transactions B and C will be shown. Statement number 00002.

If we do not specify the number of the statement regarding which we want to get a delta, the effect will be the same like in the previous method (all transactions for the current day will be shown)

Example of a delta request regarding statement number 00001

curl -X 'GET'
'https://api.openapi.raiffeisen.ru/api/v1/accounts/ds/statements/mt942/delta?lastSentNumber=00001&field86=MT940_SEPA&transliteration=false'
-H 'accept: text/plain'
-H 'Id-Token: {YOUR_TOKEN}'
-H 'Authorization: Bearer {YOUR_TOKEN_RECEIVED_WHEN_AUTHORIZED}'

Response:

:20:SW210122000001 :25:RZBMRUMM/4070281000000XXXXXXX :28C:00002 :34F:RUB0, :13D:2101101229+0300 :61:2101220922D1000,00NTRF705//190321PCIN044330 P/O 223,4070281000000XXXXXXX :86:020?00Payment Order?10?20НДС 12%?21?22?23?24?25?26?27?28?29?30044 525700?3140702810700001470239?32ООО Арт Базар Пром?33?34?35?60770 6804648?61705?62?63Код дохода ? :61:2101220922C1000,00NTRF706//190321PCIN044330 P/O 223,4070281000000XXXXXXX :86:020?00Payment Order?10?20НДС 12%?21?22?23?24?25?26?27?28?29?30044 525700?3140702810700001470239?32ООО Арт Базар Пром?33?34?35?60770 6804648?61706?62?63Код дохода ? :90D:1RUB1000,00 :90C:1RUB1000,00

As we can see, field 28С has the number of an intraday statement - 00002.

Receiving statements in 1C format “Bank Client”

API allows you to get final or intraday statements in 1C format by account number, ready at the time of the request. Type of statement received depends on the readiness of the final statement. If the final statement was already prepared for the requested date, it will return. Otherwise, an intraday statement will return.

The selection can be limited to a date. The results are provided in pages and contain the main data of the statement.

Example of usage for confirming the readiness of the final or intraday statement

To receive an 1C statement, you should send a GET request to /v1/accounts/{account}/statements/1c, where {account}is the account number for which the statement is requested.

At the same time, the method supports query parameter:

date - date of the requested statement. Current by default.

To receive a statement, you need to make a call.

A call example:

curl -X GET \
https://api.openapi.raiffeisen.ru/api/v1/accounts/4070281030000ХХХХХХХ/statements/1c?date=yyyy-MM-dd" \
-H "accept: text/plain" \
-H "Id-Token: `{YOUR_TOKEN}`" \
-H "Authorization: Bearer `{YOUR_TOKEN_RECEIVED_WHEN_AUTHORIZED}`

An example of a response when the statement is ready:

1CClientBankExchange
ВерсияФормата=1.03
Кодировка=windows-1251
Отправитель=
Получатель=
ДатаСоздания=20.10.2021
ВремяСоздания=17:06:07
ДатаНачала=14.12.2020
ДатаКонца=14.12.2020
РасчСчет=4070281030000ХХХХХХХ
СекцияРасчСчет
ДатаНачала=14.12.2020
ДатаКонца=14.12.2020
РасчСчет=4070281030000ХХХХХХХ
НачальныйОстаток=120597.16
ВсегоПоступило=196339.26
ВсегоСписано=0
КонечныйОстаток=214592.17
КонецРасчСчет
СекцияДокумент=Платежное поручение
Номер=1709
Дата=14.12.2020
Сумма=32223.5
ПлательщикСчет=40802810064580ХХХХХХХ
Плательщик=Тестовый Тест Тестович (ИП)
ПлательщикИНН=615400001013
ПлательщикКПП=
ПлательщикРасчСчет=40802810064580ХХХХХХХ
ПлательщикБанк1=ЮГО-ЗАПАДНЫЙ БАНК АО ТЕСТОВЫЙ БАНК Г РОСТОВ-НА-ДОНУ
ПлательщикБИК=046015100
ПлательщикКорсчет=3010181060000ХХХХХХХ
ПолучательСчет=40702810300000ХХХХХХХ
ДатаПоступило=14.12.2020
Получатель=ООО Тестовая Организация 1
ПолучательИНН=3663000014
ПолучательКПП=366301001
ПолучательРасчСчет=40702810300000ХХХХХХХ
ПолучательБанк1=АО "РАЙФФАЙЗЕНБАНК" Г МОСКВА
ПолучательБИК=044525700
ПолучательКорсчет=30101810200000ХХХХХХХ
ВидОплаты=01
ВидПлатежа=
КодНазПлатежа=
Код=
ОКАТО=
Очередность=5
СтатусСоставителя=
ПоказательДаты=
ПоказательКБК=
ПоказательНомера=
ПоказательОснования=
ПоказательПериода=
ПоказательТипа=
НазначениеПлатежа=Оплата по накладной №8239 от 04.12.2020 г.  сумма 32223-50 без налога (НДС)
КонецДокумента
КонецФайла