Интеграция с API ОСАГО РЕСО-Гарантия

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

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

Описание API

Сервис доступен по протоколу SOAP 1.1, для чего компания предоставляет два WSDL сервера, тестовый и промышленный. Для работы с сервисом необходимо получить доступ, для чего нужно зарегистрировать IP адрес своего проекта в системе, обратившись в службу технической поддержки РЕСО.

API предоставляет следующий набор веб-сервисов:

Калькулятор ОСАГО
Технологический сервис
Экспорт справочников по ОСАГО
Импорт данных полиса Е-ОСАГО в АИС РЕСО

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

Calculate – расчет полиса
testConnection – проверка соединения
getListDict – получение списка справочников
getDictionary – получение конкретного справочника в формате
savePolicy – сохранение проекта полиса в ЕАИС РЕСО
issuePolicy – оформление полиса
PrintDoc – печать документ
annulPolicy – аннулирование полиса
getStepPolicy – шаг полиса
ProlongationPolicy – пролонгация полиса
getPolicyInfo – получение информации для пролонгации
SaveDocs – Прикрепление изображений к полису

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

Запрос:

Просмотр кода XML

<?xml version="1.0" ?>
<S:Envelope>
  <S:Body>
  <ns3:testConnection>    
        <agent>1</agent>                   
  </ns3:testConnection>
  </S:Body>
</S:Envelope>

Ответ:

Просмотр кода XML

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope>
  <S:Body>
    <ns3:testConnectionResponse>
      <return>
        <ns2:ExchangeId>0</ns2:ExchangeId>
        <ns2:CalcId>0</ns2:CalcId>
        <ns2:Policy>0</ns2:Policy>
        <ns2:Step>1</ns2:Step>
        <ns2:Message_>Подключение успешно</ns2:Message_>
        <ns2:UnderWritings/>
        <ns2:Errors/>
        <ns2:Attachs/>
      </return>
    </ns3:testConnectionResponse>
  </S:Body>
</S:Envelope>

Схема работы

1. Интегратор запрашивает расчет (Calculate) полиса ОСАГО, получает предварительную стоимость полиса. Данный расчет не является офертой, он носит информационный характер, позволяет предоставить клиенту информацию о стоимости. Также данный метод возвращает ряд технических данных, которые затем используются в другим методах.

2. Интегратор присылает запрос на создание проекта полиса (savePolicy). Ответ от сервиса на операцию сохранения проекта является офертой. Метод возвращает сумму страховой премии по полису.

3. В случае если премия клиента устраивает, то интегратор присылает команду issuePolicy. В этот момент запускается процедура получения электронного полиса в РСА. При успешном обмене с РСА интегратору возвращается ссылка на оплату полиса (PaymentLink).

4. После оплаты полиса, он автоматически активируется в РСА и отправляется на почту указанную в качестве почты страхователя.

Пример калькулятора и формы расчета, разработанного мною:

Тестирование

Отдельно хочется упомянуть о тестировании работы сервера по API, в отличии от API других страховых компаний, тут есть ряд отличий. В данном случае при тестировании стоит учитывать следующие нюансы: нельзя многократно отправлять одни и те же данные клиента, для оформления полиса; все данные должны быть действительными, автомобиль, водитель, собственник; тестирование тарифов не производиться и доступно только на промышленной версии сервиса; ссылка на оплату не предоставляется; иногда ответ сервера может достигать 3 минуты. Все эти тонкости, в сравнении с другими страховыми компаниями, усложняют процесс интеграции. У других страховых компаний, с которыми я работал, процесс тестирования происходит проще.

Заключение

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

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

Заказать >>