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

Author Автор: Роман Чернышов    Опубликовано: 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 version="1.0" ?>
<S:Envelope>
  <S:Body>
  <ns3:testConnection>    
        <agent>1</agent>                   
  </ns3:testConnection>
  </S:Body>
</S:Envelope>

Ответ:

<?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. После оплаты полиса, он автоматически активируется в РСА и отправляется на почту указанную в качестве почты страхователя.

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

калькулятор осаго страница 1калькулятор осаго страница 2калькулятор осаго страница 3

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

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

Заключение

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

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

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

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

Моя книга
Книга. Веб-разработчик. Легкий вход в профессию
Печатная книга
Веб-разработчик.
Легкий вход в профессию
Оформить предзаказ
Последние вопросы
Список вопросов
Последние комментарии
Меню

Archive

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