Программный интерфейс (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".