Інтеграція 1С-Бітрікс з 1С:WMS Логістика
Ми не раз стикалися з ситуацією, коли інтернет-магазин на 1С-Бітрікс намагається синхронізувати залишки з 1С:WMS Логістика, але стандартний CommerceML не дає результату — складські документи не формуються, а залишки «висять». За 5 років інтеграцій ми виробили архітектуру, яка вирішує цю проблему без зайвих доробок. Нижче — перевірений підхід з реальними технічними деталями.
1С:WMS Логістика — конфігурація на платформі 1С:Підприємство 8, що реалізує повноцінне управління складом: адресне зберігання, завдання на відбір, управління зонами та транспортними одиницями. Інтеграція з 1С-Бітрікс у цьому випадку має принципову відмінність від обміну з SaaS-WMS: обидва продукти від одного вендора (1С), і теоретично мають «розуміти один одного». На практиці — прямого готового обміну немає, і будувати інтеграцію все одно потрібно.
Які проблеми вирішує інтеграція 1С:WMS з Бітріксом?
Перша і головна проблема — відсутність стандартного обміну. Стандартний модуль обміну 1С-Бітрікс (\Bitrix\Catalog\CatalogImport) працює з класичними конфігураціями 1С: Управління торгівлею, Роздріб, Комплексна автоматизація. Формат CommerceML 2.09 — саме під них. 1С:WMS Логістика — не торгова конфігурація. Вона не веде замовлення покупців безпосередньо, не містить прайс-листів, не знає про роздрібні ціни. Це система оперативного управління складом, яка отримує завдання від «старшої» системи (ERP, TMS, або інтернет-магазину) і управляє фізичним переміщенням товарів.
Друга проблема — маркування «Чесний знак». Якщо склад працює з маркованими товарами, при відвантаженні 1С:WMS має передати список кодів DataMatrix, використаних у замовленні. Ці коди потрібні для створення вихідного УПД в системі ЕДО та підтвердження вибуття в ДІС МТ. Без інтеграції цей процес виконується вручну, що призводить до помилок і штрафів.
Чому стандартний обмін 1С-Бітрікс тут не працює?
Все впирається в архітектуру: 1С:WMS — виконавець складських операцій. Отже, обмін потрібно будувати не через CommerceML, а через прямий API 1С:WMS — або REST-сервіси, опубліковані на платформі 1С, або HTTP-сервіси, написані в конфігураторі. Такий підхід у 2–3 рази швидший в обробці замовлень порівняно з доробкою CommerceML.
Архітектура: 1С:WMS як виконавець складських операцій
Схема обміну для e-commerce:
1С-Бітрікс (замовлення, залишки) ↔ 1С:WMS Логістика (завдання на відбір, факт відвантаження) Бітрікс — майстер замовлень. 1С:WMS — майстер фізичних залишків і статусів збірки.
З Бітрікс до 1С:WMS: нове замовлення, підтверджене до збірки. У термінах 1С:WMS це «Заявка на відвантаження» — документ ЗаявкаНаВідвантаження. Передаємо: номенклатуру (з прив'язкою за штрихкодом або артикулом), кількість, пріоритет, очікувану дату відвантаження.
З 1С:WMS до Бітрікс: статус виконання заявки, фактично відвантажена кількість (може відрізнятися від замовленої при пересортиці), список серійних номерів або кодів маркування для маркованої продукції.
Публікація HTTP-сервісів у 1С:WMS
Для REST-інтеграції в конфігураторі 1С створюємо HTTP-сервіс (гілка «HTTP-сервіси» в дереві конфігурації). Метод POST /orders/create приймає JSON з параметрами заявки, створює документ ЗаявкаНаВідвантаження та повертає внутрішній ID документа для подальшого опитування статусу.
На стороні Бітрікс реалізуємо клієнт до цього сервісу — клас з методами createOrder(), getOrderStatus(), getStockBalance(). Аутентифікація: Basic Auth на публікації HTTP-сервісу 1С (налаштовується у властивостях публікації веб-сервера).
Синхронізація залишків
1С:WMS веде залишки за регістром накопичення ЗалишкиТоварівНаСкладі. Для отримання доступного залишку потрібен HTTP-сервіс або Web-сервіс (SOAP), що запитує цей регістр з відбором по складу.
Важливий нюанс: у 1С:WMS залишок зберігається в облікових одиницях виміру складу, які можуть відрізнятися від одиниць сайту. Упаковка з 12 штук на складі = 12 штук у каталозі Бітрікс. Таблиця перерахунку одиниць має бути частиною інтеграційного шару.
Робота з маркуванням «Чесний знак»
Якщо склад працює з маркованими товарами, при відвантаженні 1С:WMS має передати список кодів DataMatrix, використаних у замовленні. Ці коди потрібні для створення вихідного УПД в системі ЕДО та підтвердження вибуття в ДІС МТ («Чесний знак»).
Інтеграція в цьому випадку розширюється: Бітрікс отримує з 1С:WMS не просто «статус відвантажено», а масив кодів маркування. Ці коди передаються далі в модуль роботи з ЕДО (Діадок, СБІС) або безпосередньо в API «Чесного знака» через метод POST /api/v3/true-api/outgoing-marks.
Що входить у роботу
Ми надаємо повний пакет:
- Аудит поточних конфігурацій 1С:WMS та Бітрікс.
- Проектування схеми обміну (узгодження полів, одиниць, статусів).
- Розробка HTTP-сервісів на стороні 1С та клієнта на стороні Бітрікс.
- Налаштування синхронізації залишків та замовлень.
- Інтеграція з ЕДО та ДІС МТ при необхідності.
- Тестування на тестовому та бойовому контурах.
- Документація та навчання співробітників.
- Гарантійна підтримка 3 місяці після запуску.
Орієнтири по термінах
| Сценарій | Термін |
|---|---|
| Базовий обмін: заявки на відвантаження + залишки | 6–10 тижнів |
| З обробкою часткових відвантажень та помилок | 3–4 місяці |
| З контуром маркування «Чесний знак» | 4–6 місяців |
Вартість розраховується індивідуально. Для оцінки потрібні: опис конфігурації 1С:WMS (версія, доробки), схема складських операцій, вимоги до маркування. Зв'яжіться з нами — ми підготуємо попередню оцінку за 2 дні.
