Внесение информации в реестр объектов контроля ЕРВК

smev3 link

smev manual

Атрибут Значение
Название med-add-control-objects
Наименование Внесение информации в реестр объектов контроля ЕРВК
Тип Адаптер для СМЭВ3 сервиса
Версия СМЭВ СМЭВ3
Версия ВС 1.0.3
Версия МР 3.5.0.1
Поставщик Министерство экономического развития Российской Федерации
Потребители ФОИВ, РОИВ

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

ИС организации хочет внести информацию в реестр объектов контроля ЕРВК.

ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его к ЕРВК.

После получения запроса ЕРВК проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор информацию о результате запроса, Агредатор направляет данную информацию в ИС организации.

Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.

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_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

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

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

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

Параметр Описание Обязательное Пример
records Записи объектов контроля + Массив составных элементов Record

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

Запись объекта контроля

Параметр Описание Обязательное Пример
ervk_id Идентификатор записи из ЕРВК, которую надо изменить/удалить - 4420582
action Тип выполняемого действия + ADD / DELETE / EDIT
object_data Объект, над которым проводятся действия - Составной элемент ObjectData

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

Объект, над которым проводятся действия

Параметр Описание Обязательное Пример
external_id Идентификатор объекта контроля в ведомственной системе + 123eee1231
control_object Информация об объекте контроля + Составной элемент ControlObject
supervision Информация о виде контроля + Составной элемент Supervision
control_organ Информация о КНО + Составной элемент ControlOrgan
risk_category Категория риска или класс опасности + Составной элемент RiskCategory
object_subspec Подвид, вид, тип объекта контроля + Составной элемент ObjectSubspec
legal_entities Контролируемые лица + Составной элемент LegalEntities

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

Информация об объекте контроля

Параметр Описание Обязательное Пример
name Название объекта + АО Овощная база
address Адрес объекта -1 г Москва, ул Ивана Ивановича, д 1
geolocation Координаты объекта -1  

1 - обязательно должен присутствовать только один из элементов

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

Информация о виде контроля

Параметр Описание Обязательное Пример
code Код вида контроля + 094
title Название вида контроля + Региональный государственный лицензионный контроль за осуществлением предпринимательской деятельности по управлению многоквартирными домами
record_id Идентификатор вида контроля + 0af4cd2e-78cb-109b-8178-e981360303e8

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

Информация о КНО

Параметр Описание Обязательное Пример
code Код КНО + 00007
title Название КНО + Министерство Московской области по илищно-коммунальному хозяйству
ogrn ОГРН КНО + 51177460267511
record_id Идентификатор КНО + 0af4cd2e-78cb-109b-8178-e92043eb0072

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

Категория риска или класс опасности

Параметр Описание Обязательное Пример
code Код категории риска или класса опасности + 6
title Название категории риска или класса опасности + низкий риск

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

Подвид, вид, тип объекта контроля

Параметр Описание Обязательное Пример
record_id Идентификатор подвида объекта контроля + 0ae94710-7ff4-1fce-817f-f833f4bd01ef
title Наименование подвида объекта контроля + деятельность по осуществлению работ по капитальному ремонту, ремонту и содержанию автомобильных дорог общего пользования местного значения и искусственных дорожных сооружений на них
analogue Признак соответствия виду объекта контроля + true
object_spec Вид объекта контроля + Составной элемент ObjectSpec

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

Вид объекта контроля

Параметр Описание Обязательное Пример
record_id Идентификатор вида объекта контроля + 0ae94710-7ff4-1fce-817f-f833f4bd01ef
title Наименование вида объекта контроля + деятельность по осуществлению работ по капитальному ремонту, ремонту и содержанию автомобильных дорог общего пользования местного значения и искусственных дорожных сооружений на них
object_type Тип объекта контроля + Составной элемент ObjectType

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

Тип объекта контроля

Параметр Описание Обязательное Пример
record_id Идентификатор типа объекта контроля + 0af4cd2e-78cb-109b-8178-ea2e8d46040d
title Наименование типа объекта контроля + Деятельность и действия

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

Контролируемые лица

Параметр Описание Обязательное Пример
legal_entity_fl Информация о контролируемом лице - Физическое лицо - Массив составных элементов LegalEntityFL
legal_entity_ip Информация о контролируемом лице - Индивидуальный предприниматель - Массив составных элементов LegalEntityIP
legal_entity_ul Информация о контролируемом лице - Юридическое лицо - Массив составных элементов LegalEntityUL
legal_entity_ifl Информация о контролируемом лице - Иностранное физическое лицо - Массив составных элементов LegalEntityIFL
legal_entity_iul Информация о контролируемом лице - Иностранное юридическое лицо - Массив составных элементовт LegalEntityIUL
legal_entity_iul_branches Информация о контролируемом лице - Филиал иностранного юридического лица - Массив составных элементов LegalEntityIULBranches

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

Информация о контролируемом лице - Физическое лицо

Параметр Описание Обязательное Пример
name Имя + Иван
surname Фамилия + Иванов
patronymic Отчество - Иванович
address Адрес + Москва, Тверская, 14
inn ИНН -1 123456789021
snils СНИЛС -1 123-456-789 00
phone Телефон + +79998887766
email Электронная почта + ervk@mail.ru

1 - обязательно должен присутствовать один из элементов

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

Информация о контролируемом лице - Индивидуальный предприниматель

Параметр Описание Обязательное Пример
name Имя + Иван
surname Фамилия + Иванов
patronymic Отчество - Иванович
address Адрес + Москва, Тверская, 14
ogrn ОГРН -1 323456789012345
ogrn_date Дата выдачи ОГРН - 2003-03-15
inn ИНН -1 123456789012
phone Телефон + +79998887766
email Электронная почта + mail@example.com

1 - обязательно должен присутствовать только один из элементов

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

Информация о контролируемом лице - Юридическое лицо

Параметр Описание Обязательное Пример
full_name Полное наименование + ООО РОГА И КОПЫТА
short_name Краткое наименование + ООО РИК
address Адрес + Москва, Тверская, 14
inn ИНН -1 1234567890
ogrn ОГРН -1 1234567890123
ogrn_date Дата выдачи ОГРН - 2003-03-15
phone Телефон + +79998887766
email Электронная почта + mail@example.com

1 - обязательно должен присутствовать только один из элементов

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

Информация о контролируемом лице - Иностранное физическое лицо

Параметр Описание Обязательное Пример
name Имя + Джон
surname Фамилия + Смит
patronymic Отчество -  
address Адрес + Москва, Тверская, 14
phone Телефон + +79998887766
email Электронная почта + mail@example.com
identity_document Документ, удостоверяющий личность -  
nationality Гражданство - Составной элемент Nationality

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

Гражданство

Параметр Описание Обязательное Пример
id Код страны +  
title Название страны +  

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

Информация о контролируемом лице - Иностранное юридическое лицо

Параметр Описание Обязательное Пример
full_name Полное наименование + Meta inc
short_name Краткое наименование + Meta inc

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

Информация о контролируемом лице - Филиал иностранного юридического лица

Параметр Описание Обязательное Пример
full_name Полное наименование + ООО Майкрософт
short_name Краткое наименование + ООО Майкрософт
address Адрес + Москва, Тверская, 14
accreditation_number Номер аккредитации -1  
accreditation_date Дата выдачи аккредитации -  
inn ИНН -1  
kpp КПП -  
phone Телефон + +79998887766
email Электронная почта + mail@example.com

1 - обязательно должен присутствовать только один из элементов

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

Параметр Описание Обязательное Пример
responses Информация о результате запроса + Массив составных элементов Response

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

Информация о результате запроса

Параметр Описание Обязательное Пример
success Сообщение об успешном добавлении -1 Составной элемент Success
error Сообщение об ошибке -1 Составной элемент Error

1 - обязательно должен присутствовать только один из элементов

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

Сообщение об успешном добавлении

Параметр Описание Обязательное Пример
external_id Идентификатор добавленного объекта + 123eee1231
ervk_id Идентификатор добавленного объекта в ЕРВК + 4420582

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

Сообщение об ошибке

Параметр Описание Обязательное Пример
error_type Тип ошибки:
404 - изменяемая/удаляемая запись не найдена
400 - ошибка в запросе с описанием ошибки (при ошибочных значениях типов, видов, подвидов, неправильно заполненных полях, отсутствии элемента ervkId для действия delete или objectId для add/edit
409 - статус объекта вида контроля не PUBLISHED. Данные рассинхронизированы
500 - непредвиденная ошибка
+ 500
error_description Описание ошибки +  
external_id Идентификатор добавляемого объекта + 123eee1231

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "records": [
    {
      "action": "ADD",
      "object_data": {
        "external_id": "123eee1231",
        "control_object": {
          "name": "АО Овощная база",
          "address": "г Москва, ул Ивана Ивановича, д 1"
        },
        "supervision": {
          "code": "094",
          "title": "Региональный государственный лицензионный контроль за осуществлением предпринимательской деятельности по управлению многоквартирными домами",
          "record_id": "0af4cd2e-78cb-109b-8178-e981360303e8"
        },
        "control_organ": {
          "code": "00007",
          "title": "Министерство Московской области по илищно-коммунальному хозяйству",
          "ogrn": "51177460267511",
          "record_id": "0af4cd2e-78cb-109b-8178-e92043eb0072"
        },
        "risk_category": {
          "code": "6",
          "title": "низкий риск"
        },
        "object_subspec": {
          "record_id": "0ae94710-7ff4-1fce-817f-f833f4bd01ef",
          "title": "деятельность по осуществлению работ по капитальному ремонту, ремонту и содержанию автомобильных дорог общего пользования местного значения и искусственных дорожных сооружений на них",
          "analogue": true,
          "object_spec": {
            "record_id": "0ae94710-7ff4-1fce-817f-f833f4bd01ef",
            "title": "деятельность по осуществлению работ по капитальному ремонту, ремонту и содержанию автомобильных дорог общего пользования местного значения и искусственных дорожных сооружений на них",
            "object_type": {
              "record_id": "0af4cd2e-78cb-109b-8178-ea2e8d46040d",
              "title": "Деятельность и действия"
            }
          }
        },
        "legal_entities": {
          "legal_entity_fl": [
            {
              "name": "Иван",
              "surname": "Иванов",
              "patronymic": "Иванович",
              "address": "Москва, Тверская, 14",
              "inn": "123456789021",
              "snils": "123-456-789 00",
              "phone": "+79998887766",
              "email": "ervk@mail.ru"
            }
          ],
          "legal_entity_ip": [
            {
              "name": "Иван",
              "surname": "Иванов",
              "address": "Иванович",
              "phone": "+79998887766",
              "email": "mail@example.com",
              "inn": "123456789012",
              "ogrn": "323456789012345"
            }
          ],
          "legal_entity_ul": [
            {
              "full_name": "ООО РОГА И КОПЫТА",
              "short_name": "ООО РИК ",
              "address": "Москва, Тверская, 14",
              "phone": "+79998887766",
              "email": "mail@example.com",
              "inn": "1234567890",
              "ogrn": "1234567890123"
            }
          ],
          "legal_entity_ifl": [
            {
              "name": "Джон",
              "surname": "Смит",
              "address": "Москва, Тверская, 14",
              "phone": "+79998887766",
              "email": "mail@example.com"
            }
          ],
          "legal_entity_iul": [
            {
              "full_name": "Meta inc",
              "short_name": "Meta inc"
            }
          ],
          "legal_entity_iul_branches": [
            {
              "full_name": "ООО Майкрософт",
              "short_name": "ООО Майкрософт",
              "address": "Москва, Тверская, 14",
              "phone": "+79998887766",
              "email": "mail@example.com"
            }
          ]
        }
      }
    }
  ]
}

В случае корректной настройки должен прийти следующий ответ:

{
  "responses": [
    {
      "success": {
        "external_id": "123eee1231",
        "ervk_id": "4420582"
      }
    }
  ]
}