Предоставление регистрационного досье о регистрации граждан РФ

smev3 link

smev manual

Атрибут Значение
Название mvd-reg-dossier
Наименование Предоставление регистрационного досье о регистрации граждан РФ
Тип Адаптер для СМЭВ3 сервиса
Версия СМЭВ СМЭВ3
Версия ВС 2.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

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

Параметр Описание Обязательное Пример
address_type Тип регистрации -  
person_data Установочные данные запрашиваемого лица + Составной элемент PersonData
person_document Документ, удостоверяющий личность + Составной элемент PersonDocument

Тип регистрационного учета:
2417602575411976106 - Регистрация по месту пребывания
2417603178217346987 - Регистрация по месту жительства

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

Установочные данные запрашиваемого лица

Параметр Название Обязательное Пример
surname Фамилия ФЛ + Петров
name Имя ФЛ + Иван
patronymic Отчество ФЛ - Алексеевич
birthday Дата рождения ФЛ - 1989-10-25

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

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

Параметр Название Обязательное Пример
doc_type Тип документа + 21
doc_series Серия документа - 6258
doc_no Номер документа + 789642

Тип документа:
21 - Паспорт гражданина РФ
03 - Свидетельство о рождении
22 - Заграничный паспорт гражданина РФ (старого или нового образца)
23 - Иностранное свидетельство о рождении

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

Параметр Описание Обязательное Пример
address_type Тип регистрации - 2417602575411976106
person_info Документ, по которому проходила постановка на учет - Составной элемент RegDoc
dossier_item Адреса регистрационного учета - Массив составных элементов RegAddress
attachments Данные, необходимые для получения вложений + Массив составных элементов AggredatorAttachment. Поле обязательно присутствует, но может быть пустым.

Тип адреса регистрационного учета:
2417602575411976106 - Регистрация по месту пребывания
2417603178217346987 - Регистрация по месту жительства

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

Документ, по которому проходила постановка на учет

Параметр Название Обязательное Пример
surname Фамилия ФЛ + Петров
name Имя ФЛ + Иван
patronymic Отчество ФЛ - Алексеевич
doc_type Тип документа + 21
doc_series Серия документа - 6258
doc_no Номер документа + 789642
issue_dt Дата выдачи - 1957-08-13
birthday Дата рождения ФЛ - 1957-08-13

Тип документа:
21 - Паспорт гражданина РФ
03 - Свидетельство о рождении
22 - Заграничный паспорт гражданина РФ (старого или нового образца)
23 - Иностранное свидетельство о рождении

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

Адрес регистрационного учета

Параметр Название Обязательное Пример
from_dt Начало регистрации + 2021-10-30
to_dt Окончание регистрации - 2021-11-27
full_address Адрес регистрации - обл Курганская, р-н Куртамышский, г Куртамыш, ул Курганская, д. 34А
address_type Тип регистрации - 2417602575411976106

Структура элемента 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

Примеры

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

{
  "person_data": {
    "surname": "Петров",
    "name": "Иван",
    "patronymic": "Алексеевич",
    "birthday": "1989-10-25"
  },
  "person_document": {
    "doc_type": "21",
    "doc_series": "6258",
    "doc_no": "789642"
  }
}

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

{
  "person_info": {
    "surname": "Петров",
    "name": "Иван",
    "patronymic": "Алексеевич",
    "doc_type": "21",
    "doc_series": "6258",
    "doc_no": "789642",
    "birthday": "1989-10-25"
  },
  "dossier_item": [
    {
      "from_dt": "2021-10-30",
      "to_dt": "2021-11-27",
      "full_address": "обл Курганская, р-н Куртамышский, г Куртамыш, ул Курганская, д. 34А",
      "address_type": "2417602575411976106"
    },
    {
      "from_dt": "2021-09-16",
      "full_address": "обл Курганская, р-н Куртамышский, г Куртамыш, ул Кутузова, д. 25",
      "address_type": "2417603178217346987"
    }
  ],
   "attachments": []
}