Интеграция с облачными сервисами

Облачная товароучётная система это сторонний сервис, который позволяет пользователям взаимодействовать с сущностями предприятия: магазинами, сотрудниками и товарами.

Для пользователей Эвотора интеграция выглядит как приложение, которое можно купить в Магазине приложений. Купленные приложения отображаются в Личном кабинете, в разделе Мои приложения.

Перед интеграцией, убедитесь, что облачная товароучётная система поддерживает адреса, указанные в таблице ниже.

URL	Назначение	Авторизация
https://example.com/api/v1/user/create	Эвотор отправляет по адресу регистрационные данные для создания новой учётной записи в облачной товароучётной системе.	Товароучётная система авторизует запрос облака с помощью имени пользователя и пароля (basic-авторизация) или токена (bearer-авторизация).
https://example.com/api/v1/user/verify	Эвотор отправляет по адресу данные для авторизации пользователя в облачной товароучётной системе с помощью ранее созданной учётной записи.
https://example.com/api/v1/user/token	Эвотор отправляет по адресу токен приложения, с помощью которого будет авторизовывать запросы от товароучётной системы.
https://example.com/api/v1/subscription/event	Эвотор отправляет по адресу события сообщающие об изменении подписки на приложение.

Информацию о сущностях пользователя Эвотор (магазинах, товарах, сотрудниках и смарт-терминалах), товароучётная система получает с помощью запросов к облаку Эвотор.

Покупка и активация приложения

Этап 1

В магазине приложений, пользователь выбирает приложение и тариф, и авторизуется в стороннем сервисе одним из двух способов:

Если у пользователя нет учётной записи, Эвотор отправляет в сторонний сервис запрос на регистрацию учётной записи. Тело запроса содержит регистрационные данные, с помощью которых сторонний сервис создаёт учётную запись. Для авторизации своих запросов, Эвотор передаёт заголовок Authorization.

В ответе сервис передаёт облаку токен пользователя (токен, который Эвотор отправляет в вебхуках-уведомлениях и запросах от смарт-терминала).
Если у пользователя есть учётная запись, Эвотор отправляет в сторонний сервис запрос на авторизацию пользователя. Тело запроса содержит данные учётной записи пользоваетя в стороннем сервисе. Для авторизации своих запросов, Эвотор передаёт заголовок Authorization.

Содержимое заголовка Authorization вы задаёте на Портале разработчиков, при создании приложения. В зависимости от типа авторизации (basic или bearer), который поддерживает сторонний сервис, заголовок может содержать имя пользователя и пароль для доступа к стороннему сервису, закодированные в base64, или токен стороннего сервиса.

Этап 2

Эвотор передаёт в сторонний сервис событие SubscriptionCreated. Событие содержит поля, которые указывают на начало пробного периода использования приложения. В дальнейшем, при изменении подписки, Облако передаёт в сторонний сервис другие события биллинга.

Удаление и деактивация приложения

Эвотор останавливает интеграцию и удаляет приложение если:

пользователь самостоятельно удалил приложение в разделе Мои приложения в Личном кабинете пользователя Эвотор;
у пользователя недостаточно средств для продления подписки. В этом случае, за пять дней до отключения приложения, Эвотор начинает рассылать пользователю смс с предупреждением о скором отключении приложения.

В обоих случаях, после удаления приложения, Эвотор передаёт в сторонний сервис запрос на деактивацию тарифа с состоянием INACTIVE.

Повторная установка приложения

При повторной установке приложения, Эвотор проверяет истёк пробный период использования приложения или нет.