apikbm

Программный интерфейс (API) к сервису исправления КБМ

Уважаемые партнеры, владельцы или разработчики web сайтов, наш центр обработки предоставляет программный интерфейс (API) для реализации сервиса исправления КБМ в РСА на своем сайте.

Как происходит обработка заявок коррекции КБМ через API:

1. На вашем сайте создаются заявки на исправление КБМ и передаются по программному интерфейсу обезличенными в наш центр обработки. При успешной передаче, на ваш сайт возвращается ответ: идентификатор заявки и значение КБМ на дату обработки заявки.

2. Ваш сайт эпизодически по api делает запрос в наш центр обработки по идентификаторам заявок, находящихся в работе. При этом могут возвращаться три варианта ответа (статусы заявок): Выполнен, РСА и Отказ. Если заявка имеет статус Выполнен, то дополнительно передается значение нового КБМ.  Полученный результат ваш сайт самостоятельно транслирует заказчику исправления КБМ. 

3. Раз в неделю вам выставляется счет для оплаты по фактически выполненным за период заявкам согласно установленной вам специальной цены.  

Как подключиться по API к центру обработки КБМ, два варианта:

1. Заказать у нас интеграцию КБМ сервиса на свой сайт через форму заявки на сотрудничество . Стоимость услуги 20 тыс.руб разово. Срок реализации до 10 дней.  Что получаете:

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

- розничный модуль приема заявок с онлайн предоплатой через Единую кассу или Яндекс кассу.

- формы заявок исправления КБМ по ОСАГО с ограничением и без ограничения.

- журнал заявок с произвольными фильтрами и статистику.

- любой дополнительный публичный функционал kbm-osago.online: заявки на страхование, онлайн проверки по базе РСА, калькулятор ОСАГО, справочные и методические материалы и т.д

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

2. Самостоятельно реализовать интерфейсную часть КБМ сервиса и подключить его к нашему api. Необходимые примеры и консультацию вашим специалистам предоставим. Как это сделать:

- подключиться через api к тестовой зоне, где сможете создать заявки, получать ответ, смотреть результат. Важное замечание - тестовые заявки фактически не обрабатываются, только симуляция обработки. В момент создания присваивается КБМ=1, в момент обработки случайный статус Выполнен, Отказ, РСА. В случае Выполнен, КБМ новый =0.5.  

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

Ниже описание  функционала программного интерфейса исправления КБМ.

kbmkey передается в url get-запроса, для тестовой зоны &kbmkey=kbmtest
Пример создания заявки исправления КБМ водителя
$data=array();
$data["fam"]="Иванов"; //фамилия
$data["im"]="Сергей"; //Имя
$data["otch"]="Алексеевич"; //Отчество (если есть)
$data["birthday"]="30.10.1985"; //Дата рождения
$data["vod"]="22УМ 999333"; //Серия и номер ВУ. Серия может быть короче 4 знаков, например для Абхазии 2 знака, но пробел между серией и номером обязателен.
$data["pasp"]="6002 200300"; //Необязательно, серия и номер паспорта.
$data["old_fam"]=""; //Необязательно, прошлая фамилия, если была смена.
$data["old_vod"]="6001 000111"; //Необязательно, серия и номер предыдущего ВУ. Рекомендуем по возможности заполнять, влияет на качество и скорость обработки.
$data["old_pasp"]=""; //Необязательно, серия и номер прошлого паспорта, если была смена фамилии
$data["datekbm"]="25.12.2018"; //Дата расчета "КБМ был" (до изменения нашим сервисом), равен текущей дате или в диапазоне до +60 дней от текущей.
$data=urlencode(json_encode($data));
$url="https://kbm-osago.online/apikbm.php?new&kbmkey=kbmtest&data=".$data;
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В возвращаемом массиве $result содержится id созданной заявки и old_kbm - числовое значение "КБМ был"
Пример получения статуса заявки по id
$url="https://kbm-osago.online/apikbm.php?kbmkey=kbmtest&id=22583";
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В возвращаемом массиве $result содержится old_kbm - числовое значение "КБМ был", new_kbm - "КБМ стал (после обрабоки)" и status - возможные значения: "Выполнен" - кбм успешно понижен, "Отказ" - кбм не понижен, "РСА" - находится в обработке, "(пусто)" - в очереди на обработку (интервал до 10 мин)
Пример получения списка (журнала) своих заявок в интервале от 1 до 14 дней назад с текущего момента
$url="https://kbm-osago.online/apikbm.php?kbmkey=kbmtest&jr=2"; //в данном примере jr=2 - глубина 2 дня.
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В каждой строке возвращаемого массива $result содержится массив с ключами id, created, fam, im, otch, birthday, vod, pasp, old_fam, old_vod, old_pasp, avto, KBM_avto, old_kbm, status, new_kbm, datekbm".


Пример краткой версии API КБМ водителя на текущую дату ("simple kbm" - метод s_kbm) :
С вашей стороны происходит GET запрос (в url необходимо добавить kbmkey=ВашКБМКей) для получения данных в виде Json строки
$url="https://kbm-osago.online/apikbm.php?s_kbm&data=".urlencode("Иванова Елена Ивановна#20.07.1977#21АВ 100008");
Получение цифрового значения КБМ водителя на текущую (всегда!) дату:
$result = file_get_contents($url); echo $result;