События вызываемые при сохранении заказа, в 1С-Битрикс

В обоих событиях мы можем получить объект заказа и произвести с ним любые изменения: изменить свойства, состав заказа (корзину), платежные системы и отгрузки.

К данным событиям можно обращаться через менеджер событий (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).

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