Скоринг правовой благонадёжности

• Описание
• Параметры запроса
• Структура отчёта

P.0103.PBS.ACT-SCR

Скоринг правовой благонадёжности представляет собой индекс, или скоринговый балл, позволяющий оценить наличие проблем с законом у физлица.

Для формирования списка исполнительных производств источник получает из реестра не более 500 записей, после чего обрабатывает и фильтрует их для более точного соответствия запросу. Это означает, что для расчёта скоринга всегда будет использоваться не более 500 ИП, даже если в базе ФССП их больше.

Индекс рассчитывается на основе информации ФССП и опирается на маркерные статьи уголовного, административного, гражданского и других кодексов РФ. По экспертной оценке, записи ФССП имеются у 18 % граждан РФ.

Значение индекса правовой благонадёжности учитывает количество исполнительных производств по физлицу, статьи, суммы и время погашения.

Шкала значений индекса:

• 0—20 % — зона высокого риска (красный цвет);
• 21—50 % — зона риска выше среднего (оранжевый цвет);
• 51—90 % — зона риска ниже среднего (жёлтый цвет);
• 91—100 % — зона минимального риска (зелёный цвет).

Преимущество данного блока — высокая скорость ответа, что делает возможным проводить массовые проверки и быстро принимать решение о дальнейшем взаимодействии с человеком.

Источник данных — ФССП России, открытые данные в сети Интернет.

Идентификаторы объекта: ФИО и дата рождения.

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

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

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

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

Различие результатов поиска по идентификаторам в открытом и в хешированном виде

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

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

При поиске по хешу источник гарантированно предоставляет данные ИП, в которых ФИО и дата рождения совпадают с захешированными. Затем алгоритм ищет ИП с учётом возможных опечаток, но результат такого поиска может быть менее полным.

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

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

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

В запросе достаточно передавать только один из наборов данных лица:

• fio_birth_hash,
• last_name, first_name, patronymic, birth.

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

Двойные имена или имена с апострофом

Двойные фамилии, имена, отчества должны записываться через дефис.

Двойные отчества со второй частью ОГЛЫ/КЫЗЫ/УГЛИ могут быть переданы как через дефис, так и через пробел.

В редких случаях, если написание через дефис не помогает, можно попробовать передать первые три слова из ФИО как фамилию, имя и отчество соответственно.

Фамилии с префиксами записываются через апостроф, точку или вообще без префикса.

Пример тела запроса по хешу ФИО и даты рождения

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "fio_birth_hash": "0b10aa099f31839f73974f37b7565613cf705e71214cf2cdc88e8b1814b20251",
  }
}

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

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

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

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

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

{
  "data": [
    {
      "report_type_uid": "P.0103.PBS.ACT-SCR_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/executive_proceeding_base",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "proceeding_v2": {
            "executive_v2": {
              "scoring": {
                "pb_percent": "93",
                "pb_color": "Green"
              }
            }
          }
        }
      }
    }
  ]
}