Налаштування приймання товарів через ТСД у 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 день. Зв'яжіться з нами для попередньої оцінки термінів та вартості.

Що включає професійне встановлення 1С-Бітрікс

Ми починаємо встановлення 1С-Бітрікс з перевірки innodb_buffer_pool_size. Дефолтне значення MySQL (128 МБ) — вирок для інтернет-магазину з каталогом на 10 000+ товарів. Ми ставимо 70–80% від доступної RAM на виділеному сервері, 50% на VPS. Одна ця налаштування прискорює сайт у 2–3 рази порівняно з дефолтом. Правильна конфігурація сервера заощаджує до 60% вартості хостингу щомісяця. Оцінимо ваш проєкт за один день — отримайте консультацію. Звертайтеся, щоб замовити встановлення під ключ з гарантією продуктивності.

Як вибрати хостинг та редакцію для встановлення 1С-Бітрікс?

BitrixVM — віртуальна машина з попередньо встановленим стеком: nginx + Apache, PHP-FPM, MySQL/MariaDB, Sphinx, Push‑сервер. Для VPS — найкращий старт. Все вже сконфігуровано під Бітрікс, включаючи OPcache, логротацію та firewall. Керування через веб‑панель на порту 8890.

VPS/VDS — золота середина. Мінімальна конфігурація для середнього інтернет‑магазину: 2 vCPU, 4 ГБ RAM, SSD. Оптимальна: 4 vCPU, 8 ГБ RAM. ОС: Ubuntu 22.04 або Debian 12. Якщо не BitrixVM — налаштовуємо стек вручну під задачу. Віртуальний хостинг — тільки для візиток та лендінгів. Вимоги: PHP 8.0+, MySQL 5.7+ / MariaDB 10.0+, 512 МБ RAM, .htaccess. Хостинг‑партнери 1С-Бітрікс — гарантія сумісності. Виділений сервер — для highload. Типова архітектура: веб‑сервер окремо, база даних окремо, Redis/Memcached окремо. На редакції «Ентерпрайз» — веб‑кластер з балансувальником. Хмара (Yandex Cloud, VK Cloud, Selectel) — коли навантаження стрибає: розпродажі, сезонні піки. Автомасштабування через Managed Kubernetes або просто вертикальне масштабування VM.

Вибір редакції — не менш важливий крок. Часта помилка: беруть «Малий бізнес» для магазину, який через півроку виростає до B2B з оптовими цінами та трьома складами. Перехід на «Бізнес» — доплата різниці, дані не втрачаються, але краще передбачити заздалегідь. Наші фахівці підберуть редакцію під поточні завдання і з запасом на зростання. Наприклад, ліцензія «Бізнес» окупається за рахунок мультискладу та обміну з 1С, а неправильний вибір призводить до додаткових витрат, які можуть у 2–3 рази перевищити вартість ліцензії.

Які налаштування сервера критичні для 1С-Бітрікс?

Веб‑сервер та PHP

nginx як reverse proxy + Apache (mod_php) або nginx + PHP-FPM напряму. Другий варіант економить пам’ять — Apache не потрібен. Але деякі модулі Бітрікс використовують .htaccess, тому для сумісності іноді залишаємо Apache. Конфігурація nginx: fastcgi_read_timeout 300 — для довгих операцій (імпорт з 1С), client_max_body_size 1024m — завантаження великих файлів. Закриваємо доступ до .settings.php, .settings_extra.php, bitrix/.settings.php — там паролі до бази. Rewrite‑правила з urlrewrite.php — Бітрікс сам генерує, але при nginx + PHP-FPM потрібно продублювати. PHP 8.0–8.2 з розширеннями: mbstring, curl, gd, xml, json, opcache, redis/memcached. Ключові налаштування php.ini: opcache.memory_consumption=256, opcache.max_accelerated_files=20000, max_execution_time=300, memory_limit=512M, upload_max_filesize=100M, post_max_size=128M. Порівняно з Apache + mod_php, зв’язка nginx + PHP-FPM споживає на 30% менше оперативної пам’яті при однаковому навантаженні — це підтверджено на наших проєктах.

База даних та кешування

MySQL/MariaDB. Ключові параметри my.cnf: innodb_buffer_pool_size — 70–80% RAM, innodb_log_file_size=256M, tmp_table_size=256M, max_heap_table_size=256M, thread_pool_size — за кількістю ядер CPU. Кодування utf8mb4 обов'язково, інакше емодзі та спецсимволи ламаються. Redis кращий за Memcached для Бітрікс — підтримує persistent connections та більш надійний. Налаштовуємо в .settings_extra.php:

'cache' => ['value' => ['type' => ['class_name' => '\\Bitrix\\Main\\Data\\CacheEngineRedis']]]
'session' => ['value' => ['mode' => 'default', 'handlers' => ['general' => ['type' => 'redis']]]]

Redis прискорює роботу сайту в 1.5 рази порівняно з Memcached завдяки постійним з’єднанням та вбудованому кешуванню сесій.

SSL, пошта та cron

SSL — Let's Encrypt через certbot у 90% випадків. Редирект HTTP → HTTPS (301), HSTS, TLS 1.2/1.3, OCSP Stapling. У Бітрікс перемикаємо на HTTPS у налаштуваннях головного модуля. Пошта: відмовляємося від mail() — підключаємо SMTP (Яндекс.Пошта для домену, Mail.ru для бізнесу). Обов'язково налаштовуємо SPF, DKIM, DMARC. Без SPF листи потрапляють у спам. Тестуємо доставляння через mail‑tester.com — оцінка 9+/10. Cron: агенти Бітрікс переводимо на системний cron — * * * * * /usr/bin/php /var/www/bitrix/modules/main/tools/cron_events.php. На cron вішаємо обмін з 1С (15–60 хв), пошукову переіндексацію, бекапи (mysqldump + rsync, ротація 7+4), очищення тимчасових файлів.

Безпека та адміністрування

Файлова система: власник www-data, директорії 755, файли 644, upload 775. nginx блокує доступ до файлів конфігурації. Вмикаємо Проактивний захист Бітрікс — WAF, контроль активності (блокування після 5 невдалих спроб), перевірку цілісності ядра. Для адмін‑панелі: двофакторна аутентифікація через Google Authenticator або OTP, обмеження доступу за IP через nginx для параноїків.

Скільки часу займає встановлення 1С-Бітрікс та налаштування?

Перевірка після встановлення (покроковий чек‑лист)

1. Монітор продуктивності (/bitrix/admin/perfmon_panel.php) — цілимося в 30+ балів. Нижче 20 — є серйозні проблеми з конфігурацією.
2. Перевірка системи — автоматична перевірка всіх параметрів. Червоні пункти — виправляємо обов'язково, жовті — за ситуацією.
3. Сканер безпеки — перевірка на типові вразливості.
4. PageSpeed Insights — TTFB < 200мс на VPS, LCP < 2.5с.
5. Тестовий обмін з 1С — якщо планується інтеграція, перевіряємо CommerceML‑обмін до запуску.

Додатково перевіряємо версії ПЗ, налаштування кешування, роботу cron, SSL‑сертифікат, SPF/DKIM/DMARC, права доступу, видалення дефолтних користувачів та сторінок. Для проєктів з 54‑ФЗ переконуємося, що налаштована фіскалізація через ОФД‑провайдера.

Що входить у роботу (deliverables)

• Повністю налаштований сервер під 1С-Бітрікс з оптимізацією MySQL, PHP, nginx.
• Встановлена та активована ліцензія потрібної редакції.
• SSL‑сертифікат, поштові налаштування, cron та бекапи.
• Документація: всі параметри конфігурації, доступи, cron‑завдання.
• Навчання контент‑менеджера: як заходити до адмінки, додавати товари, завантажувати зображення.
• Підтримка після встановлення протягом 30 днів — консультації з налаштувань.

Чому варто довірити встановлення професіоналам?

Неправильне встановлення — втрата часу та грошей. Ми бачили проєкти, де магазин на «Старті» не міг витримати 50 відвідувачів, тому що не було налаштовано innodb_buffer_pool_size. Після перенесення на VPS з правильною конфігурацією сайт «полетів». Неправильна конфігурація призводить до невиправданих витрат — іноді в 2–3 рази дорожче, ніж вартість професійного налаштування. Ви отримуєте готову архітектуру, яка масштабується. Замовте встановлення 1С-Бітрікс під ключ — й отримайте надійну платформу для зростання бізнесу. Зв'яжіться з нами — розрахуємо вартість під ваш проєкт. Досвід понад 7 років, реалізовано 120+ проєктів на Бітрікс, включаючи highload‑магазини з каталогами понад 100 000 товарів. Звертайтеся — ми допоможемо налаштувати Бітрікс під ваш проєкт.