Интеграция с API ОСАГО страховой компании Согласие

Author Автор: Роман Чернышов    Опубликовано: 5 декабря 2019

Интеграция с API ОСАГО страховой компании СогласиеДоброго времени друзья! Рынок авто-страхования неуклонно растет на протяжении последних десяти лет, от части это связано с массовой автомобилизацией страны, все больше людей предпочитают иметь свой авто. В этой связи, актуальным как никогда становится бизнес по продаже страховых полисов, а вместе с этим и техническая составляющая — интеграция с API страховых компаний. Сегодня мы рассмотрим работу с API страховой компании Согласие(ранее я у же рассказывал, про Ингосстрах, ВСК, АльфаСтрахование, Ресо). Такая интеграция позволяет реализовать на своем сайте, продажу новых и пролонгацию существующих полисов ОСАГО, при этом весь цикл оформления и оплаты полиса происходит онлайн, что позволяет предоставить своим клиентам лучший сервис!

Описание API

Оформление полиса ОСАГО по API состоит из девяти последовательных шагов, пять из которых обязательны, а оставшиеся условно-обязательны(это зависит от результатов выполнения обязательных шагов). Ниже приведен весь перечень необходимы шагов(В компании Согласие, шаг обозначается как — информационный поток).

Схема взаимодействие с API СК Согласие

  1. Проверка КБМ. Обязателен для полиса с ограниченным количеством водителей. Необязателен для полиса с неограниченным числом водителей;
  2. Запрос Скоринг-оценки. Обязателен;
  3. Получение расчета. Обязателен;
  4. Загрузка заявления ЕОСАГО. Обязателен;
  5. Проверка статуса загруженного заявления. Обязателен, в процессе ЕОСАГО требуется повторение данного ИП;
  6. Перевод заявления в статус «Оформление прекращено», Обязательность зависит от результатов шага 5;
  7. Получение ссылки на оплату полиса. Взаимоисключающий шаг;
  8. Запись данных об успешной оплате полиса. Взаимоисключающий шаг;
  9. Скачивание ПФ полиса. Необязателен.

При работе с методами API, требуется авторизация на сервере, которая осуществляется путем передачи заголовка Authorization в POST запросе, содержащего логин и пароль, закодированные в свою очередь Base64. Сервис доступен по протоколу SOAP 1.1, для чего компания предоставляет два WSDL сервера, тестовый и промышленный.

Методы для взаимодействия с API

Список методов:

  1. Scoring — Скоринг-оценка;
  2. CalcProduct — Расчет страховой премии;
  3. Policy — Загрузка заявления;
  4. Status — Проверка статуса;
  5. Suspend — Перевод заявления в статус «Оформление прекращено»;
  6. Paylink — Получение ссылки на оплату полиса;
  7. Notice — Скачивание ПФ заявления/полиса;
  8. Acquiring — Запись данных об успешной оплате полиса.

Также по API доступны следующие справочники, необходимые для оформления полиса:

  1. Справочник марок ТС;
  2. Справочник моделей ТС для определенной марки;
  3. Справочник типов моделей ТС;
  4. Справочник типов моделей СТО;
  5. Справочник адресов СТО.

Пример кода запроса XMl для метода Scoring

Запрос:

<scor:getScoringId>
       <test>true/fasle использовать тестовый сервис</test>
       <request >
          <private>
             <lastname>Фамилия</lastname>
             <firstname>Имя</firstname>
             <middlename>Отчество</middlename>
             <birthday>Дата рождения</birthday> - формат 1980-12-31
             <birthplace>Место рождения</birthplace>
             <documents>
                <document>
                   <doctype>Тип документа</doctype>
                   <docseria>Серия</docseria>
                   <docnumber>Номер</docnumber>
                   <docdatebegin>Дата выдачи</docdatebegin>
                   <docplace>Место выдачи</docplace>
                </document>
             </documents>
             <addresses>
                <address>
                   <type>Тип адреса</type>
                   <index>Индекс, если есть</index>
                   <address>Адрес</address> 
                </address>
             </addresses>
          </private>
     	<params>
         <param>
         < brief >Акция</ brief >
         <val>ИД Акции</val>
         </param>
         <param>
         < brief >ИсходныйДоговорНомер</ brief >
         <val>Номер предыдущего договора при пролонгации</val>
         </param>
        </params>
       </request>
    </scor:getScoringId>

Ответ:

<scor:getScoringId>
    <request partial="true">
      <private>
        <lastname>Ащеулов</lastname>
        <firstname>Константин</firstname>
        <middlename>Викторович</middlename>
        <birthday>1974-10-17</birthday>
      </private>
    </request>
  </scor:getScoringId>

Интеграция с калькулятором ОСАГО

Благодаря данному API, вы можете интегрировать свой сайт, форму отправки заявки на оформление полиса или калькулятор ОСАГО(о котором я ранее рассказывал) со страховой компанией Согласие, это даст вам возможность продавать полисы ОСАГО, своим клиентам, онлайн. Интеграция с готовым калькулятором займет гораздо меньше времени, нежели чем разработка аналогичного решения своими силами.

Все продукты компании Согласие, доступные для интеграции

  • Программа страхования выезжающих за рубеж;
  • Программы страхования от несчастных случаев;
  • Программы страхования имущества физических лиц;
  • Программы страхования Авто;
  • Программы добровольного медицинского страхования;
  • Программы страхования грузов.

Заключение

Страховая компания(СК) Согласие, предоставляет все необходимые сервисы взаимодействия по API для оформление полиса ОСАГО, в том числе справочники данных и документацию по работе с API. Если сравнивать реализацию API данной СК, с другими компаниями, то в некоторых моментах можно отметить — простоту(относительно понимания), но в чем-то напротив — сложность(например документация могла бы быть более полной, не хватает примеров). Поддержка в СК Согласие, по технической части — работает хорошо. Для возможности подключения к сервисам СК, требуется заключение партнерского договора.

Если вам требуется помощь в интеграции, буду рад сотрудничеству с вами!

Оставить комментарий

Автор блога
Чернышов Роман
Роман Чернышов
Веб-разработчик,
Full Stack
Senior, Architector
PHP, JavaScript, Node.JS, Python, HTML 5, CSS 3, MySQL, Bash, Linux Admin
Заказать работу
предложить оффер

Последние вопросы
Список вопросов
Последние комментарии
Меню

Archive

Мои проекты
Insurance CMS Love Crm CMS Совместные покупки Мой PHP Framework Хостинг для моих клиентов Лицензии на мой софт и поддержка