Веб-сервис ФССП России. Описание. Форматы данных (стр. 2 )

На прикладном уровне взаимодействие производится по технологии веб-сервисов. На стороне ФССП России «Подсистема межведомственного взаимодействия АИС ФССП России» предоставляет веб-сервис. На стороне внешнего контрагента для взаимодействия с ФССП России должен быть реализован клиент веб-сервиса. Данный клиент должен периодически опрашивать данный веб-сервис на наличие сообщений для внешнего контрагента, и передающий веб-сервису сообщения для ФССП России.

Для организации защищенного соединения между веб-сервисом и клиентом веб-сервиса может устанавливаеться защищенное соединение по протоколу TLS версии 1.2 (http://tools. ietf. org/html/rfc5246). При этом средства защиты канала данных должны отвечать стандартам ГОСТ , ГОСТ Р 34.11, ГОСТ Р 34.10-94, ГОСТ Р34.10-2001. На стороне ФССП России используется СКЗИ «Крипто-ПРО».

На клиенте и сервере должны быть реализованы механизмы контроля сроков, выявления сбоев в работе, оповещения об инцидентах соответствующей службы эксплуатации.

2.1.   Передача документов от ФССП России внешним контрагентам

Для получения документов в адрес контрагента, его клиент веб-сервиса должен вызвать операцию «GetMessages» путем отправки сообщения GetMessagesRq.

После получения данного запроса, сервер производит следующие операции:

•  По поступившему сообщению система определяет внешнего контрагента, к которому привязаны данные логин-пароль заголовка SOAP-сообщения.

При невозможности определить контрагента по причине некорректности переданной информации, клиенту возвращается сообщение об ошибке Error.

Для установленного контрагента выполняется поиск готовых пакетов документов для передачи контрагенту на статусе «В очереди». Количество документов в пакетах и количество пакетов определяется настройками сервера (настройки FSSP_OUT_MAX_PACK_COUNT, FSSP_OUT_MAX_DOC_PACK_COUNT, см. ниже) и устанавливается по результатам опытной эксплуатации.

Передаваемые пакеты документов переводятся на специальный статус «Отправлен».

Формируется сообщение типа GetMessagesRs для внешнего контрагента и передается в качестве результата работы операции клиенту веб-сервиса. Возвращаемое сообщение содержит данные документов, направленных внешнему контрагенту.

После получения ответа от веб-сервиса и его обработки, клиент должен вызвать операцию «NotifyMessages». Данным сообщением клиент подтверждает корректность (соответствие схеме данных и описанию форматов), либо некорректность полученных документов. При получении сообщения NotifyDocumentsRq сервером производятся следующие действия:

•  Пакеты документов, внутренние ключи (ключи АИС ФССП России) которых переданы в сообщении, переводятся на статус «Получен». Ключи пакетов документов, не указывающие на ранее переданные пакеты документов, игнорируются. Пакеты документов, которые не могут быть приняты клиентов по причине их некорректности переводятся на специальный статус «Ошибка отправки» для последующего разбора ситуации обслуживающим персоналом систем.

Формируется сообщение типа NotifyMessagesRs, в котором содержатся ключи обработанных пакетов. Данное сообщение возвращается клиенту.

В случае неполучения сообщения типа NotifyMessagesRs клиентом требуется повторно передать сообщение подтверждения через интервал времени, указанный в настройке FSSP_OUT_NOTIFY_DELAY_TIME. Количество попыток передачи подтверждения серверу ФССП России указано в настройке FSSP_OUT_NOTIFY_COUNT. По истечении указанного количества попыток отправка подтверждения считается невозможной и о проблеме уведомляется обслуживающий персонал систем.

Если вызова функции NotifyMessages не произошло в течение определенного времени (настройка FSSP_OUT_RESEND_UNCONFIRMED_TIME, см. ниже) после получения сообщений контрагентом, то соответствующие пакеты документов переодятся со статуса «Отправлен» обратно на статус «В очереди». При повторном запросе к веб-сервису эти пакеты документов будут направлены контрагенту вновь.

При повторном направлении клиентом сообщения NotifyDocumentsRq повторно формируется сообщение NotifyMessagesRs с результатами обработки пакетов документов.

Веб-сервисом обеспечивается приоритетная передача пакетов документов с меньшим числом попыток их передать. Если веб-сервис не получает подтверждения о приеме клиентом документов после многократной их отправки (настройка FSSP_OUT_MAX_TRY_COUNT, см. ниже), то соответствующие пакеты документов переводятся на статус «Ошибка отправки» для последущего разбора. Такие пакеты документов отправляются администратором веб-сервиса клиенту после устранения соответствующих проблем.

В случае, если веб-сервис не вернул пакетов документов для контрагента, очередной вызов веб-сервиса должен произойти не ранее, чем через определенное время (настройка FSSP_OUT_GET_MESSAGES_DELAY_TIME, см. ниже).

2.2.   Передача документов от внешних контрагентов ФССП России

Для передачи документов в адрес ФССП России контрагент вызывает операцию веб-сервиса «PutMessages», отправляя сообщение PutMessagesRs. Отправляемые пакеты документов переводятся контрагентом на статус «Отправлен». Максимальное количество передаваемых за один сеанс документов устанавливается (настройки FSSP_IN_MAX_PACK_COUNT, FSSP_IN_MAX_DOC_PACK_COUNT, см. ниже) по результатам опытной эксплуатации. При получении сообщения сервером производятся следующие действия:

•  По поступившему сообщению система определяет внешнего контрагента, к которому привязаны данные логин-пароль заголовка SOAP-сообщения.

При невозможности определить контрагента по причине некорректности переданной информации, клиенту возвращается сообщение об ошибке Error.

Проверяется правильность полученного сообщения на соответствие схеме данных.

Повторно направленные пакеты документов с тем же ключем, в случае, если они были приняты веб-сервисом ранее и прошли входной контроль, игнорируются. В противном случае пакеты документов обрабатываются обычным порядком.

Если сообщение и/или пакеты документов не проходят проверку на корректность (соответствие схеме данных и описанию форматов), клиенту отправляется сообщение PutMessageRs с указанием внешних ключей (ключей АИС контрагента) ошибочных пакетов. При возможности, ошибочные пакеты документов фиксируются в базе данных АИС ФССП России на специальном статусе «Ошибка приема». При этом корректные пакеты документов обрабатываются обычным образом.

Корректные пакеты документов фиксируются в базе данных АИС ФССП России. Клиенту формируется и отправляется сообщение PutMessageRs с указанием ключей принятых пакетов документов.

При получении ответа веб-сервиса, клиент меняет статус принятых пакетов документов на «Принят». Ошибочные пакеты документов должны переводиться на специальный статус «Ошибка отправки» для последующего разбора ситуации обслуживающим персоналом систем. Пакеты документов, подтверждения приема которых не получено, через определенное время (настройка FSSP_IN_RESEND_UNCONFIRMED_TIME, см. ниже) должны возвращаються со статуса «Отправлен» обратно в очередь отправки для повторной передачи. При повторной передаче пакетов документов должно быть обеспечено условие приоритетной передачи пакетов документов с меньшим количеством попыток повторной передачи. При многократной (настройка FSSP_IN_MAX_TRY_COUNT, см. ниже) передаче пакетов документов без получения уведомления, эти пакеты докуентов должны быть отправлены на статус «Ошибка передачи» с указанием соответствующей причины. В клиенте должна быть возможнось перевести эти документы обратно в очередь отправки для их передачи после устранения соответствующих проблем.

После передачи пакета документов веб-сервису повторная передача данных допускается через установленное время (настройка FSSP_IN_PUT_MESSAGES_DELAY_TIME, см. ниже).

2.3.   Настройки параметров обмена пакетами документов

Данные настройки могут изменяться обслуживающим персоналом при условии согласования параметров работы систем между ФССП России и внешним контрагентом:

Таблица 1

Наименование настройки	Описание	Значение по умолчанию (начальное)
FSSP_OUT_MAX_PACK_COUNT	Максимальное количество одновременно передаваемых пакетов документов от ФССП контрагенту	1
FSSP_OUT_MAX_DOC_PACK_COUNT	Максимальное количество документов в пакете при передаче документов от ФССП контрагенту	1 – для тестирования 100 – для опытной эксплуатации
FSSP_OUT_RESEND_UNCONFIRMED_TIME	Время, по истечении которого сервером ФССП отправленные, но неподтвержденные пакеты документов отправляются в очередь отправки	15 мин.
FSSP_OUT_MAX_TRY_COUNT	Максимальное количество попыток передать пакет документов контрагенту	20
FSSP_OUT_GET_MESSAGES_DELAY_TIME	Время между обращениями клиента к серверу ФССП за пакетами документов	5 мин.
FSSP_OUT_NOTIFY_DELAY_TIME	Время между повторными направлениями подтверждения на сервер ФССП России	10 мин.
FSSP_OUT_NOTIFY_COUNT	Количество попыток переслать подтвержедение серверу ФССП России перед уведомлением обслуживающего персонала систем о проблеме.	10
FSSP_IN_MAX_PACK_COUNT	Максимальное количество пакетов документов, передаваемое за один сеанс от контрагента в ФССП	1
FSSP_IN_MAX_DOC_PACK_COUNT	Максимальное количество документов в пакете, передаваемом контрагентом в ФССП	1 – для тестирования 100 – для опытной эксплуатации
FSSP_IN_RESEND_UNCONFIRMED_TIME	Время, по истечении которого клиент должен отправить пакет документов в ФССП при отсутствии подтверждения о приеме от ФССП.	15 мин
FSSP_IN_MAX_TRY_COUNT	Максимальное количество попыток клиента отправить неподтвержденный пакет документов в ФССП.	20
FSSP_IN_PUT_MESSAGES_DELAY_TIME	Время между обращениями клиента к серверу ФССП для передачи документов.	5 мин.

2.4.   Использование документов внешними контрагентами

Настоящий документ описывает форматы единого веб-сервиса ФССП России. Веб-сервис может использоваться одновременно несколькими внешними контрагентами. Каждый из внешних контрагентов в соответствии с Соглашением об электронном документообороте между ФССП России и внешним контрагентом может использовать для обмена документами подмножество описанных форматов данных. Для облегчения поиска необходимой информации в настоящем документе, сведения о внешних контрагентах и используемых ими форматах данных сведены в таблицу. Кроме того, в сопроводительных данных каждой таблицы, описывающей сложные типы данных, сделана сноска на сокращенные наименования внешних контрагентов, использующих данные.

Таблица 2

Сокращенное наименование	Полное наименование внешнего контрагента	Используемые документы или сообщения	Направление передачи данных
ФНС	Федеральная налоговая служба	DataBlock «Блок данных»	В обе стороны
ExtDoc «Исполнительный документ»	-"-
ProcDoc «Постановление СПИ»	От ФССП России в ФНС
ExtDebtFix «Погашение ИД»	От ФНС в ФССП России
RecallDoc «Заявление об отзыве ИД»	-"-
BankruptDoc «Уведомление об инициировании процедуры банкротства должника»	-"-
ArrestFourthStagePropertyType «Уведомление СПИ об аресте имущества 4й очереди»	От ФССП России в ФНС
ПФР	Пенсионный фонд России	DataBlock «Блок данных»	В обе стороны
Query «Запрос СПИ»	От ФССП России в ПФР
Answer «Ответ на запрос СПИ»	От ПФР в ФССП России
Restrictn «Постановление к исполнению»	От ФССП России в ПФР
Report «Уведомление об исполнении»	От ПФР в ФССП России
ExtDoc «Исполнительный документ»	-"-
ProcDoc «Постановление СПИ»	От ФССП России в ПФР
ExtDebtFix «Погашение ИД»	От ПФР в ФССП России
RecallDoc «Заявление об отзыве ИД»	-"-
ФМС	Федеральная миграционная служба	DataBlock «Блок данных»	В обе стороны
Restrictn «Постановление к исполнению»	От ФССП России в ФМС
Report «Уведомление об исполнении»	От ФМС в ФССП России
DebtorDocumentRequestType «Запрос документов по должнику»	-"-
DebtorDocumentResponseType «Ответ на запрос документов по должнику»	От ФССП России в ФМС
DebtorIPListRequestType «Запрос реестра ИП по должнику»	От ФМС в ФССП России
DebtorIPListResponseType «Список исполнительных производств по должнику»	От ФССП России в ФМС
Росреестр	Федеральная служба государственной регистрации, кадастра и картографии	DataBlock «Блок данных»	В обе стороны
Restrictn «Постановление к исполнению»	От ФССП России в Росреестр
Report «Уведомление об исполнении»	От Росреестра в ФССП России
DebtorDocumentRequestType «Запрос документов по должнику»	-"-
DebtorDocumentResponseType «Ответ на запрос документов по должнику»	От ФССП России в Росреестр
Банки	Коммерческие банки	DataBlock «Блок данных»	В обе стороны
		Query «Запрос СПИ»	От ФССП России в банк
		Answer «Ответ на запрос СПИ»	От банка в ФССП России
		Restrictn «Постановление к исполнению»	От ФССП России в банк
		Report «Уведомление об исполнении»	От банка в ФССП России
		ProcDoc «Постановление СПИ»	От ФССП России в банк
		DebtRequest «Запрос реестра»	От банка в ФССП России
		Debt «Остатки долга»	От ФССП России в банк
		OspRequest «Запрос реквизитов ОСП»	От банка в ФССП России
		OspProperties «Реквизиты ОСП»	От ФССП России в банк
		ExtPayments «Оплата долга»	От банка в ФССП России
ЕПГУ	Единый портал государственных услуг	DebtorIPListRequestType «Запрос реестра ИП по должнику»	От ЕПГУ в ФССП России
DebtorIPListResponseType «Список исполнительных производств по должнику»	От ФССП России в ЕПГУ
IPSideRequestType «Запрос стороны ИП»	От ЕПГУ в ФССП России
IPSideApplicationType «Заявление стороны ИП»	От ЕПГУ в ФССП России
IPReqAppResponseType «Ответ на запрос или заявление в ОСП»	От ФССП России в ЕПГУ
IPReqAppResultRequestType «Запрос на получение ответов на заявления или HYPERLINK \l "15.Тип данных IPReqAppResultRequestType «Запрос на получение ответов на заявления или запросы в ОСП»|outline" запросы в ОСП»	От ЕПГУ в ФССП России
IPReqAppResultResponseType «Ответы на запросы или заявления»	От ФССП России в ЕПГУ
ПС	Системы приема платежей	DataBlock «Блок данных»	В обе стороны
DebtRequest «Запрос реестра»	От ПС в ФССП России
Debt «Остатки долга»	От ФССП России в ПС
OspRequest «Запрос реквизитов ОСП»	От ПС в ФССП России
OspProperties «Реквизиты ОСП»	От ФССП России в ПС
ExtPayments «Оплата долга»	От ПС в ФССП России
IPBriefInfoRequestType «Запрос сведений ИП по номеру ИП»	От ПС в ФССП России
IPBriefInfoResponseType «Сведения ИП»	От ФССП России в ПС
СТ	Сирена-Трэвел	DataBlock «Блок данных»	В обе стороны
Query «Запрос СПИ»	От ФССП России в СТ
Answer «Ответ на запрос СПИ»	От СТ в ФССП России
ГИБДД	Департамент обеспечения безопасности дорожного движения Министерства внутренних дел Российской Федерации	DataBlock «Блок данных»	В обе стороны
Query «Запрос СПИ»	От ФССП России в ГИБДД
Answer «Ответ на запрос СПИ»	От ГИБДД в ФССП России
Restrictn «Постановление к исполнению»	От ФССП России в ГИБДД
Report «Уведомление об исполнении»	От ГИБДД в ФССП России
ОпСОС	Операторы сотовой связи	DataBlock «Блок данных»	В обе стороны
Query «Запрос СПИ»	От ФССП России в ОпСОС (Сведения о доккументе, удостоверяющем личность)
Answer «Ответ на запрос СПИ»	От ОпСОС в ФССП России (Сведения о документе, удостоверяющем личность, сведения об адресе, сведения о телефонных номерах, сведения об абоненте).

3.   Описание веб-сервиса

3.1.   Общие требования

Электронное сообщение – последовательность символов определенного формата и структуры, с помощью которого осуществляется электронный документооборот.