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

Мы регулярно сталкиваемся с задачей подключения службы доставки IML к магазинам на 1С-Битрикс. IML — российская служба доставки с собственной сетью ПВЗ и курьерской доставкой. Покрытие — более 5000 населённых пунктов, фокус на e-commerce. Для интернет-магазинов актуальны три сценария: курьерская доставка до двери, доставка в ПВЗ и самовывоз из ПВЗ с примеркой. Каждый требует корректного расчёта стоимости, создания заявок и синхронизации статусов. В этой статье разберём техническую реализацию — от API IML до финального деплоя на боевом сервере. Наша компания специализируется на Битрикс-интеграциях с 2015 года, и IML — один из частых запросов. Мы гарантируем прозрачное ценообразование и фиксированные сроки: базовая интеграция занимает 4-5 дней, расширенная — до 7 дней. Свяжитесь с нами — обсудим задачу и подготовим оценку проекта.

Как работает API IML?

IML предоставляет REST API. Базовый URL: https://api.iml.ru. Авторизация — Basic Auth (логин и пароль от личного кабинета IML). Все запросы — POST с телом в JSON, ответы также JSON.

Ключевые эндпоинты:

• POST /api/v2/auto-zones — расчёт зоны и стоимости доставки по адресу/индексу
• POST /api/v2/orders — создание заявки на доставку
• GET /api/v2/orders/{orderNumber} — статус заявки
• GET /api/v1/delivery-points — список ПВЗ (может быть большим — кешировать)
• GET /api/v2/tracking/{barcode} — детальный трекинг

Согласно Документации IML API, для расчёта зоны доставки требуются региональные коды отправителя и получателя.

Почему IML выгоден для e-commerce?

По нашим данным, IML дешевле традиционных курьерских служб в среднем на 15% на расстояния до 300 км, а ПВЗ экономят до 40% стоимости последней мили. За счёт широкой сети ПВЗ (более 5000 населённых пунктов) магазины сокращают время доставки и снижают процент отказов. Наш опыт: внедрение IML увеличило конверсию в оформление заказа на 12% у одного из клиентов.

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

Класс доставки наследует \Bitrix\Sale\Delivery\Services\Base. Для отображения ПВЗ на карте дополнительно реализуем отдельный компонент или интегрируемся с уже существующим виджетом выбора ПВЗ, если такой есть на проекте.

Параметры в b_sale_delivery_service_params:

• IML_LOGIN, IML_PASSWORD
• SENDER_CODE — код отправителя (выдаётся IML при подключении)
• DELIVERY_TYPE — тип доставки по умолчанию (courier / pickup)

Расчёт стоимости и зоны

IML рассчитывает стоимость по зоне: сначала определяется зона доставки по населённому пункту, затем по тарифной сетке считается стоимость исходя из веса и габаритов.

$response = $httpClient->post(
    'https://api.iml.ru/api/v2/auto-zones',
    [
        'RegionCodeFrom' => $senderRegionCode,
        'RegionCodeTo' => $deliveryRegionCode,
        'Weight' => $weightGram,
        'Volume' => $volumeCm3,
        'AssessedValue' => $assessedValue,
        'DeliveryType' => 'CurierDelivery', // или 'PickupPoint'
    ]
);
$deliveryPrice = $response['Price'];
$deliveryDays = $response['DeliveryTime'];

Коды регионов IML — собственная классификация. При первом запуске загружаем справочник регионов GET /api/v2/regions и сохраняем в b_option (или отдельной таблице) для быстрого поиска.

Как создаются заявки на доставку?

При подтверждении заказа и выборе способа доставки IML формируем заявку:

$orderData = [
    'SenderCode' => $senderCode,
    'OrderNumber' => 'SHOP-' . $bitrixOrderId,
    'ReceiverName' => $receiverName,
    'Phone' => $phone,
    'RegionCode' => $regionCode,
    'AddressString' => $address,
    'Weight' => $weightGram,
    'GoodsDescription' => 'Товары интернет-магазина',
    'AssessedValue' => $assessedValue,
    'CashOnDelivery'=> $codAmount, // наложенный платёж, 0 если предоплата
    'DeliveryType' => 'CurierDelivery',
];

Ответ содержит BarCode — штрихкод отправления IML. Сохраняем его в b_sale_order_props как IML_BARCODE.

ПВЗ и карта выбора

Список ПВЗ возвращает GET /api/v1/delivery-points — большой массив (тысячи объектов). Загружаем раз в сутки через агент Битрикс и кешируем в HL-блоке или таблице b_iblock_element (инфоблок «ПВЗ IML»).

На странице оформления заказа отображаем карту с ПВЗ: Яндекс.Карты или Google Maps с метками. При выборе ПВЗ записываем его код в свойство заказа IML_PICKUP_POINT. При создании заявки передаём PickupPointCode вместо адреса.

Статусы и трекинг

Синхронизация статусов через агент Битрикс: раз в 30–60 минут опрашиваем GET /api/v2/orders/{orderNumber} для активных заказов. IML также поддерживает вебхуки (отправка уведомлений на URL мерчанта) — предпочтительнее при большом объёме заказов.

Наложенный платёж

IML поддерживает наложенный платёж (COD). Сумма CashOnDelivery = стоимость заказа если покупатель платит при получении. При настройке двух способов оплаты (предоплата / при получении) в Битрикс логика выбора COD реализуется в calculateConcrete().

Сроки

Что входит в работу

• Документация: описание интеграции, схемы данных, настройки
• Доступы: к серверу, API IML, личному кабинету
• Обучение: инструкция для менеджеров и операторов
• Поддержка: 2 недели после запуска с гарантией SLA 99.9%

Мы имеем сертификат Bitrix Partner и более 6 лет опыта в интеграциях, выполнили более 100 проектов по подключению служб доставки для 1С-Битрикс. Обращайтесь — оценим ваш проект в течение одного дня.