B2BH2H

Получение выписки в формате MT940

Пром GET https://baas.alfabank.ru/api/accounts/{accountNumber}/transactions/MT940

Песочница GET https://sandbox.alfabank.ru/api/accounts/{accountNumber}/transactions/MT940

Scope

transactions

Параметры запроса

HEADERS
Атрибут
Описание
Authorization
stringrequired

Bearer {access_token}, полученный по Authorization Code Flow / Authorization Code Flow H2H

Accept
stringrequired

text/plain

Content-Type
stringoptional

text/plain

PATH
Атрибут
Описание
accountNumber
stringrequired

Номер расчетного счета

QUERY
Атрибут
Описание
executeDate
stringrequired

Дата исполнения

limit
integeroptional

Количество объектов на одной странице

offset
integeroptional

Количество объектов в списке, которые необходимо пропустить

Пример запроса
curl -X GET https://baas.alfabank.ru/api/accounts/40702810701300000000/transactions/MT940?executeDate=2022-01-20 \
  -H 'Accept: text/plain' \
  -H 'Authorization: Bearer {access-token}' \
  -H 'Content-Type: text/plain'

Параметры ответа

Параметры успешного ответа передаются в соответствии с Правилами SWIFT.

Пример ответа 200 (ОК)

:20:+57610880b621435
:25:40702810701300000761
:28C:1
:60a:C220112RUR99527,00 20
:86:/BENM//03271643540000095400 INN5752006960.KPP575301001 GAVRILOV DOBRYNa TROFIMOVIc /NZP/'(VO21100)' OPLATA PO DOGOVORU
:62a:C220113RUR99407,00

:20:
stringoptional

Референс операции

:25:
stringoptional

Номер счета. Заполняется номером счета, по которому предоставляется выписка

:28С:
stringoptional

Номер выписки

:60а:
stringoptional

Входящий остаток. Составное поле состоит из 4 полей: 1-ый символ - Знак дебета (отрицательный остаток)/кредита(положительный остаток); 2-ой символ - Дата; 3-ий символ - Валюта; 4-ый символ - Сумма

stringoptional

Строка движения по счету. Это поле повторяется столько раз, сколько транзакций в выписке. Алгоритм заполнения смотрите во вложенности

1
stringoptional

Дата валютирования (в формате ISO -ГГMMДД)

2
stringoptional

Дата проводки (поле не заполняется)

3
stringoptional

Знак дебета (списание со счета) / кредита (поступление на счет)

4
stringoptional

Код средств (представляет собой третью букву кода валюты)

5
stringoptional

Сумма

6
stringoptional

Код типа операции. Заполняется всегда = NTRF

7
stringoptional

Референс для владельца счета. Заполняется всегда = NONREF

8
stringoptional

Референс обслуживающей счет финансовой организации (поле не заполняется)

9
stringoptional

В этом поле указывается номер платежа + Код дебитора + Расширенный код дебитора. Заполняется числовым значением с новой строки

:86:
stringoptional

Информация для владельца счета. Это поле повторяется столько раз, сколько транзакций в выписке. В этом поле содержится дополнительная информация по операции. Для кредитовых операций после кодового слова ORDP указывается значение поле Плательщик (поле 50а из SWIFT MT103), а именно: номер счета плательщика, ИНН и КПП (если он есть) плательщика и его наименование. Для дебетовых операций после кодового слова BENM указывается значение поле Бенефициар (поле 59 из SWIFT MT103), а именно: номер счета бенефициара, ИНН и КПП (если он есть) бенефициара и его наименование. Для всех операций после кодового слова NZP указывается информация о платеже из поля 70 платежных инструкций. Поля разделены между собой пробелами. Алгоритм заполнения для кредитовых операций: /ORDP/ + / + Номер счета плательщика + знак пробела + INN + Номер ИНН плательщика + . + KPP + Номер КПП плательщика (необязательное) + знак пробела + Наименование плательщика + знак пробела + /NZP/ + информация о платеже из поля 70 платежных инструкций после транслитерации. /BENM/ + / + Номер счета бенефициара(получателя) + знак пробела + INN + Номер ИНН бенефициара + . + KPP + Номер КПП бенефициара(необязательное) + знак пробела + Наименование бенефициара + знак пробела + /NZP/ + информация о платеже из поля 70 платежных инструкций после транслитерации

:62а:
stringoptional

Исходящий остаток (учтенные средства). Данное поле является составным из 4 полей: Знак дебета/кредита + Дата + Валюта + Сумма. Поле заполняется в одну строку, разделительных знаков между значениями нет

Пример ответа 200 (ОК)

:20:+57610880b621435
:25:40702810701300000761
:28C:1
:60a:C220112RUR99527,00 20
:86:/BENM//03271643540000095400 INN5752006960.KPP575301001 GAVRILOV DOBRYNa TROFIMOVIc /NZP/'(VO21100)' OPLATA PO DOGOVORU
:62a:C220113RUR99407,00

X-Signature
stringoptional

Подпись

X-InitializationVector
stringoptional

Вектор инициализации

X-SymmetricKey
stringoptional

Симметричный ключ

stringoptional

Зашифрованное тело ответа

Пример зашифрованного ответа 200 (ОК)
X-Signature: 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-X-SymmetricKey
X-InitializationVector: wqM/4CR4UenyqPPZfojfkl1YqxFjWPFUurGiJGtWXJepmigWlyB0qtSn7Pw6EW3sboWNvIAl6UJ5VCRLHY47yZda5hxm07uXToYniNUKp+fvtKgZ3DErlWRoXlZ2aUukCED76dONIs0zCWHHXbwv+LhfIHXhDjJcUXZvf8TQZIKpcKA08GBTqeMYIvFHpSqtGcgh+59HqhoUWgFCkfqxJWS0aUrRgyf3iKGeZ3NbyxLQ1WGHdNlsZ5xRU28ktW7JlvP07sgBYGA7ORmbsAfPaP3SGjR2G1f7xBAzny+Qc8hvDJMW76EIizlbMjPlAW8Lt2Qv9WoMiAoTEjSJ6IdbKQ==
X-SymmetricKey: lVUEx4SLTqzYCDbUPO9n5s7KwqfHGOeEKVZ+zdi0CvZoE5rScwqAAySLscqCQrgtkn8mD26v9aYFTecQmBFVgmjxL/CX5+AUfBpYVsxFYEpSaklEX9zBQK7nKg/egQQRas7t0bH6+eBHNE/nCfYhua3rwMhZTFZikscNft8/fIBRshv0BzSGM6BT+QCBhKVeCOTouoBCS87UxpMIXlUIfScwB37Mqpfvva9kicfJWMGDfwnOK2IhbdyEBzzrBoT2cBIdjzmkV2ntsprjBm2MYbFUX7/VSJFirLHE5LCHudb24nWjyTJu0uaT5dOyahmwuc/pDvZam8137ou8ov+e2g==

B2XnhB+4w5PZ6AslAt5oRZ24GrkAcuRIjnyGSKniL2uCwCXDqp9qwEa95yQFyYln9/iHY8E1Br8vSSweyr05lslxLeecOLI98aZaYE3mq9v5UuBWxCj+dngKaK0L8H7gC3ycC+OOs3n3U33kmf5lfsdTHePXvhxazkKdvb92QdYfjSVoYgLM7QJnU83r0yiJrKT5N5ZhX7B/E5yg0MJiIYIrmt7FNdj2sJy+nN8iCnWfsYvHF3KP8GZ6e/fca3HQRffgX7XrENg2v+V2E79+JZueck+sAPTEGTO8WTYfmwnOda3TWLyxGk5XoNgdu6908jJbC5JQDPCrH87UpdbF2lwqaxYeNzFQXaKqN9B5h18=

error
stringrequired

Код ошибки. Принимает возможные значения: invalid_request - Неверные входные параметры запроса

error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request)

error: invalid_request
error_description: Authorization header is not present in request headers

error
stringrequired

Код ошибки. Принимает возможные значения: invalid_token - Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам

error_description
stringoptional

Описание ошибки

Пример ошибки 401 (Unauthorized)

error: invalid_token
error_description: The access token provided is expired, revoked, malformed, or invalid for other reasons

error
stringrequired

Код ошибки. Принимает возможные значения: insufficient_scope - У пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied - Доступ к счету запрещен

error_description
stringoptional

Описание ошибки

Пример ошибки 403 (Forbidden)

error: insufficient_scope
error_description: The request requires higher privileges than provided by the access token

error
stringrequired

Код ошибки. Принимает возможные значения: unknown_endpoint - Эндпоинт не найден или неактивен

error_description
stringoptional

Описание ошибки

Пример ошибки 404 (Not Found)

error: unknown_endpoint
error_description: Endpoint is not found or not active

Нет тела ответа
error
stringrequired

Код ошибки. Принимает возможные значения: internal_error - Внутренняя ошибка сервиса при выполнении обработки запроса

error_description
stringoptional

Описание ошибки

Пример ошибки 500 (Internal Server Error)

error: internal_error
error_description: Internal server error

Нет тела ответа

Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.