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

Типичная ситуация: интернет-магазин в Беларуси обрабатывает заказы вручную — менеджер копирует данные из Битрикса в личный кабинет ТехноЛогист, рассчитывает стоимость доставки на калькуляторе, а затем вручную обновляет статусы. На один заказ уходит до 15 минут, а ошибки при вводе адреса или веса приводят к переплатам. Мы автоматизируем этот процесс: после интеграции заказы передаются автоматически, стоимость рассчитывается мгновенно, статусы обновляются без участия человека. За 7 лет реализовали более 50 проектов для белорусских e-commerce. ТехноЛогист — логистический оператор с собственной курьерской службой и пунктами выдачи по всей Беларуси. Основная валюта — белорусский доллар (BYN). Интеграция с ним — востребованная задача для рынка РБ, наравне с Европочтой и СДЭК. Мы гарантируем стабильную работу модуля доставки, соответствие требованиям 54-ФЗ и корректный расчёт стоимости. Получите консультацию по вашему проекту — пишите.

Как работает 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 курьер принимает наличные или карту (в зависимости от оснащения курьера терминалом — уточняйте у ТехноЛогиста). Средняя экономия на логистике при наложенном платеже составляет около 15% по сравнению с предоплатой.

Создание заявки

$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. Мы также добавляем фильтр по городу и времени работы, чтобы покупатель мог выбрать удобный пункт выдачи.

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

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

Что входит в интеграцию под ключ?

В состав работ входит:

• Разработка модуля доставки: расчёт, создание заявки, статусы.
• Настройка вебхуков для получения обновлений.
• Интеграция ПВЗ с отображением на карте (HL-блок, виджет).
• Обработка наложенного платежа и мультивалютность (при необходимости).
• Тестирование на тестовом стенде и боевом окружении.
• Документация по эксплуатации модуля.
• Поддержка после запуска (2 недели бесплатно).

Сроки

Почему выбирают нашу интеграцию?

Мы работаем с Битриксом более 10 лет. Сертифицированные специалисты. В каждом проекте — аудит производительности и оптимизация кэширования. ТехноЛогист быстрее Европочты в среднем на 30% по доставке внутри РБ. Закажите интеграцию уже сегодня — получите готовый модуль доставки в кратчайшие сроки.