Перейти к содержанию

Проверки по Базам данных

Данные проверок по Базам данных доступны в документах по ключу external_integrations

Проверка действительности паспорта РФ на Госуслугах

Для документов:

  • PASSPORT - Паспорт гражданина РФ (2 и 3 страницы)
  • PASSPORT_REG - Паспорт гражданина РФ (2 и 3 страницы) + регистрация

Проверка производится только в том случае, если в процессе обработки документа были найдены и не являются пустыми поля:

  • Series - Серия
  • Number - Номер
  • LastName - Фамилия
  • FirstName - Имя

Для включения проверки в обработку документа необходимо в запросе на отправку документа

по ключу process_info указать следующую структуру

"stages": ["external_sites_check"],
"stages_settings": {
    "external_sites_check": {
        "list": [
            "gosuslugi"
        ]
    }
},

Пример тела запроса:

{
  "project_id": "U_RATE_3",
  "images": ["<строка base64>"],
  "process_info": [
    {
      "key": "PASSPORT",
      "type": "PASSPORT",
      "options": {
        "stages": ["verification", "external_sites_check"],
        "stages_settings": {
            "external_sites_check": {
                "list": [
                    "gosuslugi"
                ]
            }
        }
      }
    }
  ],
  "token": "<token>",
  "machine_uid": "<machine_uid>"
}

В результате проверки в ответе отобразится структура по ключу gosuslugi:

"gosuslugi": {
    "status": 1,
    "comment": "Valid"
}


Расшифровка результата проверки gosuslugi:

Ключ Описание Значение Расшифровка
status статуc проверки
0 Недействительный
1 Действительный
2 Недостаточно данных
3 Сервис недоступен
comment краткий комментарий о проверке
Invalid Недействительный
Valid Действительный
Data not found Недостаточно данных
Service unavailable Сервис недоступен

Проверка действительности водительского удостоверения РФ на Госуслугах

Для документов:

  • DLIC - Водительское удостоверение РФ

Проверка производится только в том случае, если в процессе обработки документа были найдены и не являются пустыми поля:

  • SeriesFront - Серия (лицевая сторона)
  • NumberFront - Номер (лицевая сторона)
  • LastName - Фамилия
  • FirstName - Имя
  • ModdleName - Отчество
  • BirthDate - Дата рождения

Для включения проверки в обработку документа необходимо в запросе на отправку документа

по ключу process_info указать следующую структуру

"stages": ["external_sites_check"],
"stages_settings": {
    "external_sites_check": {
        "list": [
            "gosuslugi"
        ]
    }
},

Пример тела запроса:

{
  "project_id": "U_RATE_3",
  "images": ["<строка base64>"],
  "process_info": [
    {
      "key": "DLIC",
      "type": "DLIC",
      "options": {
        "stages": ["verification", "external_sites_check"],
        "stages_settings": {
            "external_sites_check": {
                "list": [
                    "gosuslugi"
                ]
            }
        }
      }
    }
  ],
  "token": "<token>",
  "machine_uid": "<machine_uid>"
}

В результате проверки в ответе отобразится структура по ключу gosuslugi:

"gosuslugi": {
    "status": 1,
    "comment": "Valid"
}


Расшифровка результата проверки gosuslugi:

Ключ Описание Значение Расшифровка
status статуc проверки
0 Лишение
1 Действующее
2 Аннулировано/Недействительно
3 Данные не найдены
4 Сервис недоступен
comment краткий комментарий о проверке
Revocation Недействительный
Valid Действительный
Canceled or invalid Аннулировано/Недействительно
Data not found Данные не найдены
Service unavailable Сервис недоступен

Проверка по базе террористов и экстремистов

Для документов:

  • PASSPORT - Паспорт гражданина РФ (2 и 3 страницы)
  • PASSPORT_REG - Паспорт гражданина РФ (2 и 3 страницы) + регистрация
  • DLIC - Водительское удостоверение

Проверка производится только в том случае, если в процессе обработки документа были найдены и не являются пустыми поля:

  • FirstName - Фамилия
  • LastName - Имя
  • MiddleName - Отчество
  • BirthDate - Дата рождения

Доступна проверка на наличие в базе террористов и экстремистов

Данные по проверке отображаются по ключу terrorist_extremist

Если физическое лицо находится в списке террористов и экстремистов, то

terrorist_extremist.value будет иметь значение true,

В противном случае значение false

Например:

"terrorist_extremist": {
    "value": false
}

Получение ИНН по паспорту РФ

Для документов:

  • PASSPORT - Паспорт гражданина РФ (2 и 3 страницы)
  • PASSPORT_REG - Паспорт гражданина РФ (2 и 3 страницы) + регистрация

Проверка производится только в том случае, если в процессе обработки документа были найдены и не являются пустыми поля:

  • FirstName - Фамилия
  • LastName - Имя
  • MiddleName - Отчество
  • BirthDate - Дата рождения
  • Series - Серия документа
  • Number - Сомер документа

Доступно автоматическое подтягивание ИНН

Данные отображаются по ключу inn inn.value будет иметь значение соответствующее номеру ИНН физического лица.

Если ИНН не найден, inn.value будет иметь значение пустой строки

Например:

"inn": {
    "value": "54020115506"
}

Проверка по санкционным спискам и реестру иностранных агентов

Проверка физического лица по ФИО и дате рождения в списках:

Код проверки Список
eu_sanctions Санкционный список Европейского союза
un_consolidated_list Сводный санкционный перечень Совета Безопасности ООН
ofac Санкционный список OFAC SDN (Минфин США)
foreign_agent Реестр иностранных агентов Минюста России

Списки обновляются ежедневно.

Для документов:

  • PASSPORT - Паспорт гражданина РФ (2 и 3 страницы)
  • PASSPORT_REG - Паспорт гражданина РФ (2 и 3 страницы) + регистрация
  • PASSPORT_FRGN - Паспорт иностранного гражданина
  • ID_CARD - ID карта
  • FPRN - Заграничный паспорт гражданина РФ

Проверка производится только в том случае, если в процессе обработки документа были найдены и не являются пустыми поля:

  • LastName - Фамилия
  • FirstName - Имя
  • BirthDate - Дата рождения

Отчество (MiddleName) необязательно: если оно есть, учитывается при поиске.

Если одного из обязательных полей нет, проверка не выполняется, в результате будет status_code 2 (недостаточно данных).

ФИО может быть на кириллице или на латинице: имена ищутся с учетом транслитерации (в том числе по правилам, принятым для загранпаспортов). Порядок слов в ФИО не важен.

Для включения проверки в обработку документа необходимо в запросе на отправку документа

по ключу process_info указать следующую структуру (в list - только нужные проверки)

"stages": ["external_sites_check"],
"stages_settings": {
    "external_sites_check": {
        "list": [
            "eu_sanctions",
            "foreign_agent",
            "ofac",
            "un_consolidated_list"
        ]
    }
},

Пример тела запроса:

{
  "project_id": "U_RATE_3",
  "images": ["<строка base64>"],
  "process_info": [
    {
      "key": "FPRN",
      "type": "FPRN",
      "options": {
        "stages": ["external_sites_check"],
        "stages_settings": {
            "external_sites_check": {
                "list": [
                    "eu_sanctions",
                    "foreign_agent",
                    "ofac",
                    "un_consolidated_list"
                ]
            }
        }
      }
    }
  ],
  "token": "<token>",
  "machine_uid": "<machine_uid>"
}

Проверку можно включить и в режиме обработки текстовых данных: ФИО и дата рождения передаются в data.

В результате проверки в ответе отобразятся структуры по ключам проверок из list:

"foreign_agent": {
    "value": false,
    "status_code": 1,
    "comment": "Found in the register of foreign agents"
},
"eu_sanctions": {
    "value": true,
    "status_code": 0,
    "comment": "Not found in the EU sanctions list"
},
"ofac": {
    "value": true,
    "status_code": 0,
    "comment": "Not found in the OFAC SDN list"
},
"un_consolidated_list": {
    "value": null,
    "status_code": 2,
    "comment": "Check not performed: required document data is missing or invalid"
}


Расшифровка результата проверки:

Ключ Описание Значение Расшифровка
value проверка пройдена
true Не найден в списке
false Найден в списке
null Проверка не выполнена (недостаточно данных или список недоступен)
status_code статус проверки
0 Не найден
1 Найден
2 Недостаточно данных
3 Сервис недоступен
comment краткий комментарий о проверке (на английском)
Found in ... Найден в списке
Not found in ... Не найден в списке
Excluded from the register of foreign agents Был в реестре иностранных агентов, исключен (value: true)
... (possible match: name matches, no date of birth in the list) Возможное совпадение: ФИО совпадает, дата рождения в списке не указана (value: false)
Check not performed: required document data is missing or invalid Недостаточно данных
Check not performed: ... is unavailable Сервис недоступен

Названия списков в comment:

Код проверки Название в comment
eu_sanctions the EU sanctions list
un_consolidated_list the UN Security Council consolidated list
ofac the OFAC SDN list
foreign_agent the register of foreign agents