Интеграция программ лояльности во внешнюю систему заказов

Программа лояльности в Altcraft Platform может использоваться в двух вариантах — в зависимости от того, передаются ли в платформу данные о товарах и заказах через модуль Маркет.

Маркет позволяет передавать в платформу данные о товарах и заказах и использовать их в коммуникациях с клиентами. Данные могут передаваться автоматически — через API или товарный фид, а также вручную — путём загрузки файла.

От наличия данных в Маркете зависит, какие механизмы лояльности вам доступны:

• Без Маркета вы не сможете автоматически рассчитывать скидки, начислять и списывать баллы при оформлении заказов. Операции начисления и списания баллов доступны только через триггерные промоакции и API лояльности.
• С Маркетом помимо базовых операций через триггерные промоакции вам становятся доступны скидочно-балльные промоакции. Они позволяют автоматически начислять и списывать баллы при оформлении заказов, применять скидки и рассчитывать все применяемые бенефиты в соответствии с настроенным арбитражем. Также становится доступен функционал партнерских товаров — для отдельных товаров можно настроить особые условия, например повышенный кешбэк или эксклюзивную скидку для участников программы. Партнерские товары учитываются при расчете заказа через preorder/preorder_commit наравне с обычными промоакциями.

Лояльность с интеграцией Маркета

Этот вариант подходит для автоматического начисления и списания баллов при оформлении заказов, а также применения скидок через балльные и скидочные промоакции. Для работы этого подхода необходимо:

• Загрузить данные о товарах в Маркет. Загрузить данные можно через API, товарный фид или из файла.
• Создать скидочно-балльные промоакции — именно они будут автоматически применяться при расчете заказа.

Оформление заказов с расчетом применённых бенефитов происходит через двухэтапный API:

• На первом этапе вызывается метод preorder — он выполняет предварительный расчет в момент, когда клиент собирает корзину. В запросе передаются состав заказа и данные участника (email, phone, profile_id). Платформа возвращает итоговую цену со скидками, сумму начисления и списания баллов, а также список сработавших промоакций. Заказ еще не создается на данном этапе — это только расчет.
• На втором этапе, после оформления или подтверждения заказа, вызывается метод preorder_commit. Платформа создает заказ, начисляет баллы на счет участника, списывает использованные баллы и фиксирует все примененные промоакции.

Обратите внимание

Автоматическое начисление и списание баллов при оформлении заказов работает только при использовании двухэтапного API (preorder → preorder_commit).

Если заказ создается любым другим способом (например, через импорт, прямое добавление в интерфейсе или собственную логику), механизмы лояльности не срабатывают. В таких случаях управление баллами нужно реализовывать отдельно — через сценарии с триггерными промоакциями или прямые вызовы API начисления и списания.

Лояльность без интеграции с Маркетом

В этом варианте начисление и списание баллов выполняется за действия пользователя: заполнение форм, установку приложений, достижения. Скидочно-балльные промоакции и связанные с ними функции (тестирование, расчет применения бенефитов в рамках арбитража) недоступны.

Управление баллами строится на использовании триггерных промоакций — они задают правила начисления и списания, но не привязаны к заказам. Момент выполнения промоакции определяется либо в сценариях автоматизации (через узел "Управление баллами"), либо через прямые вызовы API лояльности (начисление, списание, регистрация участников). Методы preorder и preorder_commit в этом варианте не используются — они доступны только при работе с Маркетом.

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