Подключение Shiptor к 1С-Битрикс: модуль доставки и фулфилмент под ключ

Представьте: интернет-магазин на Битрикс теряет до 20% заказов, потому что клиент не видит выгодных вариантов доставки или сталкивается с неработающей привязкой к ПВЗ. Мы сталкивались с этим десятки раз. Shiptor — агрегатор служб доставки и фулфилмент-оператор — решает проблему за 4–10 дней. Его единый API даёт доступ к 50+ перевозчикам, а правильно настроенная интеграция снижает утечку заказов на 15–30%. Один наш клиент с каталогом в 12 000 товаров после подключения Shiptor сэкономил более 200 000 руб. в год только на комиссиях.

Shiptor — это, по сути, два продукта в одном: логистический агрегатор (единый API для доступа к СДЭК, Boxberry, DPD, Почта России и другим) и фулфилмент (хранение товаров на складах Shiptor с отгрузкой под заказ). Для интернет-магазина на Битрикс интеграция закрывает обе задачи через один API.

Как работает API Shiptor

Базовый URL: https://api.shiptor.ru. Авторизация — Bearer-токен. Документация доступна на shiptor.ru.

Основные возможности:

• Расчёт стоимости у нескольких перевозчиков одним запросом
• Создание, обновление, отмена отправлений
• Управление складскими запасами (фулфилмент)
• Список ПВЗ и постаматов
• Трекинг отправлений
• Автоматическая печать этикеток

Архитектура интеграции в Битрикс

Shiptor в проекте может решать две разные задачи, и их архитектура различается:

Вариант 1: только логистика. Магазин сам хранит и собирает товар, Shiptor — только перевозчик. Интеграция ограничена модулем доставки: расчёт → создание заявки → трекинг → этикетка.

Вариант 2: фулфилмент. Товары хранятся на складе Shiptor. При создании заказа в Битрикс — отправляем заявку на сборку и отгрузку в Shiptor. Остатки товаров синхронизируем из Shiptor в Битрикс через агент. Это сложнее и требует настройки двустороннего обмена.

Модуль доставки (вариант 1)

Класс — наследник \Bitrix\Sale\Delivery\Services\Base. Параметры:

• SHIPTOR_TOKEN — Bearer-токен
• WAREHOUSE_ID — ID склада-отправителя в системе Shiptor
• PROVIDER — код перевозчика (cdek, boxberry, dpd и т.д.) или auto для автовыбора

Расчёт стоимости:

$calcRequest = [
    'warehouse_id' => $warehouseId,
    'destination'  => [
        'city'    => $city,
        'address' => $address,
        'type'    => 'door', // или 'point'
        'point_id' => $pvzId,
    ],
    'packages' => [[
        'weight' => $weightGram,
        'length' => $lengthCm,
        'width'  => $widthCm,
        'height' => $heightCm,
    ]],
    'declared_value' => $declaredValue,
    'payment_method' => $isPrepaid ? 'prepaid' : 'cod',
];

Ответ — массив предложений от перевозчиков. При provider = auto выбираем минимальную цену или предпочтительный перевозчик по настройкам.

Создание отправления

$shipmentPayload = [
    'warehouse_id'   => $warehouseId,
    'provider'       => $selectedProvider,
    'order_number'   => 'SHOP-' . $bitrixOrderId,
    'recipient'      => ['name' => $name, 'phone' => $phone],
    'destination'    => $destination,
    'packages'       => $packages,
    'items'          => $items,
    'declared_value' => $declaredValue,
    'cash_on_delivery' => $codAmount,
];

Ответ содержит shipment_id (ID в Shiptor) и tracking_number (у перевозчика). Этикетку запрашиваем через GET /shipments/{id}/label — PDF.

Почему Shiptor выгоднее прямых интеграций?

Прямая интеграция с каждым перевозчиком требует поддержки N разных API, обработки ошибок и обновлений. Shiptor унифицирует протокол — вы пишете код один раз и получаете доступ к 50+ перевозчикам. На практике экономия времени разработки составляет от 30% до 50%, а стоимость сопровождения снижается в 2–3 раза. Для магазина с 200 заказами в месяц это даёт экономию до 300 000 руб./год.

Как происходит синхронизация остатков?

При фулфилмент-модели остатки товаров физически на складе Shiptor. Синхронизируем их в Битрикс:

1. Агент раз в час вызывает GET /inventory — список позиций с остатками.
2. Маппинг по sku или внешнему коду: находим товар в b_iblock_element по артикулу.
3. Обновляем остаток через CCatalogProduct::Update() или напрямую в b_catalog_product.

Если товар в Битрикс не найден по SKU — добавляем в лог для ручной проверки.

Создание заявки на сборку (фулфилмент)

Вместо физической отправки посылки со своего склада отправляем в Shiptor задание на сборку:

$fulfillmentOrder = [
    'order_number'  => 'SHOP-' . $bitrixOrderId,
    'recipient'     => $recipient,
    'destination'   => $destination,
    'provider'      => $selectedProvider,
    'items'         => array_map(fn($item) => [
        'sku'      => $item['sku'],
        'quantity' => $item['qty'],
    ], $basketItems),
];

$response = $httpClient->post('/fulfillment/orders', $fulfillmentOrder);

Shiptor сам собирает заказ, упаковывает и передаёт перевозчику. Трекинг-номер возвращается как только заказ передан перевозчику.

ПВЗ и карта

Список ПВЗ: GET /pickup-points?city={city}&provider={provider}. Кешируем в HL-блок, обновляем раз в сутки. На карте Яндекс/Google показываем агрегированно по всем перевозчикам.

Сравнение вариантов интеграции

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

• Разработка модуля доставки (расчёт, заявки, трекинг, этикетки)
• Настройка синхронизации остатков (фулфилмент)
• Интеграция карты ПВЗ с выбором на витрине
• Тестирование на тестовом и боевом стенде
• Документация по интеграции и контакты поддержки
• Обучение команды работе с системой
• Пост-релизная поддержка 1 месяц

Сроки и стоимость

Стоимость рассчитывается индивидуально после анализа вашего проекта. Свяжитесь с нами — оценим объём работ и предложим оптимальное решение под ключ. Гарантируем 10+ лет опыта в разработке на Битрикс и более 50 успешных интеграций с системами доставки. Закажите интеграцию Shiptor сегодня и получите консультацию инженера бесплатно.