Сведения о действительности паспорта гражданина Российской Федерации, предъявленного на определённое имя
| Атрибут | Значение |
|---|---|
| Название | mvd-passport-validity |
| Тип | Адаптер для межведомственного взаимодействия |
| Наименование | Сведения о действительности паспорта гражданина Российской Федерации, предъявленного на определённое имя |
| Назначение | Сервис проверки установочных данных (ФИО, дата рождения) с паспортными данными (серия, номер, дата выдачи) |
| Область применения | Межведомственное взаимодействие |
| Версия ВС | 1.2.0 |
| Версия МР | 3.4.0.4 |
| Версия СМЭВ | СМЭВ3 |
| Поставщик | Министерство внутренних дел Российской Федерации |
| Потребители | Доступ предоставляется по согласованию с владельцем вида сведений |
Подключение потребителей к поставщику вида сведений
Доступ предоставляется по согласованию с владельцем вида сведений.
Переменные окружения
| Название | Описание |
|---|---|
| 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.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| pass_series | Серия паспорта | + | 7866 |
| pass_number | Номер паспорта | + | 666666 |
| pass_issue_date | Дата выдачи паспорта | - | 2010-10-10 |
| pass_issuer_code | Код выдавшего подразделения | - | 666666 |
| surname | Фамилия | + | Иван |
| name | Имя | + | Иванов |
| patronymic | Отчество | - | Иванович |
| birthdate | Дата рождения | + | 2010-10-10 |
| birthplace | Место рождения | - | г. Москва |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| valid | Флаг успешности проверки. Равен true, только если был получен ответ о соответствии данных, в остальных случаях равен false | + | true |
| not_found | Флаг отсутствия данных о паспорте | - | true |
| code | Код результата выполнения запроса. Принимает значения VALID, INVALID | + | VALID |
| description | Описание результата выполнения запроса | + | Данные корректны |
| invalid_doc | Данные о недействительности паспорта | - | Составной элемент InvalidDoc |
Структура элемента InvalidDoc
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| invalidity_reason | Причина недействительности паспорта | + | Значение из справочника InvalidityReason |
| invalidity_date | Дата регистрации недействительности паспорта | + | 2001-01-01 |
Справочник InvalidityReason
| Код | Описание |
|---|---|
| 601 | Истёк срок действия |
| 602 | Заменен на новый |
| 603 | Выдан с нарушением |
| 604 | Числится в розыске |
| 605 | Изъят, уничтожен |
| 606 | В связи со смертью владельца |
| 607 | Технический брак |
| 609 | Утрачен |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.
Пример 1
Запрос
{
"pass_series": "7866",
"pass_number": "666666",
"pass_issue_date": "2010-10-10",
"pass_issuer_code": "666666",
"surname": "Иванов",
"name": "Иван",
"patronymic": "Иванович",
"birthdate": "1993-03-05",
"birthplace": "г. Москва"
}
Корневой xml-документ вида сведений для этого случая (в результате выполнения которого будет получен ответ «Данные корректны»):
<ns:passportValidityExtendedRequest xmlns:ns="urn://mvd/guvm/passport-validity-extended/1.2.0"
xmlns:bt="urn://mvd/guvm/basic-types/1.1.0">
<ns:personInfo>
<bt:lastName>Иванов</bt:lastName>
<bt:firstName>Иван</bt:firstName>
<bt:middleName>Иванович</bt:middleName>
<bt:birthDate>1993-03-05</bt:birthDate>
<bt:birthPlace>г. Москва</bt:birthPlace>
</ns:personInfo>
<ns:russianPassport>
<bt:series>7866</bt:series>
<bt:number>666666</bt:number>
<ns:issueDate>2010-10-10</ns:issueDate>
<ns:issuerCode>666666</ns:issuerCode>
</ns:russianPassport>
</ns:passportValidityExtendedRequest>
Ответ:
{
"code": "VALID",
"valid": true,
"description": "Данные корректны"
}
Пример 2
Запрос
{
"pass_series": "7801",
"pass_number": "601601",
"pass_issue_date": "2010-10-10",
"pass_issuer_code": "666666",
"surname": "Иванов",
"name": "Иван",
"patronymic": "Иванович",
"birthdate": "1993-03-05"
}
Корневой xml-документ вида сведений для этого случая (в результате выполнения которого будет получен ответ «Паспорт недействителен»):
<ns:passportValidityExtendedRequest xmlns:ns="urn://mvd/guvm/passport-validity-extended/1.2.0"
xmlns:bt="urn://mvd/guvm/basic-types/1.1.0">
<ns:personInfo>
<bt:lastName>Иванов</bt:lastName>
<bt:firstName>Иван</bt:firstName>
<bt:middleName>Иванович</bt:middleName>
<bt:birthDate>1993-03-05</bt:birthDate>
</ns:personInfo>
<ns:russianPassport>
<bt:series>7801</bt:series>
<bt:number>601601</bt:number>
<ns:issueDate>2010-10-10</ns:issueDate>
<ns:issuerCode>666666</ns:issuerCode>
</ns:russianPassport>
</ns:passportValidityExtendedRequest>
Ответ:
{
"code": "INVALID",
"valid": false,
"invalid_doc": {
"invalidity_reason": "601",
"invalidity_date": "2001-01-01"
},
"description": "601 - Истек срок действия"
}
Пример 3
Запрос
{
"pass_series": "7844",
"pass_number": "404404",
"pass_issue_date": "2014-10-14",
"pass_issuer_code": "666666",
"surname": "Иванов",
"name": "Иван",
"patronymic": "Иванович",
"birthdate": "1993-03-05"
}
Корневой xml-документ вида сведений для этого случая (в результате выполнения которого будет получен ответ «Сведения о паспорте отсутствуют»):
<ns:passportValidityExtendedRequest xmlns:ns="urn://mvd/guvm/passport-validity-extended/1.2.0"
xmlns:bt="urn://mvd/guvm/basic-types/1.1.0">
<ns:personInfo>
<bt:lastName>Иванов</bt:lastName>
<bt:firstName>Иван</bt:firstName>
<bt:middleName>Иванович</bt:middleName>
<bt:birthDate>1993-03-05</bt:birthDate>
</ns:personInfo>
<ns:russianPassport>
<bt:series>7844</bt:series>
<bt:number>404404</bt:number>
<ns:issueDate>2014-10-14</ns:issueDate>
<ns:issuerCode>666666</ns:issuerCode>
</ns:russianPassport>
</ns:passportValidityExtendedRequest>
Ответ:
{
"code": "INVALID",
"valid": false,
"not_found": true,
"description": "Сведения о паспорте отсутствуют"
}