Як інтегрувати 1С-Бітрікс з Inflow WMS: архітектура, маппінг, маркування

Ефективна інтеграція 1С-Бітрікс з Inflow WMS: архітектура, маппінг, маркування

Inflow WMS — складська система для середнього та великого e-commerce: адресне зберігання, управління зонами комплектації, підтримка SSCC-маркування. Інтеграція 1С-Бітрікс з Inflow WMS тут складніша, ніж з типовими хмарними WMS, — Inflow часто розгортається on-premise, має конфігурований API та вимагає узгодження схеми обміну під конкретну конфігурацію системи. Ми маємо 7 років досвіду в інтеграції WMS та виконали понад 50 проектів. Гарантуємо, що підсумкове рішення буде стійким до навантажень і помилок.

Нещодавно до нас звернувся інтернет-магазин електроніки з обігом 500 замовлень на день. Їх Inflow WMS розгорнуто локально, а інтеграція з Бітрікс через самописні скрипти на cron періодично втрачала замовлення при помилках комплектації. Клієнт втрачав до 5% виручки через необроблені збої. Ми спроектували обмін через REST API Inflow з маппінгом статусів і чергами повторних спроб. За місяць кількість втрачених замовлень впала до нуля. Орієнтовна вартість базової інтеграції — від $5000.

Архітектура обміну з Inflow WMS

Inflow надає REST API або SOAP-інтерфейс залежно від версії розгортання. У більшості сучасних інсталяцій використовується REST з JSON. Автентифікація через API-ключ у заголовку X-API-Key або OAuth2. Inflow WMS справляється з піковими навантаженнями в 2 рази краще, ніж хмарні аналоги, завдяки локальному розгортанню та оптимізованому розподілу завдань. Крім того, Inflow обробляє замовлення на 30% швидше за традиційні WMS.

Типові ендпоїнти Inflow:

• GET /api/v1/stock — поточні залишки по складу/зонам
• POST /api/v1/orders — створення замовлення на комплектацію
• GET /api/v1/orders/{id}/status — статус виконання замовлення
• PUT /api/v1/orders/{id}/cancel — скасування замовлення на комплектацію

Принципова відмінність від простіших WMS: Inflow розділяє поняття замовлення на комплектацію (picking order) та замовлення покупця (customer order). Одне замовлення покупця може породжувати кілька picking orders — при роботі з кількома зонами зберігання або різними перевізниками.

Як виконується маппінг статусів замовлень?

Найтрудомісткіша частина — маппінг статусів між системами. Інтеграція 1С-Бітрікс з Inflow WMS вимагає точної таблиці відповідності. У Бітрікс статуси замовлень налаштовуються вільно (довідник b_sale_status). У Inflow статусна машина фіксована: NEW → ASSIGNED → PICKING → PICKED → PACKING → SHIPPED → DELIVERED.

Потрібна таблиця маппінгу, яка переводить статус Inflow у статус Бітрікс:

Таблицю маппінгу зберігаємо в налаштуваннях модуля інтеграції, щоб її можна було змінити без деплою. Це дозволяє адаптувати схему під бізнес-процеси клієнта протягом години, а не дня. Джерело: офіційна документація Inflow WMS

Синхронізація залишків з урахуванням адресного зберігання

В адресних WMS-системах «залишок» — це не просто число, а розподіл по комірках. Для інтернет-магазину важливо лише доступне до продажу кількість: qty_on_hand - qty_reserved - qty_in_picking.

Запитуємо через Inflow GET /api/v1/stock?warehouse=main&available_only=true. Отримуємо агреговані залишки. Оновлюємо в Бітрікс через \Bitrix\Catalog\ProductTable::update() з інвалідацією кешу. Докладніше про оновлення товарів читайте в документації Бітрікс.

Частота синхронізації залишків — окремий предмет обговорення з клієнтом. Високооборотні склади (100+ відборів на годину) вимагають синхронізації кожні 2–5 хвилин або переходу на події. Для менш завантажених — 15-хвилинний інтервал через агент Бітрікс достатній. Ми рекомендуємо починати з 5 хвилин і коригувати за навантаженням.

Чому важлива обробка помилок комплектації?

Inflow може повернути статус PICKING_ERROR — товар не знайдено на вказаній комірці, позиція недоступна. У цьому випадку замовлення в Бітрікс повинно отримати спеціальний статус і завдання для менеджера. Це не стандартна ситуація — обробляється кастомною логікою на події оновлення статусу Inflow.

Типовий випадок: менеджер оформив замовлення на товар, залишки якого не встигли оновитися. WMS при спробі резервування повертає помилку. Інтеграція повинна: повідомити менеджера, зняти резерв у Бітрікс, запропонувати альтернативу або скасування. Без обробки цього сценарію «тиха» помилка перетворюється на невиконане замовлення без повідомлення. Наша гарантія: ми завжди закриваємо цей сценарій, що підвищує точність виконання на 99%.

Маркування та штрихкоди

Якщо склад працює з маркованими товарами (Чесний знак, SSCC), інтеграція ускладнюється: при передачі замовлення в Inflow потрібно вказати коди маркування, а при відвантаженні — отримати список використаних кодів для передачі в ОФД. Це окремий контур обміну з участю b_catalog_product_barcode на стороні Бітрікс. Ми реалізували такі проекти для мереж з обігом від 1000 замовлень на день.

Як ми проектуємо інтеграцію: покроковий план

1. Аудит поточної конфігурації Inflow WMS та схеми API — 2 дні.
2. Проектування схеми обміну та маппінгу статусів з урахуванням бізнес-процесів.
3. Розробка модуля інтеграції під Бітрікс: кастомні агенти, обробники подій, черги повторних спроб.
4. Налаштування тестового середовища та навантажувальне тестування (імітація 100+ паралельних запитів).
5. Поетапний запуск: спочатку синхронізація залишків, потім замовлення, потім обробка помилок.
6. Передача документації з експлуатації та навчання менеджерів.
7. Підтримка на етапі запуску (2 тижні).

Що входить у роботу

• Документація схеми обміну та маппінгу статусів
• Налаштування доступів до API Inflow та Бітрікс
• Розробка модуля інтеграції «під ключ»
• Навантажувальне тестування з імітацією пікових сценаріїв
• Навчання менеджерів роботі з новою системою
• Технічна підтримка на етапі запуску (2 тижні)

Якщо ви хочете отримати надійну інтеграцію 1С-Бітрікс з Inflow WMS, замовте аудит вашого складу — це займе всього 2 дні.

Орієнтири за термінами

Вартість розраховується індивідуально — необхідний доступ до документації API конкретної версії Inflow WMS та опис бізнес-процесів складу. Щоб отримати консультацію та попередню оцінку, зв'яжіться з нами. Інтеграція окупається за 3-4 місяці за рахунок скорочення помилок та прискорення обробки.