Інтеграція 1С-Бітрікс із сервісами оптимізації маршрутів

Інтеграція 1С-Бітрікс з сервісами оптимізації маршрутів

Сервіси оптимізації маршрутів — спеціалізовані API, які приймають список точок доставки та повертають оптимальний порядок відвідування. Популярні: Яндекс.Маршрутизація, Route4Me, Routific, OptimoRoute, Google OR-Tools (self-hosted). Інтеграція з Бітрікс — двосторонній трубопровід: дані замовлень йдуть до оптимізатора, готові маршрути повертаються назад.

Вибір сервісу оптимізації

Архітектура інтеграції

Цикл роботи виглядає так:

1. З ранку агент збирає замовлення на сьогодні зі статусом «На доставку» з b_sale_order
2. Формує список точок з адресами, координатами та часовими вікнами
3. Відправляє запит в API оптимізатора
4. Зберігає маршрути в bl_delivery_routes
5. Призначає водіїв через CRM або вручну
6. При завершенні доставки webhook від оптимізатора оновлює статуси замовлень

Загальний інтерфейс для роботи з оптимізаторами

Реалізуйте паттерн адаптер — один інтерфейс, кілька реалізацій:

interface RouteOptimizerInterface
{
    public function optimize(array $depot, array $vehicles, array $orders): array;
}

class YandexRouteOptimizer implements RouteOptimizerInterface
{
    public function optimize(array $depot, array $vehicles, array $orders): array
    {
        $payload = [
            'depot'    => $depot,
            'vehicles' => $vehicles,
            'orders'   => array_map(fn($o) => [
                'id'           => (string)$o['order_id'],
                'point'        => ['lat' => $o['lat'], 'lon' => $o['lon']],
                'time_window'  => [$o['time_from'], $o['time_to']],
                'service_duration' => 300,  // 5 хвилин на точку
            ], $orders),
        ];

        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setHeader('Content-Type', 'application/json');
        $http->setHeader('X-Ya-Courier-Request-Id', uniqid());

        $response = $http->post(
            'https://courier.yandex.ru/api/v1/companies/' . $this->companyId . '/routes',
            json_encode($payload)
        );

        return json_decode($response, true);
    }
}

class Route4MeOptimizer implements RouteOptimizerInterface
{
    public function optimize(array $depot, array $vehicles, array $orders): array
    {
        // Логіка, специфічна для Route4Me
    }
}

Конкретна реалізація вибирається через фабричний метод, налаштовується в b_option.

Перетворення даних замовлення

Ключовий момент — коректне перетворення даних Бітрікс в формат API оптимізатора. Адреса потребує геокодування у координати (якщо не зроблено при замовленні), часові вікна — конвертувати в формат оптимізатора:

function buildOrderPoint(\Bitrix\Sale\Order $order): array
{
    $props = $order->getPropertyCollection();

    return [
        'order_id' => $order->getId(),
        'lat'      => (float)$props->getItemByOrderPropertyCode('LAT')?->getValue(),
        'lon'      => (float)$props->getItemByOrderPropertyCode('LON')?->getValue(),
        'time_from' => $this->toUnix($props->getItemByOrderPropertyCode('DELIVERY_TIME_FROM')?->getValue()),
        'time_to'   => $this->toUnix($props->getItemByOrderPropertyCode('DELIVERY_TIME_TO')?->getValue()),
        'weight_kg' => $this->getBasketWeight($order->getBasket()),
        'volume_m3' => $this->getBasketVolume($order->getBasket()),
        'priority'  => (int)$props->getItemByOrderPropertyCode('DELIVERY_PRIORITY')?->getValue(),
    ];
}

Збереження та відображення маршрутів

Структура таблиці bl_delivery_routes:

route_id        — ID маршруту від оптимізатора
route_date      — дата доставки
vehicle_id      — ID транспортного засобу
driver_id       — CRM-контакт водія
stops_json      — JSONB впорядкований список зупинок
total_distance  — загальний пробіг у км
estimated_time  — приблизний час у хвилинах
status          — planned / in_progress / completed
created_at

Маршрут відображається на карті в адміністративному розділі через Яндекс.Карти API або Leaflet.js. Водію — посилання з waypoints.

Оновлення статусів замовлень

По завершенні доставки в точці оптимізатор (або водій через мобільний додаток) відправляє подію. Webhook Бітрікс оновлює статус конкретного замовлення:

// /bitrix/route_webhook.php
$data = json_decode(file_get_contents('php://input'), true);

foreach ($data['completed_stops'] as $stop) {
    $order = \Bitrix\Sale\Order::load((int)$stop['order_id']);
    if ($order) {
        $order->setField('STATUS_ID', 'F');
        $order->save();
        // Відправка листа клієнту про доставку
    }
}

Терміни виконання за масштабом

Що налаштовуємо

• Інтерфейс RouteOptimizerInterface з адаптерами під потрібні сервіси
• Агент збору замовлень та відправки до оптимізатора з ранку робочого дня
• Таблицю bl_delivery_routes зі зберіганням маршрутів та статусів
• Карту маршрутів в адміністративному розділі
• Webhook оновлення статусів замовлень при виконанні доставки