Интеграция 1С-Битрикс с Dalli: API, расчёт, статусы

Интеграция 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+ магазинов, оценим ваш проект бесплатно.