МВД РОИВ ФОИВ

Проверка регистрации ИГ (ЛБГ) по месту жительства

Атрибут	Значение
Название	check-live-address
Наименование	Проверка регистрации ИГ (ЛБГ) по месту жительства
Тип	Адаптер для СМЭВ3 сервиса
Версия СМЭВ	СМЭВ3
Версия ВС	1.0.0
Версия МР	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_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

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

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

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

Параметр	Описание	Обязательное	Пример
initiator	Данные об инициаторе запроса	+	Составной элемент Initiator
request_data	Бизнес-данные запроса	+	Составной элемент RequestData

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

Данные об инициаторе запроса

Параметр	Описание	Обязательное	Пример
organization	Код запрашивающего ФОИВ/РОИВ (правила заполнения см. в Руководстве пользователя ВС)	+	"10000001022"
person	Ответственное лицо	+	Составной элемент Person

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

Ответственное лицо

Параметр	Описание	Обязательное	Пример
id	Идентификатор ответственного лица	-	"4713967"
surname	Фамилия	+	"Добров"
name	Имя	+	"Михаил"
patronymic	Отчество	-	"Георгиевич"

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

Бизнес-данные запроса

Параметр	Описание	Обязательное	Пример
surname	Фамилия	+	"Кириллов"
name	Имя	+	"Эрик"
patronymic	Отчество	-	"Филатович"
latin_surname	Фамилия (латиница)	+	"Kirillov"
latin_name	Имя (латиница)	+	"Erik"
latin_patronymic	Отчество (латиница)	+	"Filatovich"
identity_document	Документ, удостоверяющий личность ИГ (ЛБГ)	+	Составной элемент IdentityDocument
region_code	Код региона запрашивающего органа	-	"39"

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

Документ, удостоверяющий личность ИГ (ЛБГ)

Параметр	Описание	Обязательное	Пример
document_type	Вид документа, удостоверяющего личность ИГ (ЛБГ)	+	"10"
document_id	Идентификатор документа	+	"О5О3473"
document_issue_date	Дата выдачи документа	+	"2008-10-10"
document_country	Государство, выдавшее документ	+	Составной элемент DocumentCountry

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

Государство, выдавшее документ

Параметр	Описание	Обязательное	Пример
code_alfa3		+	"LVA"
short_name		+	"ЛАТВИЯ"

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

Параметр	Описание	Обязательное	Пример
error_response	Ответ в случае возникновения ошибки		Составной элемент ErrorResponse
response_data	Бизнес-данные ответа в случае успешной проверки		Составной элемент ResponseData

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

Ответ в случае возникновения ошибки

Параметр	Описание	Обязательное	Пример
error_code	Код ошибки		"-1"
error_description	Описание ошибки		"Непредвиденная ошибка"

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

Бизнес-данные ответа в случае успешной проверки

Параметр	Описание	Пример
surname	Фамилия	"Кириллов"
name	Имя	"Эрик"
patronymic	Отчество	"Филатович"
latin_surname	Фамилия (латиница)	"Kirillov"
latin_name	Имя (латиница)	"Erik"
latin_patronymic	Отчество (латиница)	"Filatovich"
identity_document	Документ, удостоверяющий личность ИГ (ЛБГ)	Составной элемент IdentityDocument
region_code	Код региона запрашивающего органа	"39"
reg_type	Наличие регистрации	"1"
reg_date	Дата регистрации	"2015-02-24"
reg_address	Адрес регистрации	"152982, Калининградская область, город Чехов, спуск Ленина, 44, кв. 191"
comment	Комментарий

Примеры

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

Сценарий 1.

Запрос

{
  "initiator": {
    "organization": "10000001022",
    "person": {
      "id": "4713967",
      "surname": "Добров",
      "name": "Михаил",
      "patronymic": "Георгиевич"
    }
  },
  "request_data": {
    "surname": "Кириллов",
    "name": "Эрик",
    "patronymic": "Филатович",
    "latin_surname": "Kirillov",
    "latin_name": "Erik",
    "latin_patronymic": "Filatovich",
    "identity_document": {
      "document_type": "10",
      "document_id": "О5О3473",
      "document_issue_date": "2008-10-10",
      "document_country": {
        "code_alfa3": "LVA",
        "short_name": "ЛАТВИЯ"
      }
    },
    "region_code": "39"
  }
}

Ответ

{
  "response_data": {
    "surname": "Кириллов",
    "name": "Эрик",
    "patronymic": "Филатович",
    "latin_surname": "Kirillov",
    "latin_name": "Erik",
    "latin_patronymic": "Filatovich",
    "identity_document": {
      "document_type": "10",
      "document_id": "О5О3473",
      "document_issue_date": "2008-10-10",
      "document_country": {
        "code_alfa3": "LVA",
        "short_name": "ЛАТВИЯ"
      }
    },
    "region_code": "39",
    "reg_type": "1",
    "reg_date": "2015-02-24",
    "reg_address": "152982, Калининградская область, город Чехов, спуск Ленина, 44, кв. 191"
  }
}

Сценарий 2.