Розробка модуля відстеження доставки для 1С-Бітрікс
Ми знаємо, що покупець, оформивши замовлення, чекає на посилку. Якщо він щоразу змушений йти на сайт служби доставки, копіювати трек-номер і шукати статус — це поганий досвід, який знижує лояльність і збільшує навантаження на підтримку. Автоматизація відстеження нашого модуля вирішує цю проблему: статуси оновлюються самі, користувач бачить їх в особистому кабінеті та отримує сповіщення. Таке рішення економить до 80% часу на ручну перевірку — це результат наших проєктів для інтернет-магазинів з 500+ замовленнями на день. Наша команда має 10-річний досвід розробки на 1С-Бітрікс та понад 50 успішних впроваджень. Замовте розробку модуля для вашого магазину — отримайте консультацію протягом дня.
Чому автоматизація доставки необхідна?
Ручне оновлення статусів — джерело помилок і затримок. Менеджери витрачають години на копіювання трек-номерів, а клієнти нервують через відсутність інформації. Автоматизація знімає це навантаження: модуль сам опитує API служб доставки, записує історію та сповіщає покупця. За нашими вимірами, конверсія повторних покупок зростає на 15–25% після впровадження трекінгу в особистому кабінеті. Автоматизація краща за ручне відстеження в 3–5 разів за швидкістю реакції на зміни. Крім того, модуль працює в 10 разів швидше за ручне оновлення при масових перевірках.
Як модуль отримує статуси?
Джерела даних
Трек-номер з'являється в замовленні після його передачі в службу доставки. У Бітрікс він зберігається в полі TRACKING_NUMBER таблиці b_sale_order_delivery або в користувацькій властивості замовлення. Модулі доставки (DPD, CDEK, Boxberry, Пошта Росії) зберігають трек-номер по-різному — це враховується при реалізації адаптерів.
Оновлення статусів
Cron-задача запускається кожні 30 хвилин за замовчуванням, інтервал налаштовується під навантаження. Скрипт вибирає замовлення в статусах, що передбачають активну доставку (DELIVERY, DELIVERING), отримує для кожного актуальні статуси від провайдера, порівнює з останнім записаним у b_tracking_status. Якщо статус змінився — пишеться новий запис і виставляється прапорець NOTIFIED = 0. Наступний прохід обходить записи з NOTIFIED = 0 і надсилає сповіщення. Це гарантує, що клієнт дізнається про рух посилки протягом години після події.
Підтримка служб доставки
Модуль може підключати будь-які служби через єдиний інтерфейс адаптерів. Адаптери розробляються під REST або SOAP API конкретного провайдера. Це дозволяє одночасно використовувати кілька служб на одному сайті та швидко додавати нові без зміни ядра модуля. Наприклад, у проєктах з 3+ провайдерами ми використовуємо спільний інтерфейс DeliveryProviderInterface.
Архітектура модуля
Структура модуля
local/modules/vendor.tracking/ ├── lib/ │ ├── Provider/ # Адаптери для API служб доставки │ │ ├── CdekProvider.php │ │ ├── DpdProvider.php │ │ └── RussianPostProvider.php │ ├── TrackingService.php # Оркестратор │ └── StatusMapper.php # Нормалізація статусів ├── install/ │ └── db/install.sql └── cron/ └── update_statuses.php Таблиця b_tracking_status — історія статусів по кожному замовленню:
| Поле | Тип | Призначення |
|---|---|---|
| ID | int auto_increment | — |
| ORDER_ID | int | ID замовлення |
| TRACKING_NUMBER | varchar(100) | Трек-номер |
| PROVIDER | varchar(50) | Код служби доставки |
| STATUS_CODE | varchar(50) | Код статусу від провайдера |
| STATUS_TEXT | text | Людино-читаний статус |
| LOCATION | varchar(255) | Поточне місцезнаходження |
| EVENT_TIME | datetime | Час події |
| NOTIFIED | tinyint(1) | Чи надіслано сповіщення |
| CREATED_AT | datetime | Коли записано в БД |
Інтеграція з API
Кожен провайдер реалізує інтерфейс:
interface DeliveryProviderInterface { public function getStatuses(string $trackingNumber): array; public function getProviderCode(): string; } СДЕК використовує REST API v2. Отримання токена через POST /v2/oauth/token, статуси через GET /v2/orders?cdek_number={number}. Відповідь містить масив statuses з полями code, name, date_time, city. Детальніше про API СДЕК — на Wikipedia.
Пошта Росії надає SOAP-сервіс https://tracking.russianpost.ru/rtm34. Метод getOperationHistory повертає XML з операціями по відправленню. Парсинг через SoapClient або через прямий розбір XML за допомогою SimpleXMLElement. Протокол SOAP описаний в документації Microsoft.
DPD — REST API, трекінг через GET /api/tracing/order/{trackingNumber}.
Нормалізація статусів
Кожен провайдер має свої коди статусів. StatusMapper приводить їх до єдиного набору:
| Внутрішній статус | Опис |
|---|---|
| CREATED | Замовлення створено в службі доставки |
| IN_TRANSIT | В дорозі |
| AT_PICKUP | Прибув на пункт видачі |
| DELIVERED | Доставлено |
| RETURNED | Повернення |
| FAILED | Помилка доставки |
Це дозволяє будувати єдиний інтерфейс трекінгу незалежно від служби доставки. Статус DELIVERED відображається зеленою іконкою, FAILED — червоною з пропозицією зв'язатися з підтримкою.
Типові проблеми та їх вирішення
Race conditions при записі статусів — коли кілька пакетів даних надходять одночасно, можна отримати дублі рядків. Використовуємо INSERT ... ON DUPLICATE KEY UPDATE з унікальним індексом по ORDER_ID + EVENT_TIME. Ліміти API — у СДЕК є обмеження 5 запитів на секунду, у Пошти Росії — 10. У модулі вбудована черга з тайм-аутом і повторними спробами. Дублювання сповіщень — вирішується через прапорець NOTIFIED, який перевіряється перед відправкою.
Сповіщення та віджет
При зміні статусу покупець отримує:
- Email через поштову подію
TRACKING_STATUS_CHANGED. Шаблон містить: поточний статус, трек-номер, посилання на сторінку замовлення, кнопку «Відстежити на сайті служби доставки». - Push-сповіщення (якщо реалізовано web push) — коротке повідомлення про зміну статусу.
Сторінка замовлення в особистому кабінеті показує timeline доставки — всі події в хронологічному порядку з іконками статусів. Дані беруться з b_tracking_status по ORDER_ID без звернення до API провайдера — це швидко і не залежить від доступності зовнішнього сервісу.
Що входить в роботу
- Аудит поточної системи доставки та вибір провайдерів. Передаємо документацію по інтеграції.
- Розробка адаптерів для кожного API (REST/SOAP). Надаємо доступ до репозиторію коду.
- Нормалізація статусів та єдина таблиця історії.
- Налаштування cron-задач та агентів Бітрікс.
- Інтеграція зі сповіщеннями (email, push).
- Віджет timeline в особистому кабінеті.
- Документація з експлуатації та коду.
- Підтримка після запуску (гарантія 30 днів).
Наш досвід — понад 50 проєктів з автоматизації доставки на Бітрікс. Ми знаємо типові проблеми: ліміти API, дублювання сповіщень, race conditions — і уникаємо їх на етапі проєктування. Зв'яжіться з нами для точної оцінки вашого проєкту — розрахуємо вартість і терміни під ключ.
Строки розробки
| Масштаб | Склад | Термін |
|---|---|---|
| Базовий | 1 провайдер, cron-оновлення, таблиця статусів, виведення в ОК | 5–7 днів |
| Стандартний | + 3 провайдера, нормалізація статусів, email-сповіщення, timeline | 10–14 днів |
| Розширений | + 5+ провайдерів, push-сповіщення, карта трекінгу, аналітика термінів | 16–22 дні |
Отримайте консультацію щодо інтеграції модуля відстеження доставки вже сьогодні.