Запрос на уточнение информации о суммах выплаченных физическому лицу процентов по вкладам (остаткам на счетах)

smev3 link

smev manual

Атрибут Значение
Название fns-nalfproc
Тип Адаптер для межведомственного взаимодействия
Наименование Запрос на уточнение информации о суммах выплаченных физическому лицу процентов по вкладам (остаткам на счетах)
Назначение Вид сведений предназначен для предоставления банками информации о суммах выплаченных физическому лицу процентов по вкладам (остаткам на счетах)
Область применения Межведомственное взаимодействие
Версия 4.0.1
Версия МР 3.4.0.3
Версия СМЭВ СМЭВ3
Поставщики Кредитные организации
Потребитель ФНС России
flowchart LR; A[ИС ФНС] <--> B[Агредатор]; B <--> C[СМЭВ]; C <--> D[ИС кредитной организации];

Описание бизнес-процесса взаимодействия:

ФНС направляет в кредитные организации запрос на уточнение информации о суммах выплаченных физическому лицу процентов по вкладам (остаткам на счетах). Кредитная организация в ответ направляет по указанному идентификатору запроса результат обработки запроса (запрос принят в обработку или ошибка форматно-логического контроля).

Переменные окружения

Название Описание
CA_CERT сертификат центра сертификации для подключения к rabbitmq
CLIENT_CERT сертификат, используемый для подключения к rabbitmq
CLIENT_KEY ключ, используемый для подключения к rabbitmq
MQ_HOST хост rabbitmq
MQ_PORT порт rabbitmq
SMEV_SERVICE название смэв сервиса, на который будут отправляться запросы
DATABASE_URL строка подключения к БД
EMULATE_CLIENT флаг эмуляции ответа клиента

Переменные для конфигурирования отправки метрик в Elasticsearch:

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

Принимаемые параметры

В данном разделе приведены параметры необходимые для формирования ответа на полученный запрос.

Параметр Описание Обязательное Пример
rejection Данные о возврате, в случае неуспешной проверки запроса +1 Составной элемент Rejection
request_id Идентификатор запроса, сформированный запрашивающей стороной +1 00000000-0000-0000-0000-000000000001
processing_code Код обработки. Принимает значение:
10 – запрос принят в обработку
82 – ошибка форматно-логического контроля
+1 10
errors_description Описание ошибок -1, 2  

1 - допустимо только либо наличие rejection, либо всего остального

2 - обязателен при значении processing_code, равном 82

Структура элемента Rejection

Параметр Описание Обязательное Пример
code Код возврата. Принимает значение:
UNKNOWN_REQUEST_DESCRIPTION - ФЛК запроса не пройден
ACCESS_DENIED - принято решение об отказе в предоставлении сведений в случае отсутствия прав на получение информации
+ UNKNOWN_REQUEST_DESCRIPTION
description Описание + Принято решение об отказе в предоставлении сведений в случае отсутствия прав на получение информации

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

Данный сервис получает запрос от СМЭВ 3 и ожидает получения ответа. В данном разделе указаны параметры, получаемые в результате обработки запроса.

Параметр Описание Обязательное Пример
request_id Идентификатор запроса, сформированный запрашивающей стороной + 00000000-0000-0000-0000-000000000001
supplier_request_id Идентификатор запроса, сформированный поставщиком, по которому требуется уточнение + 00000000-0000-0000-0000-000000000001
supplier_mnemonic Мнемоника поставщика + FNS001
period Налоговый период + 2020
tax_authority_code Код налогового органа. Принимает значение кода в соответствии с СОНО + 0000
bank Сведения о банке + Составной элемент Bank
updated_info Сведения об уточняемой информации + Последовательность элементов UpdatedInfo

Структура элемента Bank

Параметр Описание Обязательное Пример
name Сокращенное наименование банка + Тестовое наименование банка
inn ИНН банка + 1000000000
kpp КПП банка + 100000000
reorganization_info Сведения о реорганизованном (ликвидированном) банке - Составной элемент ReorganizationInfo

Структура элемента ReorganizationInfo

Параметр Описание Обязательное
form_code Код формы реорганизации (ликвидация). Принимает значение:
0 – ликвидация
1 – преобразование
2 – слияние
3 – разделение
5 – присоединение
6 – разделение с одновременным присоединением
+
inn ИНН реорганизованного банка -
kpp КПП реорганизованного банка -

Структура элемента UpdatedInfo

Параметр Описание Обязательное Пример
serial_number Порядковый номер + 1
correction_number Номер корректировки. Принимает значение:
00 – первичная Информация банка,
01 – 98 – номер уточнения (корректировки) Информации банка
99 – при представлении аннулирующей корректирующей Информации банка
+ 02
request_type Вид запроса. Принимает значения:
1 – запрос об уточнении паспортных данных физического лица
2 – запрос об уточнении суммы процентов
+ 1

Примеры

В теле сообщения-запроса (payload) передаются следующие поля:

Поле Описание
envelope XML ВС, полученного из СМЭВ
request Словарь с разобранными параметрами, извлеченными из XML ВС, переданной в envelope
metadata Словарь метаданных запроса

Пример данных запроса (поле request):

{
  "request_id": "00000000-0000-0000-0000-000000000001",
  "supplier_request_id": "00000000-0000-0000-0000-000000000001",
  "supplier_mnemonic": "FNS001",
  "period": "2020",
  "tax_authority_code": "0000",
  "bank": {
    "name": "Тестовое наименование банка",
    "inn": "1000000000",
    "kpp": "100000000"
  },
  "updated_info": [
    {
      "serial_number": 1,
      "correction_number": "01",
      "request_type": "1"
    },
    {
      "serial_number": 2,
      "correction_number": "02",
      "request_type": "2"
    }
  ]
}

Пример ответа:

{
  "request_id": "00000000-0000-0000-0000-000000000001",
  "processing_code": 10
}