Настройка трекинга отправлений на 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 часа на сервер.
Как настроить трекинг: пошаговая инструкция
- Анализ — определяем перевозчиков и их API, согласовываем структуру данных.
- Проектирование — создаём таблицу истории (HL-блок или кастомная ORM-таблица) и агента.
- Реализация — пишем классы-трекеры для каждого перевозчика, настраиваем крон.
- Страница в ЛК — разрабатываем компонент для отображения истории статусов.
- Уведомления — настраиваем email-шаблоны при смене статуса.
- Тестирование — проверяем на тестовых заказах, логируем ошибки.
- Деплой и документация — передаём код, доступы, обучаем вашего разработчика.
Как мы это делаем: стек и пример реализации
Используем штатные механизмы Битрикс: агенты, 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();
}
| Перевозчик | Ссылка для трекинга |
|---|---|
| СДЭК | https://www.cdek.ru/ru/tracking?order_id={track} |
| Boxberry | https://boxberry.ru/tracking/?id={track} |
| Почта России | https://www.pochta.ru/tracking#{track} |
| Яндекс Доставка | Через личный кабинет по claim_id |
Что входит в работу под ключ
- Анализ текущих заказов и используемых перевозчиков.
- Разработка таблицы истории трекинга (HL-блок или кастомная таблица).
- Написание классов-трекеров для каждого перевозчика.
- Настройка агента с логированием и обработкой ошибок.
- Разработка страницы истории в личном кабинете покупателя.
- Email-уведомления при смене статуса (шаблоны писем).
- Документация и инструкция по добавлению новых перевозчиков.
- Передача доступов к серверу и коду, обучение вашего разработчика.
- Техническая поддержка в течение месяца после сдачи.
Сроки
| Этап | Срок |
|---|---|
| Агент трекинга + история статусов | 2–3 дня |
| + Страница трекинга в ЛК | +1 день |
| + Email-уведомления при смене статуса | +1 день |
Хотите получить консультацию по своему проекту? Свяжитесь с нами — мы оценим объём работ и предложим оптимальное решение. Опыт реализации — более 20 проектов с трекингом, гарантия качества и соблюдение сроков. Получите бесплатную оценку вашего проекта — просто напишите нам.