Настройка трекинга отправлений на 1С-Битрикс

Настройка трекинга отправлений на 1С-Битрикс

Трекинг отправлений — задача, которая на первый взгляд кажется простой, пока не начинаешь делать её правильно. «Показывать статус заказа» означает: получать актуальный статус от перевозчика, хранить историю статусов, уведомлять покупателя при изменении, корректно отображать в личном кабинете. На практике это требует грамотной архитектуры, отказоустойчивого агента и интеграции с разными API. Мы, сертифицированные специалисты 1С-Битрикс, собрали проверенное решение под ключ. Ручная проверка статусов — дорогое удовольствие: оператор тратит в среднем 5 минут на один заказ, а при 500 заказах в месяц это 40–60 рабочих часов. Автоматизация трекинга в 5 раз эффективнее ручной проверки и окупается за несколько месяцев.

Почему ручная проверка статусов неэффективна?

Каждый сервис доставки имеет свой формат API, ограничения по частоте запросов и способы авторизации. Например, СДЭК использует OAuth-токены и возвращает детальный статус с 30+ кодами, а Почта России требует ключ доступа и работает через SOAP. Мы реализуем абстракцию: единый интерфейс TrackerInterface, под который пишем конкретных трекеров. Это упрощает добавление новых перевозчиков и замену устаревших. Автоматизированный трекинг в 5 раз снижает нагрузку на поддержку по сравнению с ручным — это подтверждают проекты с внедрением.

Проблемы, которые решает трекинг

Типичные боли интернет-магазина: клиенты звонят «где мой заказ?», операторы тратят часы на ручную проверку статусов, потерянные посылки выявляются слишком поздно. Автоматический трекинг снимает эти проблемы:

• Снижение нагрузки на поддержку на 60–70% — покупатель видит статусы сам.
• Раннее обнаружение сбоев — если статус не обновляется более N дней, система шлёт алерт.
• Увеличение лояльности — прозрачность процесса ускоряет принятие решения о повторной покупке (рост повторных заказов на 15–20% по данным наших проектов).

Почему автоматический трекинг выгоднее ручного?

Автоматизация трекинга окупается за счёт снижения затрат на поддержку и уменьшения числа отмен заказов из-за неопределённости. В одном из проектов после внедрения количество запросов в тикеты по доставке сократилось на 70%, а повторные покупки выросли на 15%. Кроме того, система сама фиксирует задержки доставки — вы сможете оперативно реагировать. Сравните: ручная проверка 500 заказов занимает ~40 часов в месяц, автоматизированный агент — 0.5 часа на сервер.

Как настроить трекинг: пошаговая инструкция

1. Анализ — определяем перевозчиков и их API, согласовываем структуру данных.
2. Проектирование — создаём таблицу истории (HL-блок или кастомная ORM-таблица) и агента.
3. Реализация — пишем классы-трекеры для каждого перевозчика, настраиваем крон.
4. Страница в ЛК — разрабатываем компонент для отображения истории статусов.
5. Уведомления — настраиваем email-шаблоны при смене статуса.
6. Тестирование — проверяем на тестовых заказах, логируем ошибки.
7. Деплой и документация — передаём код, доступы, обучаем вашего разработчика.

Как мы это делаем: стек и пример реализации

Используем штатные механизмы Битрикс: агенты, ORM, инфоблоки v2.0. Для хранения истории создаём таблицу custom_tracking_history (HL-блок или кастомная таблица через ORM). Агент опрашивает API перевозчиков для заказов в активных статусах (N, P, Q). Пример базовой структуры:

// Таблица истории трекинга (миграция) class TrackingHistoryTable extends \Bitrix\Main\ORM\Data\DataManager { public static function getTableName(): string { return 'custom_tracking_history'; } public static function getMap(): array { return [ new \Bitrix\Main\ORM\Fields\IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new \Bitrix\Main\ORM\Fields\IntegerField('ORDER_ID'), new \Bitrix\Main\ORM\Fields\StringField('CARRIER'), // sdek, boxberry, etc. new \Bitrix\Main\ORM\Fields\StringField('TRACK_NUMBER'), new \Bitrix\Main\ORM\Fields\StringField('STATUS_CODE'), new \Bitrix\Main\ORM\Fields\StringField('STATUS_TEXT'), new \Bitrix\Main\ORM\Fields\StringField('LOCATION'), // текущее местонахождение new \Bitrix\Main\ORM\Fields\DatetimeField('STATUS_DATE'), new \Bitrix\Main\ORM\Fields\DatetimeField('CREATED_AT'), ]; } } 

Агент циклически опрашивает заказы и при изменении статуса сохраняет запись и отправляет уведомление. Код агента:

class DeliveryTrackingAgent { public static function run(): string { // Выбираем заказы с трекинг-номерами в активных статусах $orders = \Bitrix\Sale\Order::getList([ 'filter' => [ '!PROPERTY_TRACK_NUMBER' => false, 'STATUS_ID' => ['N', 'P', 'Q'], // не закрыты ], 'select' => ['ID', 'PROPERTY_TRACK_NUMBER', 'PROPERTY_CARRIER_CODE'], ]); $carriers = [ 'sdek' => new SdekTracker(), 'boxberry' => new BoxberryTracker(), 'pochta' => new PochtaTracker(), ]; while ($order = $orders->fetch()) { $carrier = $carriers[$order['PROPERTY_CARRIER_CODE_VALUE']] ?? null; if (!$carrier) continue; try { $status = $carrier->getStatus($order['PROPERTY_TRACK_NUMBER_VALUE']); self::saveStatus($order['ID'], $status); } catch (\Throwable $e) { // логируем, не падаем \Bitrix\Main\Diag\Debug::writeToFile($e->getMessage(), 'tracking', '/local/logs/tracking.log'); } } return __CLASS__ . '::run();'; } private static function saveStatus(int $orderId, array $status): void { // Проверяем, изменился ли статус $last = TrackingHistoryTable::getRow([ 'filter' => ['ORDER_ID' => $orderId], 'order' => ['STATUS_DATE' => 'DESC'], 'select' => ['STATUS_CODE'], ]); if ($last && $last['STATUS_CODE'] === $status['code']) return; // не изменился TrackingHistoryTable::add([ 'ORDER_ID' => $orderId, 'STATUS_CODE' => $status['code'], 'STATUS_TEXT' => $status['text'], 'LOCATION' => $status['location'] ?? '', 'STATUS_DATE' => new \Bitrix\Main\Type\DateTime($status['date']), 'CREATED_AT' => new \Bitrix\Main\Type\DateTime(), ]); // Отправить уведомление при смене статуса self::notifyCustomer($orderId, $status); } } 

// В методе notifyCustomer $event = new \Bitrix\Main\Mail\Event(array( 'EVENT_NAME' => 'TRACKING_STATUS_CHANGED', 'LID' => SITE_ID, 'C_FIELDS' => array( 'ORDER_ID' => $orderId, 'STATUS_TEXT' => $status['text'], 'TRACK_NUMBER' => $trackNumber, ), )); $event->send(); 

Страница трекинга в личном кабинете

Для отображения истории в личном кабинете используется компонент, который выбирает данные из TrackingHistoryTable. Пример получения данных:

// Компонент отображения истории трекинга $orderId = (int)$_REQUEST['ORDER_ID']; $order = \Bitrix\Sale\Order::load($orderId); if ($order && $order->getUserId() === $USER->GetID()) { $history = TrackingHistoryTable::getList([ 'filter' => ['ORDER_ID' => $orderId], 'order' => ['STATUS_DATE' => 'ASC'], 'select' => ['STATUS_CODE', 'STATUS_TEXT', 'LOCATION', 'STATUS_DATE'], ])->fetchAll(); // Трекинговый номер для ссылки на сайт перевозчика $trackNumber = $order->getPropertyCollection() ->getItemByOrderPropertyCode('TRACK_NUMBER') ?->getValue(); } 

Что входит в работу под ключ

• Анализ текущих заказов и используемых перевозчиков.
• Разработка таблицы истории трекинга (HL-блок или кастомная таблица).
• Написание классов-трекеров для каждого перевозчика.
• Настройка агента с логированием и обработкой ошибок.
• Разработка страницы истории в личном кабинете покупателя.
• Email-уведомления при смене статуса (шаблоны писем).
• Документация и инструкция по добавлению новых перевозчиков.
• Передача доступов к серверу и коду, обучение вашего разработчика.
• Техническая поддержка в течение месяца после сдачи.

Сроки

Хотите получить консультацию по своему проекту? Свяжитесь с нами — мы оценим объём работ и предложим оптимальное решение. Опыт реализации — более 20 проектов с трекингом, гарантия качества и соблюдение сроков. Получите бесплатную оценку вашего проекта — просто напишите нам.