Настройка уведомлений о смене статуса заказа 1С-Битрикс

Настройка уведомлений о смене статуса заказа 1С-Битрикс

Покупатель оформил заказ и ждёт. Следующий контакт — уведомление о смене статуса. Если письмо приходит с задержкой или содержит ошибки — это удар по доверию. 1С-Битрикс отправляет уведомления через механизм почтовых событий, который требует осознанной настройки под конкретный бизнес.

Механизм почтовых событий

Система уведомлений строится на трёх слоях:

1. Тип почтового события — описание с набором макросов (SALE_STATUS_CHANGED)
2. Шаблон — HTML-письмо с макросами, привязанный к сайту и языку
3. Вызов отправки — CEvent::Send() в обработчике события

При смене статуса с флагом «Уведомлять покупателя» Битрикс автоматически отправляет SALE_STATUS_CHANGED. Флаг снимается если нужен полный контроль над логикой.

Стандартные макросы

#ORDER_ID#           — номер заказа
#ORDER_DATE#         — дата заказа
#ORDER_STATUS#       — название нового статуса
#ORDER_PRICE#        — сумма заказа
#ORDER_TRACK_NUMBER# — трек-номер
#BUYER_EMAIL#        — email покупателя
#BUYER_NAME#         — имя покупателя

Кастомный обработчик с расширенными данными

AddEventHandler('sale', 'OnSaleStatusOrderChange', function(\Bitrix\Main\Event $event) {
    $order = $event->getParameter('ENTITY');
    $newStatus = $order->getField('STATUS_ID');

    $notifyStatuses = ['F', 'PROCESSING', 'DELIVERING', 'D', 'CANCEL'];
    if (!in_array($newStatus, $notifyStatuses)) return;

    $propCollection = $order->getPropertyCollection();
    $buyerEmail = $propCollection->getUserEmail();
    if (!$buyerEmail) return;

    $trackNumber = '';
    foreach ($order->getShipmentCollection() as $shipment) {
        if (!$shipment->isSystem() && $shipment->getField('TRACKING_NUMBER')) {
            $trackNumber = $shipment->getField('TRACKING_NUMBER');
            break;
        }
    }

    \CEvent::Send('SALE_STATUS_CHANGED', SITE_ID, [
        'ORDER_ID'     => $order->getId(),
        'ORDER_DATE'   => $order->getDateInsert()->format('d.m.Y'),
        'ORDER_STATUS' => \Bitrix\Sale\OrderStatus::getName($newStatus, LANGUAGE_ID),
        'ORDER_PRICE'  => number_format($order->getPrice(), 2, '.', ' '),
        'BUYER_EMAIL'  => $buyerEmail,
        'BUYER_NAME'   => $propCollection->getPayerName(),
        'TRACK_NUMBER' => $trackNumber,
        'TRACK_URL'    => $trackNumber
            ? 'https://track.pochta.ru/tracking#' . $trackNumber
            : '',
    ]);
});

Раздельные шаблоны по статусам

Один шаблон для всех статусов — плохое решение: письмо «Заказ выполнен» должно отличаться от «Заказ отменён». Создаём отдельные типы событий:

\CEventType::Add([
    'EVENT_NAME'  => 'SALE_STATUS_DELIVERING',
    'LID'         => 's1',
    'NAME'        => 'Заказ передан в доставку',
    'FIELDS'      => [
        ['ID' => 'ORDER_ID',      'NAME' => 'Номер заказа'],
        ['ID' => 'TRACK_NUMBER',  'NAME' => 'Трек-номер'],
        ['ID' => 'TRACK_URL',     'NAME' => 'Ссылка для отслеживания'],
        ['ID' => 'DELIVERY_NAME', 'NAME' => 'Служба доставки'],
        ['ID' => 'BUYER_EMAIL',   'NAME' => 'Email покупателя'],
        ['ID' => 'BUYER_NAME',    'NAME' => 'Имя покупателя'],
    ],
]);

Для каждого статуса — отдельный HTML-шаблон: трек-ссылка для «Доставка», причина и инструкция для «Отменён».

SMS-уведомления

AddEventHandler('sale', 'OnSaleStatusOrderChange', function(\Bitrix\Main\Event $event) {
    $order = $event->getParameter('ENTITY');
    if ($order->getField('STATUS_ID') !== 'DELIVERING') return;

    $phone = preg_replace('/\D/', '', $order->getPropertyCollection()->getPhone());
    if (!$phone) return;

    $text = "Заказ #{$order->getId()} передан в доставку.";
    $trackNumber = getOrderTrackNumber($order);
    if ($trackNumber) $text .= " Трек: {$trackNumber}";

    sendSms($phone, $text); // ваша интеграция с SMS-шлюзом
});

Уведомления менеджерам при проблемных статусах

if ($newStatus === 'RETURN_INIT') {
    $managerEmail = getOrderManagerEmail($order);
    if ($managerEmail) {
        \CEvent::Send('SALE_RETURN_INITIATED', SITE_ID, [
            'ORDER_ID'      => $order->getId(),
            'MANAGER_EMAIL' => $managerEmail,
            'BUYER_NAME'    => $propCollection->getPayerName(),
            'BUYER_PHONE'   => $propCollection->getPhone(),
            'ORDER_PRICE'   => number_format($order->getPrice(), 2, '.', ' '),
        ]);
    }
}

Сроки выполнения

Настройка стандартных уведомлений по 3–5 статусам с кастомными шаблонами — 4–8 часов. Раздельные шаблоны, SMS, уведомления менеджерам, полное тестирование — 1–2 рабочих дня.