API восстановления КБМ. Сервис для вебмастеров и страховых агентов

API восстановления КБМ

API по восстановлению коэффициента бонус-малус (КБМ) по базе РСА расположен по адресу https://agent.kbm-pro.ru/API/

Также есть API проверки КБМ — описание доступно по ссылке

API восстановления КБМ поддерживает несколько методов:

  1. Создание заявки на исправление КБМ
  2. Получение текущего состояния сформированной ранее заявки

Перед использованием получите ключ API (кнопка «Получить/изменить ключ API» выше)

API принимает POST-запросы в кодировке UTF8.

Рекомендуем отправлять запросы с помощью библиотеки Curl.

Контакты для связи:

E-mail: support@kbm-pro.ru
Телеграм: @KBM_pro

1. Параметры (ключи) запроса на создание заявки:

  • API — ключ API *
  • fam — Фамилия *
  • im — Имя *
  • otch — Отчество *
  • birthday — Дата рождения (в формате dd.mm.yyyy) *
  • vod — Серия и номер ВУ (в формате ХХХХ ХХХХХХ) *
  • old_vod — Предыдущие серия и номер ВУ (в формате ХХХХ ХХХХХХ) **
  • old_fam — Предыдущая фамилия (не полностью ФИО, а только фамилия)
  • pasp — На какую дату произвести расчёт (в формате dd.mm.yyyy)
  • old_pasp — Комментарий к заказу
  • passport — Серия и номер паспорта (в формате ХХХХ ХХХХХХ)
  • Type — обязателен при подаче заявки на перенос КБМ. Может принимать одно значение — transfer

ВНИМАНИЕ! Параметры, отмеченные знаком * обязательно должны присутствовать в запросе!
Параметры, отмеченные знаком ** обязательны при Type=transfer!

Пример для подачи заявки на восстановление на PHP:

$url = 'https://agent.kbm-pro.ru/API/';
$post_data = array(
	'API'		=> 'ASD!J@U#$^SHA!JAHA',
	'fam'		=> 'Тестов',
	'im'		=> 'Тест',
	'otch'		=> 'Тестович',
	'vod'		=> '0011 223344',
	'birthday'	=> '22.10.1975'
);
$ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, $url);  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  
curl_setopt($ch, CURLOPT_POST, 1);  
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);  
$output = curl_exec($ch);  
curl_close($ch);  
echo $output;

Пример для подачи заявки на перенос на PHP:

$url = 'https://agent.kbm-pro.ru/API/';
$post_data = array(
	'API'		=> 'ASD!J@U#$^SHA!JAHA',
	'fam'		=> 'Тестов',
	'im'		=> 'Тест',
	'otch'		=> 'Тестович',
	'vod'		=> '0011 223344',
	'birthday'	=> '22.10.1975',
	'old_vod'	=> '9988 776655',
	'Type'		=> 'transfer'
);
$ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, $url);  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  
curl_setopt($ch, CURLOPT_POST, 1);  
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);  
$output = curl_exec($ch);  
curl_close($ch);  
echo $output;

На выходе Вы получите данные в формате JSON.

    При успешном запросе в массиве ответа JSON Вы получите два значения:

  • ‘success’ со значением ‘yes’,
  • ‘OrderID’ с номером сформированной заявки

Например, {«success»:»yes»,»OrderID»:3747}

При ошибке в запросе в массиве ответа JSON Вы получите одно значение:

  • ‘error’ с кодом ошибки и её кратким описанием

Например, {«error»:»Code 06. Not enough money for query»}

2. Параметры (ключи) запроса на проверку состояния заявки:

  • API — ключ API *
  • OrderID — номер заявки, полученный при её создании *

ВНИМАНИЕ! Параметры, отмеченные знаком * обязательно должны присутствовать в запросе!
Пример на PHP:

$url = 'https://agent.kbm-pro.ru/API/';
$post_data = array(
	'API'		=> 'ASD!J@U#$^SHA!JAHA',
	'OrderID'	=> '3746'
);
$ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, $url);  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  
curl_setopt($ch, CURLOPT_POST, 1);  
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);  
$output = curl_exec($ch);  
curl_close($ch);  
echo $output;

На выходе Вы получите данные в формате JSON.

    При успешном запросе в массиве ответа JSON Вы получите значения:

  • ‘success’ со значением ‘yes’,
  • ‘OrderID’ — номер заявки,
  • ‘OldKBM’ — старый КБМ (при наличии),
  • ‘NewKBM’ — новый КБМ (при наличии),
  • ‘ChangeDate’ — дата последней работы с заявкой (в формате дд.мм.гггг чч:мм),
  • ‘Status’ — статус заявки (0 — принято, 1 — в работе, 2 — выполнен, 3 — отказ)

Например, {«success»:»yes»,»OrderID»:3747,»OldKBM»:0.55,»NewKBM»:NULL,»ChangeDate»:»21.10.2018 13:52″,»Status»:1}

При ошибке в запросе в массиве ответа JSON Вы получите одно значение:

  • ‘error’ с кодом ошибки и её кратким описанием

Например, {«error»:»Code 09. No requested order»}