GetMeBack - бонусная программа лояльности

Требования для установки

• Решение устанавливается на редакции: Малый бизнес, Бизнес,, Энтерпрайз.

• Для работы модуля необходимы модули main, sale, iblock версии не ниже 18.5.0.

• Минимальная поддерживаемая версия php - 7.1

• Необходимые модули php - cURL, JSON

• Активный аккаунт GetMeBack

Установка модуля

Стандартная установка модуля через bitrix marketplace.

После установки модуля Вы будете перенаправлены на страницу настроек модуля (Магазин -> GetMeBack - лояльность).

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

Работа модуля

Для активации списания/начисления баллов пользователю необходимо будет разово подтвердить свой номер телефона (на который он зарегистрирован в программе лояльности).

Списание баллов доступно для стандартного шаблона (или шаблонов на его основе) компонента sale.order.ajax. Если используются нестандартные шаблоны, может потребоваться модификация шаблона компонента ifrog:gmb.sale.order.ajax.

После оформления заказа с оплатой бонусными баллами будет создана отдельная оплата "Оплата баллами GetMeBack". Баллами можно оплатить всю сумму товаров в заказе за вычетом 1 рубля.

Начисление баллов происходит после оплаты заказа на оставшуюся сумму заказа. Создается отдельная оплата в заказе "Начисление баллов GetMeBack" с суммой 0 рублей, количество начисленных баллов за заказ можно будет посмотреть в свойстве заказа "Количество начисленных баллов GetMeBack".

На доставку оплата баллами и их начисление не распространяется. Оплату и начисление баллов можно отменить через административную панель bitrix.

В составе модуля есть компонент для вывода баланса пользователя ifrog:getmaback.balance с возможностью подтверждения номера пользователя.

События

onCalculateOrderPrice

Расчет суммы заказа, на которую будут начислены баллы.

Итоговая сумма не может быть больше суммы товаров в заказе за вычетом одного рубля.

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

Если событие вернет ошибку, она будет проигнорирована.

Результат события должен возвращать параметр `amount` с рассчитанной суммой.

onCalculateOrderUseBonusAmount

Расчет максимальной суммы баллов, которыми можно оплатить заказ.

Итоговая сумма не может быть больше суммы товаров в заказе за вычетом одного рубля.

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

Если событие вернет ошибку, она будет проигнорирована.

Результат события должен возвращать параметр `amount` с рассчитанной суммой.

Пример использования событий

Например, мы хотим запретить оплату баллами или их начисление для товаров со скидками.

use IFrog\GMB\Bitrix\Event\BonusEvent; use IFrog\GMB\ModuleEvents; use Bitrix\Main\Loader; use Bitrix\Main\EventManager; Loader::includeModule('ifrog.getmeback'); // обработчик события function excludeDiscountedProducts(BonusEvent $event) { $basket = $event->getBasket(); $amount = 0; foreach ($basket as $item) { /** @var BasketItemBase $item */ // Не учитываем товар со скидкой if (intval($item->getDiscountPrice()) > 0) { continue; } $amount += $item->getPrice(); } $event->addResult( new EventResult( EventResult::SUCCESS, [ // передаем рассчитанную сумму 'amount' => $amount ] ) ); } // регистрация событий EventManager::getInstance() ->addEventHandler( "ifrog.getmeback", // ID модуля ModuleEvents::CALCULATE_ORDER_PRICE, // Идентификатор события 'excludeDiscountedProducts' ); EventManager::getInstance() ->addEventHandler( "ifrog.getmeback", // ID модуля ModuleEvents::CALCULATE_ORDER_USE_BONUS_AMOUNT, // Идентификатор события 'excludeDiscountedProducts' );