Інтеграція 1С-Бітрікс із 1С:WMS Логістика
1С:WMS Логістика — конфігурація на платформі 1С:Підприємство 8, що реалізує повноцінне управління складом: адресне зберігання, завдання на відбір, управління зонами та транспортними одиницями. Інтеграція з 1С-Бітрікс у цьому випадку має принципову відмінність від обміну з SaaS-WMS: обидва продукти від одного вендора (1С), і теоретично повинні «розуміти один одного». На практиці — прямого готового обміну немає, і будувати інтеграцію однаково потрібно.
Чому стандартний обмін 1С-Бітрікс тут не працює
Стандартний модуль обміну 1С-Бітрікс (\Bitrix\Catalog\CatalogImport) працює з класичними конфігураціями 1С: Управління торгівлею, Роздрібна торгівля, Комплексна автоматизація. Формат CommerceML 2.09 — саме під них.
1С:WMS Логістика — не торгова конфігурація. Вона не веде замовлення покупців напряму, не містить прайс-листів, не знає про роздрібні ціни. Це система оперативного управління складом, яка отримує завдання від «старшої» системи (ERP, TMS або інтернет-магазину) і управляє фізичним переміщенням товарів.
Отже, обмін потрібно будувати по-іншому: не через CommerceML, а через прямий API 1С:WMS — або REST-сервіси, опубліковані на платформі 1С, або HTTP-сервіси, написані в конфігураторі.
Архітектура: 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.
Орієнтири за строками
| Сценарій | Строк |
|---|---|
| Базовий обмін: заявки на відвантаження + залишки | 6–10 тижнів |
| З обробкою часткових відвантажень і помилок | 3–4 місяці |
| З контуром маркування «Чесний знак» | 4–6 місяців |
Вартість розраховується індивідуально. Для оцінки потрібні: опис конфігурації 1С:WMS (версія, доробки), схема складських операцій, вимоги до маркування.