Битрикс. Событие создание нового заказа.

В 1С-Битрикс очень часто требуется выполнить дополнительную логику после создания заказа.

Например:

отправка данных во внешнюю систему;
уведомления;
интеграция с CRM;
изменение свойств заказа;
логирование;
автоматическая обработка заказов.

Для этого удобно использовать событие:

OnOrderSave

Пример обработчика события

<?
AddEventHandler(
    "sale",
    "OnOrderSave",
    "OrderMySave"
);

function OrderMySave(
    $orderID,
    $fields,
    &$orderFields,
    $isNew
){
    if ($isNew) {

        // Полезный код

    }
}
?>

Что делает OnOrderSave

Событие:

OnOrderSave

вызывается:

при создании заказа;
при обновлении заказа.

Проверка нового заказа

Чтобы выполнять код только при создании заказа, используется:

if ($isNew)

Если:

$isNew == true

значит заказ создан впервые.

Параметры обработчика

$orderID

ID заказа.

$fields

Массив полей заказа.

$orderFields

Дополнительные поля заказа, передаются по ссылке.

$isNew

Флаг нового заказа.

Пример получения заказа

<?
AddEventHandler(
    "sale",
    "OnOrderSave",
    "OrderMySave"
);

function OrderMySave(
    $orderID,
    $fields,
    &$orderFields,
    $isNew
){

    if ($isNew)
    {

        $order = CSaleOrder::GetByID($orderID);

        echo '<pre>';
        print_r($order);
        echo '</pre>';

    }

}
?>

Где размещать обработчик

Обычно обработчик размещают:

/bitrix/php_interface/init.php

или:

/local/php_interface/init.php

Что можно делать в обработчике

изменять свойства заказа;
отправлять webhook;
создавать задачи;
работать с CRM;
уведомлять менеджеров;
записывать данные в лог;
создавать документы.

Пример записи в лог

<?
file_put_contents(
    $_SERVER["DOCUMENT_ROOT"] . "/order.log",
    "Создан заказ: " . $orderID . PHP_EOL,
    FILE_APPEND
);
?>

Важно про производительность

Не рекомендуется:

выполнять тяжелые запросы;
долго обрабатывать API;
делать медленные интеграции.

Иначе оформление заказа может замедлиться.

Современный D7 аналог

В новых проектах лучше использовать D7-события:

\Bitrix\Main\EventManager

и объект:

\Bitrix\Sale\Order

Пример D7

<?
use Bitrix\Main\EventManager;

EventManager::getInstance()->addEventHandler(
    'sale',
    'OnSaleOrderSaved',
    'myOrderHandler'
);
?>

Когда использовать старый обработчик

старые проекты;
старый API sale;
быстрые доработки;
совместимость со старыми модулями.

Итог