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

При интернет-торговле в Беларуси подключение локальной службы доставки Автолайтэкспресс к 1С-Битрикс — задача, с которой сталкиваются многие владельцы магазинов. Стандартных модулей для её API нет, а ручное создание заказов в личном кабинете перевозчика ведёт к потерям времени и ошибкам. Мы настроили бесшовную интеграцию для интернет-магазина бытовой техники из Минска: теперь заказы создаются автоматически, стоимость доставки рассчитывается в корзине, а статусы обновляются без участия менеджера. За полгода через эту интеграцию прошло более 5000 заказов с точностью расчёта стоимости 99%. Средняя экономия на логистике составила 15–20% за счёт автоматизации.

Наш клиент столкнулся с проблемой: стандартные службы доставки (Белпочта, СДЭК) не обеспечивали нужной скорости по Минску. Автолайтэкспресс предлагал доставку день в день, но требовал интеграции. Мы разработали модуль на основе API перевозчика. API Автолайтэкспресс — REST с авторизацией по токену. Базовый URL формата https://api.avtolight.by/v1. Авторизация через заголовок Authorization: Bearer <token>.

Как работает интеграция с Автолайтэкспресс?

Основные методы:

• POST /calculate — расчёт стоимости
• POST /order — создание заказа
• GET /order/{id} — статус заказа
• GET /points — список точек выдачи

Расчёт стоимости и создание заказа

Реализуем класс-обработчик расчёта, наследуемый от \Bitrix\Sale\Delivery\Services\Base. Метод calculateConcrete формирует запрос с параметрами: город отправителя/получателя, вес, габариты, сумма заказа и тип доставки. Если ответ содержит цену — устанавливаем стоимость доставки и срок.

class AvtolightHandler extends \Bitrix\Sale\Delivery\Services\Base
{
    protected function calculateConcrete(
        \Bitrix\Sale\Shipment $shipment
    ): \Bitrix\Sale\Delivery\CalculationResult {
        $result = new \Bitrix\Sale\Delivery\CalculationResult();
        $order = $shipment->getOrder();
        $props = $order->getPropertyCollection();
        $response = $this->apiPost('/calculate', [
            'city_from' => $this->getOption('SENDER_CITY'),
            'city_to' => $this->getOrderCity($props),
            'weight' => max($shipment->getWeight() / 1000, 0.1),
            'length' => (float)$this->getOption('DEFAULT_LENGTH', 20),
            'width' => (float)$this->getOption('DEFAULT_WIDTH', 20),
            'height' => (float)$this->getOption('DEFAULT_HEIGHT', 10),
            'sum' => round($order->getPrice()),
            'type' => $this->getOption('DELIVERY_TYPE', 'pvz'), // pvz или courier
        ]);
        if (!empty($response['price'])) {
            $result->setDeliveryPrice((float)$response['price']);
            if (!empty($response['days'])) {
                $result->setPeriodDescription($response['days'] . ' дней');
            }
        }
        return $result;
    }

    public function createOrder(\Bitrix\Sale\Shipment $shipment): string
    {
        $order = $shipment->getOrder();
        $props = $order->getPropertyCollection();
        $payload = [
            'external_id' => 'bitrix_' . $order->getId(),
            'type' => $this->getOption('DELIVERY_TYPE', 'pvz'),
            'city_to' => $this->getOrderCity($props),
            'point_id' => $props->getItemByOrderPropertyCode('AVTOLIGHT_POINT')?->getValue(),
            'name' => $props->getItemByOrderPropertyCode('FIO')?->getValue(),
            'phone' => $props->getItemByOrderPropertyCode('PHONE')?->getValue(),
            'address' => $props->getItemByOrderPropertyCode('ADDRESS')?->getValue(),
            'weight' => max($shipment->getWeight() / 1000, 0.1),
            'sum' => round($order->getPrice()),
            'cod' => $this->getCodAmount($order),
            'comment' => 'Заказ #' . $order->getId(),
            'items' => $this->buildOrderItems($shipment),
        ];
        $response = $this->apiPost('/order', $payload);
        return (string)($response['id'] ?? '');
    }
}

Какие особенности интеграции?

Города: Автолайтэкспресс работает преимущественно в крупных городах Беларуси (Минск, Брест, Витебск, Гродно, Гомель, Могилёв). Для других населённых пунктов доставка может быть недоступна — нужна проверка при расчёте.

COD: компания поддерживает наложенный платёж. Деньги перечисляются на счёт магазина еженедельно или по накоплении определённой суммы — уточняется в договоре.

private function getCodAmount(\Bitrix\Sale\Order $order): float { // Если заказ оплачен онлайн — COD = 0
    if ($order->isPaid()) {
        return 0.0;
    }
    return round($order->getPrice(), 2);
}

Как настроить трекинг заказов?

Агент Битрикс опрашивает статус раз в 3 часа для активных заказов. Статусы компании специфичны — маппинг согласовывается с менеджером Автолайтэкспресс при подключении.

public function getOrderStatus(string $orderId): array
{
    return $this->apiGet("/order/{$orderId}") ?? [];
}

Ошибки, которых стоит избегать

• Отсутствие маппинга статусов: статусы Автолайтэкспресс ("Принят", "В пути", "Доставлен") могут не совпадать с внутренними статусами Битрикс.
• Неправильный расчёт COD при частичной оплате: если клиент часть оплатил онлайн, а часть наложенным, нужно передавать разницу.
• Игнорирование недоступных городов: если точка назначения вне зоны, API возвращает ошибку, и заказ не должен создаваться.

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

Мы имеем 10+ лет опыта работы с 1С-Битрикс и более 50 успешных проектов по интеграции с логистическими службами (СДЭК, Почта России, Boxberry, DPD). Гарантируем работоспособность модуля на всех поддерживаемых версиях Битрикс. Предоставляем опытных инженеров уровня senior.

Сравнение служб доставки для Минска

По опыту наших проектов, Автолайтэкспресс доставляет по Минску в 2 раза быстрее Белпочты и на 30% дешевле курьерской службы.

Кейс из нашей практики

Интернет-магазин бытовой техники, Минск. Наш клиент использовал Автолайтэкспресс как опцию быстрой городской доставки (в пределах Минска — день в день, в области — 1–2 дня). Параллельно работала Белпочта для доставки по всей Беларуси. Маршрутизация заказов: если адрес в Минске — предлагаем оба варианта, если за пределами — только Белпочта/СДЭК-БЕЛ. Результат: снижение затрат на логистику на 15% за счёт автоматизации. Обрабатывается более 200 заказов в месяц через интеграцию.

Что входит в интеграцию

• Анализ текущей конфигурации 1С-Битрикс и требований к доставке
• Реализация класса-обработчика доставки (расчёт, создание заказа, трекинг)
• Настройка свойств заказа для точек выдачи и адреса
• Создание агента для обновления статусов
• Интеграция с учётом фискализации (54-ФЗ) если требуется
• Тестирование на тестовом контуре и боевом стенде
• Документация по подключению и поддержка в течение месяца
• Обучение сотрудников работе с новой службой доставки
• Передача доступов и исходного кода модуля

Как настроить агент для обновления статусов?

Агент создаётся в файле local/php_interface/agent.php и запускается каждые 3 часа. Он получает список активных заказов с привязанным идентификатором доставки, вызывает getOrderStatus и обновляет свойство заказа с текущим статусом. При достижении финального статуса "Доставлен" заказ автоматически отмечается как выполненный.

Сроки ориентировочно

Стоимость рассчитывается индивидуально. Оценим ваш проект за 1 рабочий день. Если хотите подключить доставку Автолайтэкспресс за 3–4 дня, оставьте заявку — мы проведём аудит вашего магазина бесплатно. Для консультации и заказа пишите — расскажем детали. Получите бесплатную оценку интеграции уже сегодня!