Обращения, подаваемые в ФССП России, и результаты их рассмотрения
Атрибут | Значение |
---|---|
Название | fssр-application-doсuments |
Тип | Адаптер для СМЭВ3 сервиса |
Наименование | Обращения, подаваемые в ФССП России, и результаты их рассмотрения |
Поставщики | Органы исполнительной власти, органы местного самоуправления, кредитные организации, многофункциональные центры предоставления государственных и муниципальных услуг (далее - МФЦ), Верховный Суд Российской Федерации, Юридические лица, осуществляющие деятельность по возврату просроченной задолженности в качестве основного вида деятельности |
Потребители | ОИВ, ОМСУ, КО, МФЦ, Верховный суд Российской Федерации, Юридические лица, осуществляющие деятельность по возврату просроченной задолженности в качестве основного вида деятельности. Доступ потребителям предоставляется по согласованию с ФССП России, заявка о предоставлении доступа направляется на fssp.smev@red-soft.ru, требуется прохождение интеграционного тестирования. |
Область применения | Межведомственное взаимодействие, Единый портал государственных и муниципальных услуг (функций) (далее - ЕПГУ), МФЦ |
Версия ВС | 1.1.1 |
Версия МР | 3.3.0.0 |
Версия СМЭВ | СМЭВ3 |
Описание бизнес-процесса взаимодействия:
ИС клиента передает через Агредатор в СМЭВ обращение в адрес Федеральной службы судебных приставов. ФССП получает из СМЭВ запрос и направляет обратно через СМЭВ в Агредатор запрос, содержащий результат рассмотрения обращения. Агредатор направляет в ИС клиента полученную информацию.
Доступ потребителям предоставляется по согласованию с ФССП России, заявка о предоставлении доступа направляется на fssp.smev@red-soft.ru.
Переменные окружения
Название | Описание |
---|---|
CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
MQ_HOST | хост rabbitmq |
MQ_PORT | порт rabbitmq |
SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
DATABASE_URL | строка подключения к БД |
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
Параметры для запросов, инициируемых ИС клиента
Здесь приведены параметры для отправки сообщений Document и DocumentStatus.
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор пакета | + | 12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b2b |
date | Дата формирования | + | 2015-10-12T00:00:00 |
sender_id | Идентификатор отправителя в СМЭВ 3 | + | EPGU01 |
sender_department_code | Код подразделения отправителя пакета | - | 33013 |
receiver_id | Идентификатор получателя пакета в СМЭВ 3 | + | FSSP01 |
receiver_department_code | Код подразделения получателя пакета | - | 33013 |
documents | Документы | -1 | Последовательность элементов Document |
documents_statuses | Сообщения о статусе документов | -1 | Последовательность элементов DocumentStatus |
1 - допускается наличие только одного поля documents или documents_statuses
Структура элемента Document
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор документа отправителя | + | 2469 |
incoming_doc_key | Идентификатор входящего документа | - | 2469 |
type | Код типа документа | + | I_IPSIDE_OSP_COURSEIP |
document_date | Регистрационная дата документа | + | 2015-10-12 |
document_number | Регистрационный номер документа | + | 506559 |
document_case_number | Номер дела | - | 7407/14/33025-ИП |
attachment | Описание вложения | + | Структура элемента Attachment |
Структура элемента DocumentStatus
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор сообщения о статусе | + | 28252008159967 |
referenced_document_id | Идентификатор исходного документа отправителя | + | 2469 |
status_date | Дата и время статуса документа | + | 2015-10-16T15:00:00 |
status_id | Статус документа. Принимает значения из справочника DocumentStatusId | + | 1 |
message_text | Сообщение | - | Доставлен до учетной системы |
Структура элемента Attachment
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
is_unstructured_format | Формат структурированный | + | false |
is_zipped_packet | Содержимое вложения упаковано Zip-алгоритмом | + | true |
structured_format_type | Namespace структурированного формата | + | http://www.fssprus.ru/namespace/IRequestOther/2017/1 |
filename | Имя файла-вложения - zip-архива, содержащего электронный документ и отделенную УКЭП | + | piev_4ccb83c6-2888-4561-8b49-49215ca1cfbc.zip |
storage_id | Идентификатор файла-вложения в файловом хранилище Агредатора | -1 | 52102ea66afe56606adbd26d17ba27b069fc42c8b3c8a0b0289fe6d624886e64 |
1 - отсутствует в случае, если запрос был получен из СМЭВ
Параметры для ответа на запрос
Здесь приведены параметры для формирования ответа DocumentReceipt на полученный запрос.
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор квитанции о приеме | + | 038e7a1f-6c51-4843-8155-acf3e169afb1 |
referenced_pack_id | Идентификатор исходного документа отправителя | + | 12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g |
date | Дата формирования | + | 2015-10-16T12:00:00 |
receipt_result | Результат приема документа или сообщения о статусе документа. Принимает значения из справочника ReceiptResult | + | SUCCESS |
documents_receipt | Квитанции о приеме документов или сообщения о статусе документов | + | Последовательность элементов DocumentReceipt |
Структура элемента DocumentReceipt
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор квитанции о приеме | + | 28251007259918 |
referenced_document_id | Идентификатор исходного документа отправителя | + | 2469 |
receipt_date | Дата формирования | + | 2015-10-12T12:00:00 |
receipt_id | Результат приема документа или сообщения о статусе документа. Принимает значения 90, 91, 92, 93, 94 из справочника DocumentStatusId | + | 93 |
message_text | Сообщение | - | Принят |
Справочник DocumentStatusId
Значение | Наименование статуса | Описание |
---|---|---|
1 | Доставлен до учетной системы | Электронный документ доставлен до учетной системы. Статус документа не конечный. |
9 | Зарегистрирован | Электронный документ зарегистрирован в учетной системе и передан на исполнение. Документу присвоен регистрационный номер в книге учета входящих документов. Статус документа не конечный. |
11 | Направлен в другое подразделение | После регистрации электронный документ перенаправлен в другое подразделение. Статус документа не конечный. |
13 | Исполнен | Электронный документ исполнен. Статус документа конечный. |
14 | Отказан | Электронный документ отказан. Статус документа конечный. |
90 | Подпись не прошла проверку | Подпись электронного документа не прошла проверку. Статус документа конечный. |
91 | Документ не соответствует xsd-схеме | Электронный документ не соответствует xsd-схеме постановления или уведомления. Статус документа конечный. |
92 | Ошибка форматно-логического контроля | Документ не прошел форматно-логический контроль. Статус документа конечный. |
93 | Принят | Документ доставлен до АИС контрагента. Статус документа не конечный. |
94 | Дубликат | Электронный документ является дубликатом к ранее полученному документу. Статус документа конечный. |
Справочник ReceiptResult
Значение | Наименование статуса | Описание |
---|---|---|
SUCCESS | Обработка завершена успешно | Все документы пакета доставлены до АИС контрагента, т.е результат приема документов «Принят» или «Дубликат». |
PARTIALLY | Обработка завершена с ошибками, данные обработаны частично | В пакете документов имеется хотя бы один доставленный документ (результат приема документа «Принят» или «Дубликат») и хотя бы один документ с ошибкой обработки (результат приема документа «Подпись не прошла проверку» или «Документ не соответствует xsd-схеме», или «Ошибка форматно-логического контроля»). |
FAIL | Обработка завершилась с ошибкой, данные не обработаны | Все документы пакета обработаны с ошибкой, т.е. результат приема документов «Подпись не прошла проверку» или «Документ не соответствует xsd-схеме», или «Ошибка форматно-логического контроля». |
Параметры ответа
Параметры, возвращаемые в случае ответа на запрос
Здесь приведены параметры ответа DocumentReceipt, получаемого в случае отправки Document или DocumentStatus
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор квитанции о приеме | + | 038e7a1f-6c51-4843-8155-acf3e169afb1 |
referenced_pack_id | Идентификатор исходного документа отправителя | + | 12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g |
date | Дата формирования | + | 2015-10-16T12:00:00 |
receipt_result | Результат приема документа или сообщения о статусе документа. Принимает значения из справочника ReceiptResult | + | SUCCESS |
documents_receipt | Квитанции о приеме документов или сообщения о статусе документов | + | Последовательность элементов DocumentReceipt |
Параметры, возвращаемые в случае получения запроса
Здесь приведены параметры полученных сообщений Document и DocumentStatus, на которые потом требуется ответить DocumentReceipt
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор пакета | + | 12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b2b |
date | Дата формирования | + | 2015-10-12T00:00:00 |
sender_id | Идентификатор отправителя в СМЭВ 3 | + | FSSP01 |
sender_department_code | Код подразделения отправителя пакета | - | 33013 |
receiver_id | Идентификатор получателя пакета в СМЭВ 3 | + | FSSP01 |
receiver_department_code | Код подразделения получателя пакета | - | 33013 |
documents | Документы | - | Последовательность элементов Document |
documents_statuses | Сообщения о статусе документов | - | Последовательность элементов DocumentStatus |
attachments | Информация о переданных файлах-вложениях, сохраненных в файловом хранилище Агредатора | - | Последовательность элементов AggredatorAttachment |
Структура элемента AggredatorAttachment
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
uuid | Идентификатор файла в хранилище | + | 7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa |
checksum | Контрольная сумма | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
created_at | Время загрузки файла | + | 2020-11-16T12:27:20.726+03:00 |
delete_at | Время, когда файл будет удален из файлового хранилища | + | 2022-03-25T18:03:46.994+03:00 |
mime_type | MIME тип файла вложения | + | text/plain |
filename | Имя загруженного файла | + | test.txt |
smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | attachment.txt |
Примеры
Описание вложений
Работа с сервисом предполагает передачу вложения в элементе Attachment. Правила формирования вложения приведены на сайте ФССП в виде XSD-схем. Ответ от ФССП также будет содержать вложение в поле AggredatorAttachment. Разбор вложения можно произвести аналогично по XSD-схемам, размещенным на сайте ФССП.
В случае запросов Document, DocumentStatus
Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос соответствующего примера и получить соответствующий ответ.
Пример 1
Запрос:
{
"id": "12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b2b",
"date": "2015-10-12T00:00:00",
"sender_id": "EPGU01",
"receiver_id": "FSSP01",
"receiver_department_code": "33013",
"documents": [
{
"id": "2469",
"type": "I_IPSIDE_OSP_COURSEIP",
"document_date": "2015-10-12",
"document_number": "506559",
"document_case_number": "7407/14/33025-ИП",
"attachment": {
"is_unstructured_format": false,
"is_zipped_packet": true,
"structured_format_type": "http://www.fssprus.ru/namespace/IRequestOther/2017/1",
"filename": "piev_4ccb83c6-2888-4561-8b49-49215ca1cfbc.zip"
}
}
]
}
Ответ:
{
"id": "038e7a1f-6b51-4843-9455-acf3e169afc8",
"referenced_pack_id": "12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b2b",
"date": "2015-10-12T00:00:00",
"receipt_result": "SUCCESS",
"documents_receipt": [
{
"id": "28251007259918",
"referenced_document_id": "2469",
"receipt_date": "2015-10-12T12:00:00",
"receipt_id": "93",
"message_text": "Принят"
}
]
}
Пример 2
Запрос:
{
"id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g",
"date": "2015-10-12T00:00:00",
"sender_id": "FSSP01",
"sender_department_code": "33013",
"receiver_id": "EPGU01",
"documents_statuses": [
{
"id": "28252008159967",
"referenced_document_id": "2469",
"status_date": "2015-10-16T15:00:00",
"status_id": "1",
"message_text": "Доставлен до учетной системы"
}
]
}
Ответ:
{
"id": "038e7a1f-6b51-4843-9455-acf3e169afb1",
"referenced_pack_id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g",
"date": "2015-10-12T00:00:00",
"receipt_result": "SUCCESS",
"documents_receipt": [
{
"id": "1197",
"referenced_document_id": "28252008159967",
"receipt_date": "2015-10-16T12:00:00",
"receipt_id": "93"
}
]
}
Пример 3
Запрос:
{
"id": "12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b9b",
"date": "2015-10-12T00:00:00",
"sender_id": "FSSP01",
"sender_department_code": "33013",
"receiver_id": "EPGU01",
"documents": [
{
"id": "28251007260018",
"incoming_doc_key": "2469",
"type": "O_IPSIDE_OSP_COURSEIP",
"document_date": "2015-10-12",
"document_number": "7259916/3313",
"document_case_number": "7407/14/33013-ИП",
"attachment": {
"is_unstructured_format": false,
"is_zipped_packet": true,
"structured_format_type": "http://www.fssprus.ru/namespace/IRequestOther/2017/1",
"filename": "piev_4ccb83c6-2888-4561-8b49-49215ca1cfba.zip"
}
}
]
}
Ответ:
{
"id": "038e7a1f-6b51-4843-9455-acf3e169afc9",
"referenced_pack_id": "12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b9b",
"date": "2015-10-12T00:00:00",
"receipt_result": "SUCCESS",
"documents_receipt": [
{
"id": "1236",
"referenced_document_id": "28251007260018",
"receipt_date": "2015-10-12T12:00:00",
"receipt_id": "93",
"message_text": "Принят"
}
]
}
Пример 4
Запрос:
{
"id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a8g",
"date": "2015-10-16T00:00:00",
"sender_id": "EPGU01",
"receiver_id": "FSSP01",
"receiver_department_code": "33013",
"documents_statuses": [
{
"id": "1256",
"referenced_document_id": "28251007260018",
"status_date": "2015-10-16T15:00:00",
"status_id": "1",
"message_text": "Доставлен до учетной системы"
}
]
}
Ответ:
{
"id": "038e7a1f-6c51-4843-8155-acf3e169afb1",
"referenced_pack_id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a8g",
"date": "2015-10-16T00:00:00",
"receipt_result": "SUCCESS",
"documents_receipt": [
{
"id": "28251007270018",
"referenced_document_id": "1256",
"receipt_date": "2015-10-16T12:00:00",
"receipt_id": "93"
}
]
}
В случае получения запросов Document, DocumentStatus из СМЭВ
Пример данных запроса Document, полученного из СМЭВ (поле request)
{
"id": "12f1a3cd-cd5f-48fe-8ed4-f73e3d9f9b9b",
"date": "2015-10-12T00:00:00",
"sender_id": "FSSP01",
"sender_department_code": "33013",
"receiver_id": "EPGU01",
"documents": [
{
"id": "28251007260018",
"incoming_doc_key": "2469",
"type": "O_IPSIDE_OSP_COURSEIP",
"document_date": "2015-10-12",
"document_number": "7259916/3313",
"document_case_number": "7407/14/33013-ИП",
"attachment": {
"is_unstructured_format": false,
"is_zipped_packet": true,
"structured_format_type": "http://www.fssprus.ru/namespace/IRequestOther/2017/1",
"filename": "piev_4ccb83c6-2888-4561-8b49-49215ca1cfba.zip"
}
}
]
}
Пример данных запроса DocumentStatus, полученного из СМЭВ (поле request)
{
"id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g",
"date": "2015-10-16T00:00:00",
"sender_id": "FSSP01",
"sender_department_code": "33013",
"receiver_id": "EPGU01",
"documents_statuses": [
{
"id": "28252008159967",
"referenced_document_id": "2469",
"status_date": "2015-10-16T15:00:00",
"status_id": "1",
"message_text": "Доставлен до учетной системы"
}
]
}
Пример данных ответа DocumentReceipt на запрос:
{
"id": "038e7a1f-6c51-4843-8155-acf3e169afb1",
"referenced_pack_id": "12f1a3cd-cd5f-48fe-8eb4-f73e3d9f8a9g",
"date": "2015-10-16T12:00:00",
"receipt_result": "SUCCESS",
"documents_receipt": [
{
"id": "1197",
"referenced_document_id": "28252008159967",
"receipt_date": "2015-10-16T12:00:00",
"receipt_id": "93"
}
]
}