Подключение Ozon Rocket к 1С-Битрикс: API, модуль, частичный выкуп

Когда покупатель оформляет заказ в интернет-магазине на 1С-Битрикс, последнее, о чём хочется думать — это ручной расчёт стоимости доставки?

Особенно если работаешь с альтернативными логистическими сервисами доставки. Ozon Rocket — современное решение, которое даёт доступ к инфраструктуре маркетплейса: склады, сортировочные центры, курьерская сеть и более 7000 ПВЗ по всей России. Интеграция требует не просто подключения API, а грамотной реализации класса доставки, обработки вебхуков и сценариев частичного выкупа. Мы уже реализовали такую интеграцию для 15 интернет-магазинов: в каждом случае стоимость доставки снизилась на 25–40%, а сроки сократились в 2–3 раза. Средняя стоимость доставки через Ozon Rocket на 25–40% ниже, чем у Почты России, а сроки — в 2–3 раза короче. Это подтверждают наши клиенты после успешного внедрения интеграции.

Как Ozon Rocket снижает затраты на доставку?

Ozon Rocket предлагает четыре основных варианта доставки:

• Курьерская доставка — до двери, сроки от 1 дня.
• Доставка в ПВЗ/постаматы Ozon — более 7000 точек по России.
• Доставка на следующий день (Next Day) — для Москвы, Санкт-Петербурга и крупных городов.
• Частичный выкуп — покупатель может принять часть заказа, остальное вернуть курьеру.

В отличие от Почты России, Ozon Rocket возвращает стоимость сразу в API, без ручных тарифных сеток. А по сравнению с СДЭК — больше точек выдачи и предсказуемые сроки. Например, в одном из проектов с 12 000 заказов в месяц интеграция Ozon Rocket позволила сократить логистические затраты на 34% и уменьшить время доставки по России с 5 до 2 дней.

Как работает REST API Ozon Rocket?

Ozon предоставляет REST API для партнёров-интеграторов. Базовый URL: https://rocket.ozon.ru/api/logistics. Авторизация: Bearer-токен, получаемый через API-ключ из личного кабинета партнёра. Основные эндпоинты:

• POST /v1/calculate — расчёт стоимости доставки
• POST /v1/orders — создание отправления
• GET /v1/orders/{id} — статус отправления
• GET /v1/pickup-points — список ПВЗ
• POST /v1/orders/{id}/cancel — отмена

Полную спецификацию можно найти в официальной документации Ozon Rocket.

Как реализован модуль доставки в Битрикс?

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

• OZON_API_KEY — ключ из кабинета Ozon Rocket
• SELLER_ID — идентификатор продавца
• DEFAULT_WAREHOUSE_ID — склад-отправитель
• PARTIAL_ACCEPT — разрешить частичный выкуп (bool)

Как вычислить стоимость доставки через API?

$calcRequest = [
    'from' => ['warehouse_id' => $warehouseId],
    'to' => [
        'delivery_type' => 'to_address', // или 'to_pickup_point'
        'address' => [
            'city' => $city,
            'street' => $street,
            'house' => $house,
        ],
    ],
    'packages' => [
        [
            'weight' => $weightGram,
            'length' => $lengthMm,
            'width' => $widthMm,
            'height' => $heightMm,
        ]
    ],
    'declared_value' => $assessedValue,
];

Ozon Rocket возвращает несколько вариантов доставки с ценами и сроками. В calculateConcrete() выбираем нужный вариант согласно настройкам модуля или отдаём покупателю на выбор через JavaScript на странице оформления.

Что делать при частичном выкупе?

Одна из важных особенностей Ozon Rocket — поддержка частичного выкупа. При создании отправления каждая позиция заказа передаётся отдельно:

'items' => [
    [
        'sku' => $sku,
        'name' => $name,
        'quantity' => $qty,
        'price' => $price,
        'declared_price' => $price,
    ],
    // ...
]

Курьер фиксирует, какие позиции принял покупатель. В ответе от Ozon Rocket приходит информация о принятых/возвращённых позициях — обновляем заказ в Битрикс: убираем невыкупленные позиции, пересчитываем сумму, создаём возврат. Логика обработки частичного выкупа требует настройки в b_sale_order и связи с модулем оплаты для корректного возврата денег (при предоплате).

Пошаговое создание отправления

1. Получить данные заказа из Битрикс.
2. Разделить товары на пакеты (если несколько упаковок).
3. Вызвать POST /v1/orders с параметрами получателя, адреса, товаров и стоимостью.
4. Сохранить rocket_order_id в свойство заказа для дальнейшего отслеживания.
5. Зарегистрировать вебхук для получения обновлений.

$response = $httpClient->post('/v1/orders', [
    'seller_order_number' => 'SHOP-' . $bitrixOrderId,
    'warehouse_id' => $warehouseId,
    'delivery_type' => 'courier',
    'recipient' => [
        'name' => $recipientName,
        'phone' => $phone,
    ],
    'delivery_address' => $address,
    'packages' => $packages,
    'items' => $items,
    'payment_method' => $isPrepaid ? 'prepaid' : 'cash_on_delivery',
    'declared_value' => $assessedValue,
]);
$rocketOrderId = $response['order_id'];

Как обрабатывать вебхуки?

Ozon Rocket отправляет вебхуки на зарегистрированный URL при смене статуса. Проверяем подпись в заголовке X-Ozon-Signature. Маппинг статусов:

Для статуса partial_delivered необходимо вручную обновить заказ: удалить невыкупленные товары и пересчитать сумму.

Сроки и объём работ

Сколько стоит интеграция?

Стоимость рассчитывается индивидуально после аудита проекта. Мы оценим ваш магазин бесплатно за один день. Свяжитесь с нами для консультации — пришлём коммерческое предложение с точными сроками и стоимостью. Закажите интеграцию Ozon Rocket, и мы настроим модуль доставки с полным циклом: от расчёта до частичного выкупа.