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

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

Доброго времени друзья! Рынок авто-страхования неуклонно растет на протяжении последних десяти лет, от части это связано с массовой автомобилизацией страны, все больше людей предпочитают иметь свой авто. В этой связи, актуальным как никогда становится бизнес по продаже страховых полисов, а вместе с этим и техническая составляющая — интеграция с 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 данной СК, с другими компаниями, то в некоторых моментах можно отметить — простоту(относительно понимания), но в чем-то напротив — сложность(например документация могла бы быть более полной, не хватает примеров). Поддержка в СК Согласие, по технической части — работает хорошо. Для возможности подключения к сервисам СК, требуется заключение партнерского договора.

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

CMS, PHP, Система     интеграция api, страховая компания