Коэффициент бонус-малус (КБМ)

P.0137.KBM.ACT

Отдаёт коэффициент бонус-малус (КБМ) физлица.

Эта система тарифных коэффициентов обычно применяется в страховом бизнесе как один из параметров определения размера страховой премии, которую платит клиент страховщику. КБМ учитывает стаж и ДТП по вине физлица и по сути является скидкой за безаварийную езду.

На основании КБМ в ряде случаев можно условно оценить благонадёжность водителя.

Идентификаторы объекта: ФИО, дата рождения, серия и номер ВУ. Дополнительно может быть указана дата, на которую запрашивается КБМ (по умолчанию используется дата запроса).

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

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

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

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

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

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
last_name string Обязательный Фамилия
first_name string Обязательный Имя
patronymic string Обязательный Отчество.
В случае отсутствия отчества указывается -
birth string Обязательный Дата рождения
driver_license string Обязательный Серия и номер ВУ
kbm_date string Необязательный Дата, на которую запрашивается КБМ, в формате YYYY-DD-MM или DD.MM.YYYY

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

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "last_name": "Иванов",
    "first_name": "Иван",
    "patronymic": "Иванович",
    "birth": "10.10.1970",
    "driver_license": "0000 123456",
    "kbm_date": "2020-01-01"
  }
}

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

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

Поле Тип Описание
kbm_date string Дата КБМ в формате YYYY-DD-MM
kbm_value number Численное значение КБМ
kbm_class string Класс КБМ (вычисляется согласно соответствующим таблицам ОСАГО на 01.04.2022)
accidents[].date string Дата страхового случая в формате YYYY-DD-MM hh:mm:ss
accidents[].policy_serial string Серия полиса ОСАГО
accidents[].policy_number string Номер полиса ОСАГО
accidents[].insurer_name string Название страховой компании

Наличие блока accidents[] (страховые случаи) в отчёте регулируется дополнительными настройками по запросу и зависит от условий заключённого договора.

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

{
  "data": [
    {
      "report_type_uid": "P.0137.KBM.ACT_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/kbm_osago",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "kbm_osago": {
            "items": [
              {
                "kbm_date": "2020-01-01",
                "kbm_value": 1.55,
                "kbm_class": "1"
              }
            ]
          }
        }
      }
    }
  ]
}

Пример отчёта с данными ДТП и ОСАГО

{
  "data": [
    {
      "report_type_uid": "P.0137.KBM.ACT_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/kbm_osago",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "kbm_osago": {
            "items": [
              {
                "kbm_date": "2020-01-01",
                "kbm_value": 1.55,
                "kbm_class": "1",
                "accidents": [
                  {
                    "date": "2018-02-19 10:00:00",
                    "policy_serial": "EXP",
                    "policy_number": "1000000001",
                    "insurer_name": "Страховое публичное акционерное общество Ингосстрах"
                  },
                  {
                    "date": "2018-02-26 10:00:00",
                    "policy_serial": "EXP",
                    "policy_number": "1000000002",
                    "insurer_name": "Страховое публичное акционерное общество Ингосстрах"
                  }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}