Иногда необходимо выполнить определенные действия с заказом при его изменении. Для этого можно использовать события OnSaleOrderBeforeSaved и OnSaleOrderSaved.
В обоих событиях мы можем получить объект заказа и произвести с ним любые изменения: изменить свойства, состав заказа (корзину), платежные системы и отгрузки.
К данным событиям можно обращаться через менеджер событий (EventManager).
Подробности о классе: Bitrix\Main\EventManager.
OnSaleOrderBeforeSaved - событие до сохранения заказа
В этом событии у нас есть объект заказа и значения его предыдущих полей (до сохранения). Например, если мы изменяем свойства заказа, можно добавить к нему новую оплату с определенной платежной системой.
Рассмотрим пример из реального проекта: заказ создается со статусом "Новый", без платежной системы и только после проверки менеджером переводится в статус, начиная с которого заказ можно оплатить (добавляется оплата). Для данной логики добавим в файл init.php следующий код:
use Bitrix\Main;
Main\EventManager::getInstance()->addEventHandler(
'sale',
'OnSaleOrderBeforeSaved', // Наше событие
'updatePaySystem'
);
function updatePaySystem(Main\Event $event)
{
$order = $event->getParameter("ENTITY");
$Status = $order->getField("STATUS_ID");
if ($Status == 'S') { // При переводе статуса в "Принят ожидается оплата"
$paymentCollection = $order->getPaymentCollection();
$payment = $paymentCollection->createItem(
Bitrix\Sale\PaySystem\Manager::getObjectById(
4 // 4 - ID платежной системы
)
);
$payment->setField(
'SUM',
$order->getPrice()
);
$payment->setField(
'CURRENCY',
$order->getCurrency()
);
}
}Обратите внимание, что в 1С-Битрикс есть встроенный функционал для реализации оплаты заказа после подтверждения менеджером. В моем примере необходимость реализовать это через событие возникла из-за проблем с конкретной 1С-УТ. Тем не менее, пример использования события OnSaleOrderBeforeSaved уместен.
В Main\Event мы получаем объект заказа. Используя его, мы можем извлечь и изменить любую информацию в заказе, включая добавление новой платежной системы (в точности оплата). При этом устанавливаются сумма и валюта заказа.
OnSaleOrderSaved - событие после сохранения заказа
В данном событии, помимо объекта заказа и его предыдущих значений, имеется флаг новизны заказа IS_NEW = true/false.
Предположим, нам нужно отправить уведомление пользователю о том, что его заказ был успешно сохранён. В этом случае мы можем воспользоваться следующим кодом в файле init.php:
Main\EventManager::getInstance()->addEventHandler(
'sale',
'OnSaleOrderSaved', // Наше событие
'sendOrderSuccessNotification'
);
function sendOrderSuccessNotification(Main\Event $event)
{
$order = $event->getParameter('ENTITY');
$isNew = $event->getParameter('IS_NEW');
if ($isNew) {
// Логика отправки уведомления пользователю
$userEmail = $order->getPropertyCollection()->getItemByOrderPropertyCode(
'EMAIL'
)->getValue();
// Здесь вы можете использовать любой метод для отправки почты
mail(
$userEmail,
'Ваш заказ успешно создан',
'Спасибо за заказ! Номер вашего заказа: ' .
$order->getId()
);
}
}В данном примере к событию OnSaleOrderSaved добавляется обработчик sendOrderSuccessNotification. Внутри функции мы проверяем, является ли заказ новым (с помощью параметра IS_NEW).
Если заказ действительно новый, мы извлекаем адрес электронной почты пользователя из его свойств и отправляем уведомление о том, что заказ был успешно создан.
