Запрос паспортного досье по установочным данным или по реквизитам документа

smev3 link

smev manual

Атрибут Значение
Название mvd-passport-full-by-person-doc
Наименование Запрос паспортного досье по установочным данным или по реквизитам документа
Тип Адаптер для СМЭВ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

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

Параметр Описание Обязательное Пример
document Реквизиты запрашиваемого документа -1 Cоставной элемент DocumentRequest
person_data_request Реквизиты установочных данных -1 Cоставной элемент PersonDataRequest

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

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

Реквизиты запрашиваемого документа

Параметр Описание Обязательное Пример
type Тип + РП
series Серия + 4512
number Номер + 123456

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

Реквизиты установочных данных

Параметр Описание Обязательное Пример
fio ФИО физического лица + Cоставной элемент FIO
birth_date Дата рождения - Cоставной элемент BirthDate
snils СНИЛС - 76679429583
inn ИНН - 277647632497

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

ФИО физического лица

Параметр Описание Обязательное Пример
name Фамилия + Максим
surname Имя + Буднев
patronymic Отчество - Федорович

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

Дата рождения

Параметр Описание Обязательное Пример
full_birth_date Полная дата рождения -1 1957-08-13
year_birth_date Год рождения -1 1957
month Месяц -1 02
year Год -1 1957

1 - обязательно должен присутствовать только элемент(ы): (full_birth_date) или (year_birth_date) или (month и year)

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

Параметр Описание Обязательное Пример
rejection Ошибки или результаты проверки -1 Cоставной элемент Rejection
persons Реквизиты физического лица -1 Cоставной элемент Persons

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

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

Ошибки или результаты проверки

Параметр Описание Обязательное Пример
code Код возврата + ABSENT
description Описание возврата +  

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

Реквизиты физического лица

Параметр Описание Обязательное Пример
person_passport_full Паспортное досье ФЛ + Массив (1..unbounded) составных элементов PersonPassportFull

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

Паспортное досье ФЛ

Параметр Описание Обязательное Пример
person_id Идентификатор физического лица + 213574669700170832
passport_full Паспортное досье + Массив (1..unbounded) составных элементов PassportFull
comment Комментарий -  

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

Паспортное досье

Параметр Описание Обязательное Пример
person_data_doc   + Cоставной элемент PersonDataDoc

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

Паспортное досье

Параметр Описание Обязательное Пример
person_data Установочные данные + Cоставной элемент PersonData
document Документы + Cоставной элемент Document

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

Установочные данные

Параметр Описание Обязательное Пример
fio ФИО физического лица + Cоставной элемент FIO
sex Пол - Male
birth_date Дата рождения - Cоставной элемент BirthDate
birth_place Место рождения - Cоставной элемент BirthPlace
snils СНИЛС - 76679429583
inn ИНН - 277647632497

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

Место рождения

Параметр Описание Обязательное Пример
birth_country Страна рождения +  
birth_place_unstructured Место рождения +  

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

Документы

Параметр Описание Обязательное Пример
passport_rf Паспорт гражданина РФ -1 Cоставной элемент PassportRF
soviet_passport Паспорт гражданина CCCP -1 Cоставной элемент SovietPassport
international_passport_rf Заграничный паспорт гражданина РФ -1 Cоставной элемент InternationalPassportRF

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

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

Паспорт гражданина РФ

Параметр Описание Обязательное Пример
passport_rf Паспорт гражданина РФ + Cоставной элемент PassportData
issuer_index Кем выдан. Код подразделения + 001-002
doc_status Статус документа + 300
invalidity Сведения о недействительности. Обязательно, если статус "Недействителен" - Cоставной элемент Invalidity

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

Паспорт гражданина CCCP

Параметр Описание Обязательное Пример
soviet_passport Паспорт гражданина CCCP + Cоставной элемент PassportData
doc_status Статус документа + 300
invalidity Сведения о недействительности. Обязательно, если статус "Недействителен" - Cоставной элемент Invalidity

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

Заграничный паспорт гражданина РФ

Параметр Описание Обязательное Пример
international_passport_rf Заграничный паспорт гражданина РФ + Cоставной элемент PassportData
issuer_index Кем выдан. Код подразделения + 001-002
doc_status Статус документа + 300
invalidity Сведения о недействительности. Обязательно, если статус "Недействителен" - Cоставной элемент Invalidity

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

Паспортные данные

Параметр Описание Обязательное Пример
series Серия + 4512
number Номер + 123456
issue_date Дата выдачи + 2003-08-13
issuer Кем выдан + ГУ МВД по г. Москве

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

Сведения о недействительности

Параметр Описание Обязательное Пример
date_from   + 1957-08-13
reason   + 607"

Примеры

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

{
  "document": {
    "type": "РП",
    "series": "4512",
    "number": "123456"
  }
}

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

{
  "persons": {
    "person_passport_full": [ 
      {
        "person_id": "213574669700170832",
        "passport_full": [
          {
            "person_data_doc": {
              "person_data": {
                "fio": {
                  "name": "Максим",
                  "surname": "Буднев",
                  "patronymic": "Федорович"
                },
                "sex": "Male",
                "birth_date": {
                  "full_birth_date": "1957-08-13"
                },
                "snils": "76679429583",
                "inn": "277647632497"
              },
              "document": {
                "passport_rf": {
                  "passport_rf": {
                    "series": "4512",
                    "number": "123456",
                    "issue_date": "2003-08-13",
                    "issuer": "ГУ МВД по г. Москве"
                  },
                  "issuer_index": "001-002",
                  "doc_status": "300"
                }
              }
            }
          }
        ]
      }
    ]
  }
}