Подтверждение владения ТС физлицом или организацией

A.0076.CAR.ACT-ALL

Позволяет верифицировать владение физического или юридического лица конкретным автомобилем.

Идентификаторы объекта: идентификатор ТС и данные проверяемого лица: ФИО + дата рождения или серия и номер паспорта или ИНН юрлица. В качестве идентификатора ТС могут использоваться ГРЗ, VIN или номер кузова.

ФИО и дата рождения, серия и номер паспорта могут передаваться в открытом или хешированном виде. Для хеширования данных используется алгоритм MD5. Правила хеширования идентификаторов

Иcпользуемые источники: check_person/z3m_vehicle_validator или check_person/z3m_vehicle_validator_by_grz.

Эти источники используют для поиска разные идентификаторы ТС:

  • check_person/z3m_vehicle_validator принимает VIN или номер кузова;
  • check_person/z3m_vehicle_validator_by_grz принимает только ГРЗ.

Время генерации отчёта:

  • 50-й перцентиль — 2 с;
  • 95-й перцентиль — 5 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
fio_birth_hash string Обязательный,
если не указан другой идентификатор владельца		 Хеш MD5 ФИО и даты рождения
passport_hash string Обязательный,
если не указан другой идентификатор владельца		 Хеш MD5 серии и номера паспорта
last_name string Обязательный,
если не указан другой идентификатор владельца		 Фамилия физлица
first_name string Обязательный,
если не указан другой идентификатор владельца		 Имя физлица
patronymic string Обязательный,
если не указан другой идентификатор владельца		 Отчество физлица.
Может не указываться только в случае реального отсутствия отчества
birth string Обязательный,
если не указан другой идентификатор владельца		 Дата рождения физлица
passport string Обязательный,
если не указан другой идентификатор владельца		 Серия и номер паспорта физлица
inn string Обязательный,
если не указан другой идентификатор владельца		 ИНН юридического лица
vin string Обязательный
для check_person/z3m_vehicle_validator,
если не указан номер кузова		 VIN
body string Обязательный
для check_person/z3m_vehicle_validator,
если не указан VIN		 Номер кузова ТС
grz string Обязательный
для check_person/z3m_vehicle_validator_by_grz		 ГРЗ

В запросе, помимо идентификатора ТС (VIN, номер кузова или ГРЗ в зависимости от источника), достаточно передавать только один из наборов данных лица:

  • fio_birth_hash,
  • passport_hash,
  • last_name, first_name, patronymic и birth,
  • passport,
  • inn.

Если запрос содержит несколько наборов, то для поиска будет использоваться один из них, выбираемый в указанном порядке.

Пример тела запроса по ФИО, дате рождения и VIN

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "last_name": "Иванов",
    "first_name": "Иван",
    "patronymic": "Иванович",
    "birth": "01.01.2000",
    "vin": "EXAMPL0V1N1000000"
  }
}

Пример тела запроса по хешу серии и номера паспорта и VIN

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "passport_hash": "8e759d3de6096029b95b4a715e57e7e9",
    "vin": "EXAMPL0V1N1000000"
  }
}

Пример тела запроса по ИНН и ГРЗ

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "inn": "1234567890",
    "grz": "А111АА00"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.check_person.vehicle_validator тела ответа.

Поле Тип Описание
ownedStatus string Статус владения.
Справочник значений

Справочник Статус владения ТС

Значение Описание
OWN Владеет
OWNED_BEFORE Владел раньше
NOT_OWN Не владеет
UNKNOWN Неизвестный статус

Пример данных отчёта от z3m_vehicle_validator

{
  "data": [
    {
      "report_type_uid": "A.0076.CAR.ACT-ALL_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/z3m_vehicle_validator",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "vehicle_validator": {
            "ownedStatus": "OWNED_BEFORE"
          }
        }
      }
    }
  ]
}

Пример данных отчёта от z3m_vehicle_validator_by_grz

{
  "data": [
    {
      "report_type_uid": "A.0076.CAR.ACT-ALL_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/z3m_vehicle_validator_by_grz",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "vehicle_validator": {
            "ownedStatus": "OWNED_BEFORE"
          }
        }
      }
    }
  ]
}