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

Author Роман Чернышов    Category PHP     Tags , , Комментариев 0 Дата 6 Окт

РЕСО-Гарантия Привет, друзья! Работаю с очередным 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. Техническая поддержка компании работает хорошо.

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

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

Консультации

Последние вопросы
Меню

Archive

Качественный хостинг сайтов CMS Для сайта услуг хостинга