Уважаемые партнеры, владельцы или разработчики web сайтов, наш центр обработки предоставляет программный интерфейс (API) для реализации сервиса исправления КБМ в РСА на своем сайте.
Как происходит обработка заявок коррекции КБМ через API:
1. На вашем сайте создаются заявки на исправление КБМ и передаются по программному интерфейсу обезличенными в наш центр обработки. При успешной передаче, на ваш сайт возвращается ответ: идентификатор заявки, значение КБМ на дату обработки заявки и ссылка на файл отчета РСА.
2. Ваш сайт эпизодически по api делает запрос в наш центр обработки по идентификаторам заявок, находящихся в работе. При этом могут возвращаться шесть вариантов ответов (статусы заявок): Выполнен, РСА, Отказ, Оператор, Ошибка, пусто (нет статуса). Если заявка имеет статус Выполнен, то дополнительно передается значение нового КБМ и ссылка на файл отчета РСА. Полученный результат ваш сайт самостоятельно транслирует заказчику исправления КБМ. Вместо сканирования статусов по каждой заявке, можно сразу получать и обрабатывать журнал заявок за период.
Процесс прохождения заявок по статусам: Пусто - заявка в очереди на обработку. Раз в 10 минут заявки распределяются в очередь Операторам, соответственно меняется статус на Оператор, при этом записывается значение КБМ был и прикрепляется ссылка на файл отчета РСА по КБМ был. Раз в 30 минут, заявки со статусом Оператор меняют статус на РСА - что означает в работе. Далее заявка в процессе обработки примет один из двух статусов - Выполнен или Отказ. Статус Ошибка присваивается нами вручную, при явном обнаружении ошибки в заявке до момента, пока она еще не имеет статус РСА. Заявки, имеющие статус РСА - корректироваться или отменяться не могут.
3. Раз в неделю вам выставляется счет для оплаты по фактически выполненным за период заявкам согласно установленной вам специальной цены.
Как подключиться по API к центру обработки КБМ, два варианта:
1. Заказать у нас платную интеграцию КБМ сервиса на свой сайт через форму заявки на сотрудничество . Что получаете:
- возможность создания у себя на сайте агентской структуры по произвольной цене, с режимом постоплаты или предоплаты, или доработка вашего существующего агентского модуля.
- розничный модуль приема заявок с онлайн предоплатой через Единую кассу или Яндекс кассу.
- формы заявок исправления КБМ по ОСАГО с ограничением и без ограничения.
- журнал заявок с произвольными фильтрами и статистику.
- любой дополнительный публичный функционал kbm-osago.online: заявки на страхование, онлайн проверки по базе РСА, калькулятор ОСАГО, справочные и методические материалы и т.д
В стоимость базового пакета входит разработка индивидуального логотипа, фавикон, типовой шаблон. Дополнительные дизайнерские и графические работы оплачиваются отдельно или делаются вами самостоятельно. Возможно бесплатное размещение вашего сайта на нашем хостинге.
2. Самостоятельно реализовать интерфейсную часть КБМ сервиса и подключить его к нашему api. Необходимые примеры и консультацию вашим специалистам предоставим. Как это сделать:
- подключиться через api к тестовой зоне, где сможете создать программно создавать заявки и получать их состояния. Важное замечание - тестовые заявки не обрабатываются и в интерфейсе нашей программы не отображаются, они только для первоначальной отладки вашей программы, чтобы ознакомиться со структурой ответов.
- после того, как отладите работу своего сайта в нашей тестовой зоне, вы заключите с нами договор на реальную обработку ваших заявок и получите специальный персональный ключ kbmkey, который позволит передавать завки работу. При этом нужно будет заранее договориться с нами о включении тестового периода по вашему реальному 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["FileBase64"]="vvmnvmnvmnvggfgjh"; //фото текущего ВУ в формате строки base64, обязательное поле.
$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 - числовое значение "КБМ был", download - ссылка на файл РСА кбм был
Пример создания заявки исправления КБМ собственника (обратите внимание на параметр newneogr вместо new)
$data=array();
$data["fam"]="Иванов"; //фамилия
$data["im"]="Сергей"; //Имя
$data["otch"]="Алексеевич"; //Отчество (если есть)
$data["birthday"]="30.10.1985"; //Дата рождения
$data["avto"]="VIN"; //Идентификатор авто, допустимые значения: VIN - вин номер, BodyNumber - номер кузова, ChassisNumber - номер шасси
$data["KBM_avto"]="WVWZXX3BX1P000001"; // значение идентификатора авто.
$data["pasp"]="6002 200300"; //Необязательно, серия и номер паспорта.
$data["old_fam"]=""; //Необязательно, прошлая фамилия, если была смена.
$data["old_pasp"]=""; //Необязательно, серия и номер прошлого паспорта, если была смена фамилии
$data["datekbm"]="25.12.2018"; //Дата расчета "КБМ был" (до изменения нашим сервисом), равен текущей дате или в диапазоне до +60 дней от текущей.
$data=urlencode(json_encode($data));
$url="https://kbm-osago.online/apikbm.php?newneogr&kbmkey=kbmtest&data=".$data;
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));
В возвращаемом массиве $result содержится id созданной заявки, old_kbm - числовое значение "КБМ был", download - ссылка на файл РСА кбм был
Пример получения статуса заявки по 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 - "КБМ стал (после обрабоки)", f_old - ссылка на файл отчета РСА КБМ был, f_new - ссылка на файл отчета РСА КБМ стал, status - возможные значения: "Выполнен" - кбм успешно понижен, "Отказ" - кбм не понижен, "РСА" - находится в обработке, "(пусто)" или "Оператор" - в очереди на обработку (интервал до 30 мин)
Пример получения списка (журнала) своих заявок в интервале от 0 до 14 дней назад с текущего момента, 0 - выборка за текущий день.
$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, f_old, status, new_kbm, f_new, datekbm".
Внимание! Файлы отчетов РСА в ключах f_old и f_new хранятся на нашей стороне 30 дней.
Пример краткой версии 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;