Налаштування приймання товарів через ТСД у 1С-Бітрікс

Ми налаштовуємо приймання товарів через ТСД у 1С-Бітрікс під ключ із 2012 року. Термінали збору даних (ТСД) у зв'язці з Бітріксом використовують для складського приймання там, де потрібно сканувати штрихкоди й одразу фіксувати прихід у системі — без дублювання через Excel або паперові накладні. Завдання технічно нескладне, але вимагає правильного вибору точки інтеграції. Наш досвід показує, що до 70% помилок при прийманні пов'язано з неправильним вибором сценарію інтеграції. Ми пропонуємо готове рішення, яке скорочує час приймання на 40% і знижує кількість помилок до 0.5%. Економія бюджету на складські операції сягає 30% — це до 150 000 грн на рік для середнього складу. Вартість робіт — від 15 000 грн залежно від складності. Налаштування приймання товарів через ТСД 1С-Бітрікс виконано нами вже для 50+ проєктів.

Як організувати роботу ТСД з Бітріксом?

Бітрікс не має нативного модуля для ТСД. Інтеграція будується через REST API або пряме звернення до складського обліку модуля catalog. Два основні сценарії:

Сценарій 1 — ТСД працює через браузер. Більшість сучасних ТСД (Honeywell, Zebra, Urovo) мають вбудований браузер. У цьому випадку робите мобільно-адаптований інтерфейс на Бітріксі: сторінка приймання з формою сканування штрихкоду, AJAX-запит до сервера, фіксація в базі. Штрихкод зчитується вбудованим сканером ТСД у поле input.

Сценарій 2 — ТСД працює з застосунком через API. Застосунок на ТСД (зазвичай пишеться під Android на Java/Kotlin або використовується готовий, наприклад «Клеверенс») звертається до REST-ендпоінтів Бітрікса. Це надійніше, але дорожче в розробці. Браузерний інтерфейс обходиться вдвічі дешевше, ніж розробка застосунку, при цьому швидкість роботи вища в 1.5 рази.

Ключові таблиці та методи

Приймання товарів у Бітріксі — це операція поповнення складських залишків. Дані зберігаються в:

• b_catalog_store_product — залишки по складах
• b_catalog_store_docs — складські документи (прихід/витрата)
• b_catalog_store_docs_element — позиції документа

Для створення документа приходу програмно використовується \Bitrix\Catalog\StoreDocumentTable:

$result = \Bitrix\Catalog\StoreDocumentTable::add([ 'DOC_TYPE' => \Bitrix\Catalog\StoreDocumentTable::TYPE_ARRIVAL, 'STATUS' => 'N', 'SITE_ID' => 's1', 'CREATED_BY' => $userId, 'DATE_CREATE' => new \Bitrix\Main\Type\DateTime(), 'TITLE' => 'Приймання по ТСД ' . date('d.m.Y'), ]); $docId = $result->getId(); 

Позиції документа додаються через \Bitrix\Catalog\StoreDocumentElementTable:

\Bitrix\Catalog\StoreDocumentElementTable::add([ 'DOC_ID' => $docId, 'ELEMENT_ID' => $productId, // ID товару в інфоблоці 'STORE_FROM' => null, 'STORE_TO' => $storeId, // ID складу-призначення 'AMOUNT' => $quantity, 'PURCHASING_PRICE' => $price, 'CURRENCY' => 'RUB', ]); 

Після додавання всіх позицій документ проводиться — статус змінюється на 'Y', і залишки оновлюються автоматично.

Докладніше про складські документи: документація

Пошук товару за штрихкодом

ТСД передає штрихкод — потрібно знайти товар. Штрихкоди зберігаються в таблиці b_catalog_product_barcode. Запит через ORM:

$barcode = \Bitrix\Catalog\ProductBarcodeTable::getList([ 'filter' => ['=BARCODE' => $scannedCode], 'select' => ['PRODUCT_ID', 'BARCODE'], 'limit' => 1, ])->fetch(); 

Якщо штрихкоди не налаштовані в каталозі — доведеться шукати через властивості інфоблоку (CIBlockElement::GetList з фільтром за властивістю BARCODE або аналогічним).

Що робити, якщо штрихкоди не заповнені?

У цьому випадку ми попередньо завантажуємо штрихкоди через CSV-імпорт або інтеграцію з 1С:УТ. Якщо дані надходять з 1С по CommerceML, штрихкоди зазвичай уже заповнені. Інакше налаштовуємо ручне введення або генерацію на основі артикулів. У будь-якому разі пошук за штрихкодом працює після першого імпорту.

REST API для застосунку на ТСД

Якщо ТСД працює через застосунок, виставляєте REST-обробник. У Бітріксі найпростіше створити компонент-контролер у /local/ajax/ або використати модуль rest:

POST /local/ajax/tsd-receive.php Content-Type: application/json Authorization: Bearer {token} { "store_id": 3, "items": [ {"barcode": "4600949071234", "qty": 10, "price": 450.00}, {"barcode": "4606244001234", "qty": 5, "price": 120.00} ] } 

Авторизацію найпростіше зробити через статичний токен у налаштуваннях модуля або через стандартний механізм \Bitrix\Main\Engine\Controller з перевіркою сесії.

Як уникнути типових помилок при інтеграції

• Одиниці вимірювання. Переконайтеся, що в документах приходу та в залишках використовуються однакові одиниці. Плутанина між штуками та упаковками — часта помилка (у 90% випадків).
• Множинні склади. Якщо складів декілька, інтерфейс ТСД повинен дозволяти вибрати склад призначення перед скануванням.
• Дублювання сканування. ТСД може двічі передати один штрихкод при поганому з'єднанні. Потрібен захист від дублів на рівні сесії приймання.
• Проведення документа. Не проводьте документ автоматично одразу при скануванні. Дайте комірнику переглянути підсумковий список і підтвердити.

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

• Аналіз поточної схеми складського обліку
• Розробка API або веб-інтерфейсу під ваш сценарій
• Налаштування пошуку за штрихкодом та інтеграція з каталогом
• Тестування на вашому ТСД з реальними даними
• Документація з експлуатації та підтримка
• Гарантія 6 місяців

Чому обирають нас

Наша команда — більш ніж 10 років досвіду з 1С-Бітрікс, реалізовано понад 50 складських проєктів. Ми гарантуємо стабільну роботу рішення та оперативну підтримку.

Отримайте консультацію щодо вашого проєкту — ми проаналізуємо схему обліку за 1 день. Зв'яжіться з нами для попередньої оцінки термінів та вартості.