Передача транспортных контейнеров, содержащих документы, направляемые ФНС, в кредитные организации

Атрибут	Значение
Название	fns-docvzkrorg
Наименование	Передача транспортных контейнеров, содержащих документы, направляемые ФНС, в кредитные организации
Тип	Адаптер для СМЭВ3 сервиса
Область применения	Межведомственное взаимодействие
Версия СМЭВ	СМЭВ3
Версия ВС	4.0.2
Версия МР	3.5
Поставщик	Кредитные организации Российской Федерации
Потребители	Федеральная налоговая служба

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

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

После получения запроса, ИС кредитной организации отправляет через Агредатор ответ на запрос ФНС в СМЭВ к ВС, который впоследствии направляется в ИС ФНС .

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

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

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

Параметр	Описание	Обязательное	Пример
request_id	Идентификатор запроса, сформированный запрашивающей стороной	+	00000000-0000-0000-0000-000000000001
request_date_time	Дата и время получения	+	2001-12-17T09:30:47Z
processing_code	Код обработки. Принимает значение: 0 – файл не принят; 1 – файл принят	+	0

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

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

Параметр	Описание	Обязательное	Пример
request_id	Идентификатор запроса, сформированный запрашивающей стороной	+	00000000-0000-0000-0000-000000000001
provider_routing_code	Код маршрутизации поставщика (Мнемоника поставщика)	+	0100000000
provider_code	Код поставщика	+	0000001
attachment_info	Описание вложения	+	Составной элемент AttachmentInfo
attachment	Данные, необходимые для получения вложения	+	Составной элемент AggredatorAttachment

Транспортный контейнер (вложение) передается в ZIP архиве в формате Base 64. Размер вложенного файла не превышает 5Мб.

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

Параметр	Описание	Обязательное	Пример
uuid	Идентификатор файла в хранилище	+	4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec
checksum	Контрольная сумма	+	e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
created_at	Время загрузки файла	+	2020-11-16T12:27:20.726+03:00
tags	Последовательность строк-тегов файла	+	["test"]
metadata	Метаданные	+	{}
delete_at	Время, когда файл будет удален из хранилища. В случае, если значение равно null - файл не будет удален	+	null
filename	Имя загруженного файла	+	test.txt
store	Хранилище, в котором хранится файл	+	db
identifier_in_store	Идентификатор файла в хранилище	+	4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec
smev_id	Идентификатор вложения, используемый в СМЭВ конверте	+	attachment.txt

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

Описание вложения

Параметр	Описание	Обязательное	Пример
file_name	Имя (идентификатор) файла вложения	+	AFN_SSSSSSS_RRRRRRR_ГГГГММДД_NNNNNNNN.arj
file_kind	Вид информации (наименование сведений) файла вложения	+	ДОКУМ_НАЛ_ОРГН
file_type	Тип (формат) файла вложения	+	ARJ
file_format	Версия формата файла вложения (имя схемы, по которой сформирован файл вложения)	-	fns-docvzkrorg-ru-root
archive_name	Имя архива, в который упакован файл вложения	+	AFN_SSSSSSS_RRRRRRR_ГГГГММДД_NNNNNNNN.zip

Примеры

Пример запроса на передачу транспортного контейнера, содержащего документы, направляемые ФНС в кредитные организации. (поле request в теле запроса):

{
  "request_id": "00000000-0000-0000-0000-000000000001",
  "provider_routing_code": "0100000000",
  "provider_code": "0000001",
  "attachment_info": {
    "file_name": "AFN_SSSSSSS_RRRRRRR_ГГГГММДД_NNNNNNNN.arj",
    "file_kind": "ДОКУМ_НАЛ_ОРГН",
    "file_type": "ARJ",
    "file_format": "fns-docvzkrorg-ru-root",
    "archive_name": "AFN_SSSSSSS_RRRRRRR_ГГГГММДД_NNNNNNNN.zip"
  },
  "attachment": {}
}

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

{
  "request_id": "00000000-0000-0000-0000-000000000001",
  "request_date_time": "2001-12-17T09:30:47Z",
  "processing_code": "0"
}