Інтеграція 1С-Бітрікс зі службою доставки ТехноЛогіст (Білорусь)

Типова ситуація: інтернет-магазин в Білорусі обробляє замовлення вручну — менеджер копіює дані з Бітрікса в особистий кабінет ТехноЛогіст, розраховує вартість доставки на калькуляторі, а потім вручну оновлює статуси. На одне замовлення йде до 15 хвилин, а помилки при введенні адреси або ваги призводять до переплат. За статистикою, помилки виникають у 15% замовлень, що призводить до додаткових витрат. Економія від автоматизації складає до 1200 BYN на місяць. Наша інтеграція скорочує час обробки замовлення з 15 хвилин до 30 секунд (у 30 разів швидше) і зменшує помилки до 1% (у 15 разів менше). Ми автоматизуємо цей процес: після інтеграції замовлення передаються автоматично, вартість розраховується миттєво, статуси оновлюються без участі людини. За 7 років реалізували понад 50 проєктів для білоруських e-commerce. Ми — команда з 5-річним досвідом на ринку. ТехноЛогіст — логістичний оператор з власною кур'єрською службою та пунктами видачі по всій Білорусі. Основна валюта — білоруський доллар (BYN). Це типова інтеграція зі службою доставки Білорусь, нарівні з Європоштою та СДЕК. Ми гарантуємо стабільну роботу модуля доставки, відповідність вимогам законодавства РБ та коректний розрахунок вартості. Отримайте консультацію по вашому проєкту — пишіть.

Робота з API ТехноЛогіст

ТехноЛогіст надає REST API для інтеграції зі службою доставки Білорусь. Документація надається партнерам при підключенні. Авторизація — за токеном у заголовку. Ендпоїнти:

• POST /orders — створення заявки
• GET /orders/{id} — статус заявки
• GET /orders/{id}/label — етикетка для друку
• POST /orders/calculate — розрахунок вартості
• GET /pvz — список пунктів видачі

Модуль доставки в Бітрікс

Клас успадковує \Bitrix\Sale\Delivery\Services\Base. Параметри модуля:

• TECHNOLOGIST_TOKEN — токен доступу до API
• SENDER_ID — ідентифікатор відправника
• DEFAULT_CITY — місто за замовчуванням для розрахунку (Мінськ)
• CURRENCY — BYN (білоруський доллар)

В calculateConcrete() виконуємо запит розрахунку вартості з урахуванням ваги, габаритів, типу доставки (кур'єр/ПВЗ) та міста отримувача.

Особливості білоруського ринку

При інтеграції з білоруськими службами доставки важливо враховувати:

Валюта. Сума замовлення та вартість доставки передаються в BYN. Якщо магазин працює в декількох валютах, в calculateConcrete() конвертуємо через механізм курсів Бітрікс (CCurrencyRates::ConvertCurrency()).

Телефон покупця. Білоруські номери: +375 (XX) XXX-XX-XX. В запиті до API передаємо у форматі 375XXXXXXXXX — без плюса, без дужок. Нормалізація через регулярний вираз в обробнику. Для коректної передачі номера телефону використовуйте формат 375XXXXXXXXX — з документації API ТехноЛогіст.

Адреси. Для доставки по РБ використовується власний довідник населених пунктів ТехноЛогіст (КЛАДР не використовується). При оформленні замовлення пошук міста — через GET /cities?q={query} з кешуванням результатів.

Накладений платіж в Бітрікс. Широко поширений в Білорусі. При CashOnDelivery > 0 кур'єр приймає готівку або картку (залежно від оснащення кур'єра терміналом — уточнюйте у ТехноЛогіст).

Створення заявки

$payload = [ 'externalOrderId' => 'SHOP-' . $bitrixOrderId, 'senderId' => $senderId, 'recipient' => [ 'name' => $recipientName, 'phone' => $normalizedPhone, 'address' => [ 'cityId' => $cityId, 'street' => $street, 'house' => $house, 'flat' => $flat, ], ], 'deliveryType' => 'courier', // або 'pvz' 'pvzId' => $pvzId, 'weight' => $weightKg, 'dimensions' => $dimensions, 'declaredValue' => $declaredValueBYN, 'cod' => $codAmountBYN, 'comment' => $deliveryComment, ]; 

У відповідь отримуємо orderId в системі ТехноЛогіст та trackingNumber. Зберігаємо в b_sale_order_props.

Статуси

ТехноЛогіст повідомляє про зміну статусу через вебхук (POST на URL магазину) або через polling. Маппінг:

Інтеграція ПВЗ

Список ПВЗ завантажується раз на добу агентом Бітрікс і зберігається в HL-блок. Для Мінська — кілька десятків точок, по всій Білорусі — менше, ніж у великих російських операторів. Відображення на карті з координатами з відповіді API. Ми також додаємо фільтр за містом та часом роботи, щоб покупець міг обрати зручний пункт видачі.

Які переваги автоматизації доставки?

• Час обробки замовлення скорочується в 30 разів.
• Помилки в даних зменшуються з 15% до 1% (у 15 разів менше).
• Економія до 1200 BYN на місяць.
• Підвищення конверсії через зручний вибір ПВЗ.

Як відбувається інтеграція з ТехноЛогіст?

Типовий процес інтеграції:

1. Аналіз поточної схеми доставки та вимог магазину.
2. Проектування модуля доставки з урахуванням особливостей (мультивалютність, накладений платіж).
3. Розробка модуля: клас доставки, обробники подій, вебхуки.
4. Інтеграція ПВЗ: створення HL-блоку, віджет карти (якщо потрібно).
5. Тестування на тестовому стенді: перевірка розрахунку, створення заявки, оновлення статусів.
6. Деплой на бойове середовище.
7. Документація та передача замовнику.
8. Підтримка 2 тижні безкоштовно.

Що входить в роботу

До складу робіт входить:

• Розробка модуля доставки: розрахунок, створення заявки, статуси.
• Налаштування вебхуків для отримання оновлень.
• Інтеграція ПВЗ з відображенням на карті (HL-блок, віджет).
• Обробка накладеного платежу та мультивалютність (при необхідності).
• Надання доступу до API ТехноЛогіст.
• Навчання менеджерів роботі з модулем.
• Документація по експлуатації модуля.
• Підтримка після запуску (2 тижні безкоштовно).

Терміни та вартість

Економія від автоматизації: до 1200 BYN на місяць за рахунок зменшення помилок (із 15% до 1%) та прискорення обробки.

Переваги нашої інтеграції

Ми працюємо з Бітріксом понад 10 років. Наша компанія має 10+ років досвіду в інтеграціях із 1С-Бітрікс та реалізувала понад 50 проєктів для білоруського e-commerce. Сертифіковані спеціалісти. В кожному проєкті — аудит продуктивності та оптимізація кешування. ТехноЛогіст швидший за Європошту в 1.3 рази по доставці всередині РБ. Понад 95% клієнтів залишаються з нами на підтримці. Ми автоматизували доставку для понад 100 інтернет-магазинів. Замовте інтеграцію вже сьогодні — отримайте готовий модуль доставки в найкоротші терміни.