Інтеграція 1С-Бітрікс з агрегатором доставок Dalli

Інтеграція 1С-Бітрікс з агрегатором доставок Dalli

Інтернет-магазин втрачає замовлення, якщо не може доставити товар у день оформлення. За статистикою, 30% замовлень у Москві потребують такої швидкості, а без експрес-доставки магазини втрачають до 15% покупців. Dalli Service — агрегатор і логістичний оператор, який вирішує це завдання. Але вбудованих засобів Бітрікс для роботи з Dalli немає. Ми реалізували десятки таких інтеграцій і знаємо, як зробити процес безшовним. Наш досвід — 10+ років у розробці на Бітрікс і 50+ успішних проєктів з Dalli. Економія на доставці за рахунок оптимізації тарифів сягає значних сум з кожної посилки.

Чому Dalli кращий за прямі контракти з перевізниками?

Підключення Dalli через наш модуль замість прямих інтеграцій з кожним перевізником скорочує витрати на розробку в 3–4 рази. Ви отримуєте єдиний API для доставки: кур'єрська служба Dalli та партнери об'єднані в одному протоколі. Не потрібно погоджувати окремі договори з СДЕК, Boxberry та іншими — все реалізовано через Dalli. Згідно з документацією, агрегатор відповідає за розподіл замовлень між перевізниками та контроль термінів. Dalli API

Як працює експрес-доставка в день замовлення?

Експрес-доставка — ключова особливість Dalli для Москви та Санкт-Петербурга. Працює при виконанні умов:

• Замовлення прийняте до певного часу (зазвичай до 14:00–15:00)
• Склад відправника знаходиться в зоні покриття
• Товар фізично готовий до відправки

У calculateConcrete() перевіряємо поточний час: якщо date('H') >= $cutoffHour — експрес-доставка сьогодні недоступна, пропонуємо доставку на наступний день.

$currentHour = (int) date('H');
$cutoffHour = 14; // Дата дедлайну з налаштувань модуля
if ($currentHour >= $cutoffHour) {
    $deliveryDate = date('d.m.Y', strtotime('+1 day'));
    $label = 'Доставка завтра, ' . $deliveryDate;
} else {
    $deliveryDate = date('d.m.Y');
    $label = 'Доставка сьогодні, ' . $deliveryDate;
}

Що надає Dalli API і як його підключити?

Dalli API — REST, авторизація за токеном. Документація на порталі dalli.ru для партнерів. Основні операції:

• Розрахунок вартості доставки
• Створення заявок (одинарних і пакетних)
• Отримання статусів
• Список ПВЗ
• Отримання етикеток (PDF)
• Реєстрація вебхуків

Dalli працює переважно за моделлю: магазин передає заявки через API, Dalli розподіляє між своєю службою та партнерами залежно від адреси та термінів.

Модуль доставки в Бітрікс

Клас успадковує \Bitrix\Sale\Delivery\Services\Base. Параметри в b_sale_delivery_service_params:

• DALLI_TOKEN — токен API
• SENDER_ID — ID точки відправки (оформлюється при підключенні)
• DELIVERY_MODE — express (день-в-день / наступний день) або standard
• COD_ALLOWED — чи дозволений післяплатіж

Розрахунок вартості

У calculateConcrete() передаємо адресу, габарити, оголошену цінність. Dalli повертає варіанти з різними термінами (стандарт, експрес) і цінами:

$calcResponse = $httpClient->post('/v1/calculate', [
    'sender_id' => $senderId,
    'address' => $recipientAddress,
    'weight' => $weightGram,
    'dimensions' => $dimensions,
    'declared_value' => $declaredValue,
    'delivery_types' => ['standard', 'express'],
]);

foreach ($calcResponse['variants'] as $variant) {
    // $variant['type'], $variant['price'], $variant['delivery_date']
}

Якщо магазин пропонує два способи доставки (стандарт і експрес), створюємо два екземпляри модуля з різними DELIVERY_MODE в налаштуваннях.

Створення заявки

$orderPayload = [
    'sender_id' => $senderId,
    'external_id' => 'SHOP-' . $bitrixOrderId,
    'delivery_type' => $deliveryMode,
    'recipient' => [
        'name' => $name,
        'phone' => $phone,
        'address' => $address,
    ],
    'packages' => [[
        'weight' => $weightGram,
        'dimensions' => $dimensions,
        'items' => $items,
    ]],
    'declared_value' => $declaredValue,
    'cash_on_delivery'=> $codAmount,
    'comment' => $comment,
];

Відповідь: order_id в системі Dalli. Етикетку отримуємо через GET /orders/{id}/label.

Пакетне створення заявок

Якщо замовлення накопичуються протягом дня, Dalli підтримує POST /orders/batch — створення кількох заявок одним запитом. Менеджер натискає «Відправити в Dalli» в адміністративній частині Бітрікс — скрипт збирає всі замовлення зі статусом «Готовий до відправки» і відправляє пакетом.

Статуси та вебхуки

Вебхуки: Dalli надсилає сповіщення на URL мерчанта. Реєструємо в особистому кабінеті. Маппінг:

Які завдання вирішує інтеграція з Dalli?

Інтеграція вирішує три ключові завдання: швидкість підключення нового перевізника, автоматизація розрахунків і синхронізація статусів. Без неї менеджери вручну формують заявки на сайті Dalli, помиляються в адресах і забувають відстежувати повернення. Наш модуль виключає людський фактор.

Типові помилки при інтеграції:

• Неправильний маппінг статусів: якщо не налаштувати failed, замовлення зависають у «В дорозі».
• Відсутність обробки timeout: API Dalli відповідає до 15 секунд, на великих каталогах розрахунок може падати по таймауту. Додайте повторні спроби з таймаутом 20 секунд.
• Ігнорування коду післяплати: якщо не передати cash_on_delivery, Dalli не розраховує комісію, і реальна вартість доставки розходиться з очікуваною.

Що входить в інтеграцію під ключ

Ми надаємо повний пакет: розробка модуля доставки, налаштування API, тестування всіх сценаріїв, навчання менеджерів, документація. Гарантія на роботу — 3 місяці. Підтримуємо версії PHP 8.1+ і Бітрікс 22.0+. Сертифіковані спеціалісти з досвідом реалізують інтеграцію без збоїв.

Строки

Обговорімо вашу задачу — ми розрахуємо вартість і строки під ваш проєкт. Зв'яжіться з нами: вже інтегрували Dalli для 50+ магазинів, оцінимо ваш проєкт.