Интеграция 1С-Битрикс со службой доставки Деловые Линии

Представьте: менеджер интернет-магазина вручную заполняет данные для доставки в личном кабинете Деловых Линий. На один заказ уходит до 15 минут. При 50 заказах в день — это более 12 часов чистой рутины. Ошибки в адресах, потерянные статусы, пересорт по габаритам — типичная картина без API-интеграции. Мы автоматизируем этот процесс: расчёт стоимости, создание заказов и трекинг — через REST API Деловых Линий. Один из клиентов — магазин мебели — после внедрения сократил время обработки заказа с 15 до 2 минут и снизил операционные затраты на доставку на 15%. Экономия на ручном труде — до $360–520./мес.

Почему важна автоматизация доставки через API?

Без интеграции магазины тратят до 20% рабочего времени на ручную обработку доставки. Деловые Линии — крупнейшая транспортная компания с сетью из 2000+ терминалов. Их API с JWT-авторизацией позволяет гибко управлять отправлениями. Мы выполнили более 30 проектов по интеграции 1С-Битрикс с транспортными компаниями, гарантируем стабильную работу и обновление при изменениях API. Подробнее о протоколе читайте в официальной документации REST API Деловых Линий.

Как автоматизировать доставку через интеграцию с Деловыми Линиями?

Как устроено API Деловых Линий? — интеграция 1с битрикс

Базовый URL: https://api.dellin.ru/v3/. Авторизация двухэтапная: сначала получаем session token через /v3/auth/login.json, затем используем его в заголовке Cookie: session=TOKEN или параметром.

private function getSession(): string { $cacheKey = 'dellin_session_' . md5($this->appKey); $cached = \Bitrix\Main\Data\Cache::createInstance(); if ($cached->startDataCache(3600 * 8, $cacheKey, '/dellin')) { $response = $this->httpPost('/v3/auth/login.json', [ 'appkey' => $this->appKey, 'login' => $this->login, 'password' => $this->password, ]); $session = $response['data']['sessionID'] ?? ''; $cached->endDataCache(['session' => $session]); } return $cached->getVars()['session']; } 

Сессия живёт 8+ часов. Кэшируем на 8 часов, чтобы не авторизоваться при каждом расчёте. Пример запроса расчёта стоимости:

private function calcCost( string $fromCity, string $toCity, float $weightKg, float $volumeM3 ): float { $response = $this->apiPost('/v3/calculator.json', [ 'appkey' => $this->appKey, 'sessionID' => $this->getSession(), 'delivery' => [ 'deliveryType' => ['type' => 'auto'], 'arrival' => ['variant' => 'address'], 'dispatch' => ['variant' => 'terminal'], ], 'cargo' => [ 'quantity' => 1, 'weight' => $weightKg, 'volume' => $volumeM3, 'totalEnvelopesWeight' => 0, ], 'members' => [ 'from' => ['terminalID' => $this->findTerminalId($fromCity)], 'to' => ['city' => $toCity], ], ]); return (float)($response['data']['price'] ?? 0); } 

Параметр delivery.dispatch.variant: terminal означает, что магазин сам привезёт груз на терминал. arrival.variant: address — доставка покупателю до двери. Комбинации variant влияют на цену: терминал-терминал дешевле, адрес-адрес дороже.

Поиск терминала по городу

public function findTerminalId(string $cityName): string { $response = $this->apiPost('/v3/public/terminals.json', [ 'appkey' => $this->appKey, ]); foreach ($response['data']['terminals'] ?? [] as $terminal) { if (mb_stripos($terminal['city']['name'], $cityName) !== false) { return $terminal['id']; } } return ''; } 

Список терминалов большой — кэшируем результат поиска на сутки.

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

public function createOrder(\Bitrix\Sale\Shipment $shipment): string { $order = $shipment->getOrder(); $props = $order->getPropertyCollection(); $payload = [ 'appkey' => $this->appKey, 'sessionID' => $this->getSession(), 'delivery' => [ 'deliveryType' => ['type' => 'auto'], 'dispatch' => ['variant' => 'terminal'], 'arrival' => [ 'variant' => 'address', 'address' => [ 'search' => $props->getItemByOrderPropertyCode('ADDRESS')?->getValue(), ], ], ], 'cargo' => $this->buildCargo($shipment), 'members' => [ 'from' => ['terminalID' => $this->getOption('FROM_TERMINAL_ID')], 'to' => [ 'contactPersons' => [[ 'name' => $props->getItemByOrderPropertyCode('FIO')?->getValue(), 'phone' => $props->getItemByOrderPropertyCode('PHONE')?->getValue(), ]], ], ], 'payment' => [ 'type' => 'cash', 'payer' => 'receiver', ], ]; $response = $this->apiPost('/v3/orders.json', $payload); return (string)($response['data']['orderID'] ?? ''); } 

Параметр payment.payer: receiver — доставку оплачивает получатель. sender — отправитель (магазин). Выбор зависит от бизнес-модели магазина.

Трекинг заказов

public function getOrderState(string $orderId): array { $response = $this->apiPost('/v3/orders/state.json', [ 'appkey' => $this->appKey, 'sessionID' => $this->getSession(), 'orders' => [['orderID' => $orderId]], ]); $state = $response['data'][0] ?? []; return [ 'status' => $state['orderState']['name'] ?? '', 'deliveryDate' => $state['deliveryDate'] ?? '', ]; } 

Деловые Линии не поддерживают вебхуки для трекинга. Агент Битрикс раз в 3–4 часа опрашивает статус активных отправлений.

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

Деловые Линии поддерживают паллетные отправления. Для магазинов мебели или строительных материалов нужно разделять отправления на несколько мест с индивидуальными габаритами. Поле cargo.oversizedWeight используется для нестандартных мест (> 80 кг или > 3 м в длину). В одном из проектов интернет-магазина мебели мы столкнулись с проблемой неправильного расчёта габаритов: товары приходили к покупателю с повреждениями. После внедрения интеграции с указанием параметров oversizedWeight и паллетной группировки количество возвратов снизилось на 15%.

Как происходит интеграция: пошаговый процесс?

1. Аналитика — изучаем ваш каталог, типы доставки, настройки 1С-Битрикс.
2. Проектирование — выбираем методы API, определяем маппинг полей.
3. Реализация — пишем код расчёта, создания заказов, трекинга.
4. Тестирование — проверяем на тестовых заказах, замеряем время ответа.
5. Деплой — выкатываем на боевой, настраиваем агенты.
6. Документация и обучение — передаём инструкции, обучаем менеджеров.

Что входит в работу по интеграции?

• Регистрация приложения в личном кабинете Деловых Линий.
• Настройка авторизации и кэширования сессии.
• Реализация расчёта стоимости на странице корзины.
• Создание заказов из административной панели.
• Трекинг с уведомлениями о смене статуса.
• Техническая поддержка 30 дней после запуска.

Сколько времени занимает интеграция?

Какие типичные ошибки допускают при интеграции?