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

Добрый день друзья! В рамках работы с сайтом для страховых агентов, которые занимаются оформлением полисов ЕОСАГО, мне предстояла задача изучить и интегрировать сайт с API компании АльфаСтрахование. Это одна из немногих страховых компаний, которая предоставляет такую возможность, причем делает это без дополнительной волокиты со стороны агента, как это бывает в других компаниях. Для интеграции с API, предоставляется документация, описывающая логику работы и принципы построения запросов к удаленному серверу.

Возможности

Интеграция сайта с API страховой компании АльфаСтрахование, дает следующие возможности:

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

API

Для взаимодействия с API используется SOAP протокол (Simple Object Access Protocol — простой протокол доступа к объектам), требующий безошибочного заполнения элементов заголовка SOAP-сообщения формате XML(расширяемый язык разметки), с указанием индивидуального логина и пароля, необходимых для доступа к сервису. Для безопасности пароль кодируется с помощью алгоритма SHA1 и передается в зашифрованном по формуле Base64, виде.

На мой взгляд, организация работы API по средствам передачи данных в формате JSON(текстовый формат обмена данными, основанный на JavaScript), было бы более удобным, как это сделано на сайтах рядя других сервисов. К тому же данные переданные в формате JSON имеют меньший размер, по сравнению с XML, что может также иметь значение, в некоторых проектах. Но это мое субъективное мнение, т.к. я много работаю именно с JavaScript.

Логика взаимодействия с API представлена BPMN схемой(модель бизнес-процессов), которая подробно описывает все этапы оформления полиса ЕОСАГО.

API предоставляет доступ к следующему списку сервисов:

• Сервис OSAGOlists — Раз в день вызывается с последующим запоминанием ответа сервиса. Используется для формирования выпадающего списка с известными марками ТС, моделями ТС, перечнем категорий ТС, целей использования данного ТС, перечнем доступных категорий ТС
• Сервис OsagoCalcRelaunch — Используется для расчёта страховой премии по договору
• Сервис EOsagoRelaunch — Проверка данных по ЛДУ, данных по страхователю/собственнику (не влияет на загрузку договора в РСА), данных по страхуемому ТС, собственника, страхователя. Позволяет осуществить загрузку проекта договора в РСА.
• Сервис GetContractSigned — Выгрузка печатной формы полиса клиента.
• Сервис PartnersCallbackService — Для партнёров с полной интеграцией по API по договорённости с менеджерами АльфаСтрахования может быть разрешена возможность оплачивать договора ЕОСАГО через свои платёжные системы с последующей сверкой числа проданных полисов и передачей реестров оных. Данный сервис обеспечивает фиксацию оплаты в БД АльфаСтрахования и отправку письма с полисом страхователю.
• Сервис оплаты MerchantServices — Используется для оплаты полиса клиентом.
• Сервис регистрации ЛК userPartner — В рамках продажи ЕОСАГО необходимо создать ЛК клиента страхователя.
• Сервис AdditionalKaskoService — Используется для получения партнерами информации по  договорам КАСКО.

Каждый сервис имеет перечень доступных методов, подробное описание которых также представлено в документации.

Заключение

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

Обращайтесь, буду рад сотрудничеству!