Событие позволяет изменить сумму заказов пользователя, учитываемую при расчете правил начисления и списания бонусов.
Когда это может понадобится:
Сумма заказов пользователя по умолчанию рассчитывается из суммы оплаченных заказов пользователя на сайте.
Бывает, что при обмене с 1С, на сайте не всегда имеются все заказы пользователя (отсутствуют заказы, оформленные офф-лайн).
В данном случае, из 1С можно передавать на сайт сумму заказов пользователя, сохраняя в произвольном поле, и использовать при расчете эту сумму.
Пример события (код вставлять в init.php):
\Bitrix\Main\EventManager::getInstance()->addEventHandler("logictim.balls", "BeforeUserOrdersSum", "EventBeforeUserOrdersSum");
function EventBeforeUserOrdersSum(\Bitrix\Main\Event $event)
{
$arFields = $event->getParameters();
$arFields["CUSTOM_ORDERS_SUM"] = 10000; //Если здесь укажите сумму заказов, то при расчетах правил будет использоваться именно она
$result = new Bitrix\Main\EventResult($event->getEventType(), $arFields);
return $result;
}