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

Уявіть: інтернет-магазин на Бітрікс втрачає до 20% замовлень, тому що клієнт не бачить вигідних варіантів доставки або стикається з непрацюючим прив'язуванням до ПВЗ. Ми стикалися з цим десятки разів. Shiptor — агрегатор служб доставки та фулфілмент-оператор — вирішує проблему за 4–10 днів. Його єдиний API дає доступ до 50+ перевізників, а правильно налаштована інтеграція знижує витік замовлень на 15–30%. Один наш клієнт з каталогом у 12 000 товарів після підключення Shiptor заощадив понад $1.8k–2.6k. на рік лише на комісіях.

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 замовленнями на місяць це дає економію до $2.7k–3.9k./рік.

Як відбувається синхронізація залишків?

При фулфілмент-моделі залишки товарів фізично на складі 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 сьогодні та отримайте консультацію інженера.