Інтеграція 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 інтернет-магазинів. Замовте інтеграцію вже сьогодні — отримайте готовий модуль доставки в найкоротші терміни.

Інтеграція доставки: від розрізнених API до єдиного калькулятора за 5 днів

Покупець кидає кошик на етапі доставки — не бачить розрахунку або бачить свідомо невірну ціну. Кожен такий випадок втрачає конверсію. Автоматизація логістики в 1С-Бітрікс вирішує цю проблему: ми підключаємо служби доставки так, щоб ціна показувалася миттєво, а трекінг оновлювався без участі менеджера. Більше 50 реалізованих проєктів з каталогами від 500 до 100 000 SKU, досвід понад 8 років. Середній час підключення однієї транспортної компанії — 4 дні.

Як прискорити підключення служб доставки до 1С-Бітрікс?

Головна складність — не сам виклик API, а адаптація до логіки кожного перевізника. СДЕК, Boxberry, Нова пошта, ПЕК, DPD — у кожного свій формат запиту, тарифікація та обробка помилок. Ми використовуємо готові адаптери під кожну ТК, що скорочує час інтеграції втричі порівняно з реалізацією з нуля. Розгорнутий кейс: інтернет-магазин товарів для дому (15 000 товарів) — підключили СДЕК та Boxberry за 5 днів, автоматизували розрахунок та створення замовлень. Звернення до підтримки з доставки знизилися на 60%, середній чек зріс на 8% за рахунок індикатора безкоштовної доставки.

Чому API кожної транспортної компанії — окремий квест?

СДЕК — об'ємна вага та карта ПВЗ

API v2 (/api/v2/calculator/tarifflist) приймає габарити, вагу та адреси — повертає всі доступні тарифи. Підводні камені: об'ємна вага розраховується за формулою (Д × Ш × В) / 5000. Якщо фізична вага 2 кг, а об'ємна 8 кг — СДЕК бере по об'ємній. Не врахуєте в калькуляторі — покупець побачить одну ціну, а заплатить іншу. Карта ПВЗ завантажується через /deliverypoints. Віджет СДЕК можна вбудувати, але він конфліктує зі стилями Бітрікс — малюємо свою карту на Яндекс.Картах. Автоматичне створення замовлення через /api/v2/orders — при оформленні заявка летить у СДЕК, повертається трек-номер. Друк накладних та етикеток з адмінки — через /api/v2/print/orders. Тарифи: склад-склад, склад-двері, двері-двері, експрес, постамат.

Boxberry — широка мережа ПВЗ в регіонах

Найширша мережа пунктів видачі в малих містах. API простіше, ніж у СДЕК, але є нюанси з післяплатою та частковим викупом. Типові помилки при інтеграції: відсутність фільтрації ПВЗ за ознакою onlyPrepaid → помилки при післяплаті; ігнорування параметра partialReturn → ламає частковий викуп. API повертає код міста у форматі "770000000000" — потрібне маппінг на index міста.

Нова пошта — лідер українського ринку

Для України — обов'язкове підключення Нової пошти через API v2. Розрахунок вартості, створення ЕН, друк накладної, трекінг. Карта відділень з фільтрацією (поштомати, прийом платежів). Асинхронне оновлення статусів через агент Бітрікс кожні 15 хвилин.

ПЕК — важкі вантажі та збір

Коли потрібно відправити диван або обладнання. Розрахунок збірних вантажів, страхування, обрешітка. Доставка до терміналу та від дверей до дверей. Індекси терміналів ПЕК підвантажуємо в інфоблок для автопідстановки.

DPD — експрес-доставка з часовими слотами

DPD по Україні та за кордон. Доставка у вибраний часовий інтервал, повернення підписаних документів. У розрахунку враховуємо об'ємну вагу за формулою (Д×Ш×В)/4000 — відмінність від СДЕК. Документація DPD: volumetric weight factor 4000.

Як об'єднати різні ТК в єдиному калькуляторі?

Використовуємо гібридний підхід: модуль-агрегатор, який маршрутизує запити до різних API та нормалізує відповіді. Він обробляє запити в 5 разів швидше, ніж окремі інтеграції, завдяки паралельним викликам через curl_multi. У відповіді модуля — єдина структура: назва тарифу, ціна, термін, тип доставки. Кешування теговане: при зміні налаштувань модуля очищується лише кеш розрахунку для обраного міста, решта залишається. Подію OnBeforeDeliveryCalculate вішаємо на кастомний обробник — так підміняємо стандартну логіку доставки.

Розрахунок вартості: які граблі зустрічаються?

Автоматичний калькулятор підсумовує фізичну та об'ємну вагу товарів у кошику, додає вагу упаковки, обирає найбільшу. Звучить просто, але:

• Габарити мають бути заповнені у кожного товару. Немає габаритів — немає розрахунку. На каталозі в 10 000 SKU обов'язково знайдуться товари без розмірів — для них заводимо дефолтні значення (наприклад, 0.1×0.1×0.1 м) і попереджаємо менеджера через поштову подію.
• Промоакції та пороги безкоштовної доставки — гнучке налаштування: за сумою замовлення, для VIP-клієнтів, при конкретному способі оплати. Реалізуємо через користувацькі властивості кошика.
• Індикатор «До безкоштовної доставки залишилося N» — проста річ, але піднімає середній чек на 5–12%. Обчислюємо за сумою кошика та найближчим порогом, виводимо в шаблоні кошика.

Як автоматизувати трекінг, самовивіз та кур'єрську доставку?

Трекінг. Автоматичне опитування API транспортних компаній — агент Бітрікс кожні 30 хвилин перевіряє статуси замовлень, у яких STATUS_DELIVERY != 'DELIVERED'. При зміні — оновлення статусу замовлення в системі та повідомлення покупцеві (email, SMS, push). Вбудована сторінка трекінгу в особистому кабінеті — покупцю не потрібно йти на сайт ТК. Карта з поточним місцезнаходженням, прогнозована дата доставки, можливість переадресації.

Самовивіз. Власні точки видачі на карті: адреси, графік, контакти. Пошук найближчої за адресою покупця. Перевірка наявності в реальному часі, бронювання до певної години. QR-код для швидкого отримання та SMS про готовність до видачі.

Кур'єрська доставка. Зони доставки з різною вартістю. 2-годинні слоти, управління розкладом кур'єрів, обмеження замовлень на слот. Доставка день у день — прийом до 14:00, експрес за 2-4 години з націнкою за терміновість. Інтеграція з навігацією для оптимізації маршрутів.

Мультисклад. Декілька складів з адресами та зонами обслуговування. Автоматичний вибір складу відвантаження за адресою покупця — пріоритет найближчому, де є всі товари замовлення. Якщо на одному складі всього немає — розділення замовлення по складах (мультидоставка). Синхронізація залишків через 1С або WMS (CommerceML), використовуємо події OnBeforeBasketAdd для перевірки доступності.

Порівняння транспортних компаній

Етапи підключення служб доставки

1. Аналіз логістики (1–2 дні) — географія, середня вага, обсяг замовлень, інтеграція з 1С. Рекомендуємо комбінацію ТК.
2. Підключення API (3–5 днів на ТК) — налаштування розрахунків, карт ПВЗ, автоматичне створення замовлень через агенти та події.
3. Налаштування трекінгу (1–2 тижні) — агенти оновлення статусів, шаблони повідомлень, сторінка трекінгу.
4. Тестування (2–3 дні) — перевірка на реальних адресах, порівняння тарифів, контроль помилкових розрахунків, навантажувальне тестування.
5. Деплой та навчання (1 день) — вивантаження модуля, передача доступів, навчання менеджерів.
6. Гарантійна підтримка (1 місяць) — виправлення багів, коригування конфігурацій, доналаштування кешування.

Що входить у вартість інтеграції

• Документація зі схемою обміну (логістичні маршрути, тарифні зони).
• Налаштовані доступы до API кожної ТК, ключі, вебхуки.
• Шаблони повідомлень (email, SMS, push) для статусів доставки.
• Навчання менеджерів: робота з адмінкою, друк документів, обробка помилок.
• Півроку технічної підтримки після запуску.

Орієнтовні терміни реалізації

Терміни залежать від кількості ТК, складності каталогу та необхідності інтеграції з 1С/ERP. Вартість розраховується індивідуально — орієнтуйтеся на економію: зниження операційних витрат на доставку до 40% та скорочення звернень до підтримки на 60%. Наприклад, один із клієнтів з магазином електроніки (20 000 товарів) повернув інвестиції за 3 місяці за рахунок зменшення кількості «забутих» замовлень. Середня економія наших клієнтів — 15 000 грн на місяць на логістиці.

Готові прискорити логістику вашого інтернет-магазину? Зв'яжіться з нами — допоможемо підібрати оптимальну комбінацію ТК під ваш асортимент та бюджет. Замовте консультацію — і ми підготуємо пропозицію за 1 робочий день.