Штрихкоди: сканування й пошук товару

Штрихкод у OneB Invoice — це поле «Код товару» в картці товару. Якщо туди записано штрихкод, товар можна знайти за ним у пошуку, а в закупці — просто відсканувати сканером, і рядок заповниться сам. Ця стаття пояснює сам механізм: де працює сканер, як влаштований пошук за штрихкодом і чому результат приходить не миттєво.

Стаття написана з погляду вас — власника або співробітника робочого простору.

Де це в застосунку: Управління → Товари та послуги (поле «Код товару») і Документи → Закупки → форма створення чи редагування закупки (кнопка «Сканувати штрихкод»)

Штрихкод живе в полі «Код товару»

Окремого поля «штрихкод» у картці товару немає — його роль виконує «Код товару». Це зроблено навмисно: у одних компаній там артикул, у інших — штрихкод, і система працює з обома однаково.

Практичний наслідок: пошук у розділі Товари та послуги шукає і за назвою, і за кодом. Тобто, вставивши штрихкод у рядок пошуку, ви знайдете потрібний товар. Те саме працює в каталозі товарів, який відкривається з форми документа: почніть вводити штрихкод — і потрібна позиція знайдеться, навіть якщо ви не памʼятаєте її назви.

Коли товар створюється автоматично після сканування, застосунок теж записує штрихкод саме в «Код товару».

Де працює сам сканер

Режим сканування вмикається лише у формах закупівлі — при створенні закупки і при її редагуванні. У рахунку, кошторисі, акті, видатковій чи договорі сканер не активний: там позиції додаються з каталогу або вручну.

Нічого спеціально вмикати не треба — щойно ви відкрили форму закупки, сторінка вже слухає сканер. Кнопка «Сканувати штрихкод» поруч із «Обрати з каталогу» лише відкриває коротку підказку; сканування працює й без натискання на неї.

Підходить будь-який USB- або Bluetooth-сканер, який працює «як клавіатура» — це майже всі побутові моделі. Застосунок сам відрізняє швидку «чергу» символів від сканера від звичайного набору руками і не дає штрихкоду випадково потрапити в поле, у якому стояв курсор.

Камерою телефона сканувати не можна — такої функції в застосунку немає. Якщо треба сканувати «в полі», підключіть до телефона чи планшета Bluetooth-сканер: він для системи виглядає як клавіатура, і все працює так само. Але зручніше все ж робити це за компʼютером.

Як влаштований пошук за штрихкодом

Після кожного сканування застосунок шукає товар у два кроки.

Крок 1 — ваш каталог. Спершу система дивиться, чи немає у ваших товарах позиції з таким кодом. Якщо є — рядок заповнюється миттєво, разом із назвою, одиницею виміру й останньою закупівельною ціною цього товару.

Крок 2 — розумний пошук. Якщо у вашому каталозі такого штрихкоду немає, запит іде до зовнішнього довідника товарів. Ось тут і починається головна особливість: пошук асинхронний. Застосунок відправляє запит і не чекає відповіді «на місці» — він продовжує роботу, а результат приходить пізніше, коли зовнішня служба його підготує.

Поки триває пошук, біля назви рядка крутиться індикатор. Застосунок сам перепитує результат кожні кілька секунд і підставляє його, щойно він зʼявиться. Зазвичай це секунди, зрідка — до хвилини й довше; якщо відповіді немає надто довго, пошук зупиняється, а штрихкод залишається в рядку, і назву можна вписати руками.

Через асинхронність можна не чекати: скануйте наступний товар, заповнюйте ціни й кількості. Кілька пошуків спокійно йдуть одночасно, і кожен «приземлиться» у свій рядок.

Якщо товар знайдено, а вас у цьому рядку вже щось не влаштовує — застосунок нічого не перезапише мовчки. Коли ви почали редагувати рядок під час пошуку, знахідка приходить як пропозиція: біля назви зʼявляється позначка, натиснувши на яку, ви підставите знайдену назву.

Що потрапляє в каталог

Коли розумний пошук знаходить товар, якого у вас ще немає, застосунок сам створює картку товару: назва, фото (якщо воно є в довіднику) і штрихкод у полі «Код товару». Тип ставиться «Товар», а ціна — нульова: закупівельну ціну ви вписуєте в закупці, продажну задаєте самі в картці товару.

Штрихкод має бути числом із 8–14 цифр — саме такі коди розпізнає система (це звичайні EAN-8, EAN-13, UPC та подібні).

Обмеження й нюанси

Сканер працює тільки у формах закупівлі — при створенні й редагуванні закупки. В інших типах документів кнопки «Сканувати штрихкод» немає, і сторінка сканер не слухає.

Сканування камерою телефона не підтримується. Потрібен фізичний USB- або Bluetooth-сканер, який працює в режимі клавіатури.

Для сканування й пошуку потрібне право керувати товарами. Якщо у вашій ролі його немає, пошук за штрихкодом не спрацює. Докладніше — Користувачі й ролі робочого простору.

Ліміт розширеного пошуку не блокує сканування. Це найчастіше непорозуміння: коли ліміт вашого тарифу вичерпано, пошук продовжує працювати — просто застосунок більше не звертається до платних зовнішніх джерел і шукає лише у безкоштовних. Практичний наслідок один: рідкісні товари знаходитимуться рідше. Ніякої помилки чи блокування ви не побачите. Докладніше про ліміти — Тарифний план і ліміти.

Автоматичне створення товару впирається в ліміт кількості товарів вашого тарифу. Якщо ліміт вичерпано, картка товару не створиться, але назва все одно підставиться в рядок закупки — документ ви оформите, просто товар не поповнить довідник.

Функція позначена як beta: розумний пошук ще розвивається, тож зрідка товар може не знайтися. Вмикати нічого не треба — це не експериментальна функція з налаштувань, а звичайна частина форми закупки.

Що відбувається автоматично

Знайдений товар, якого не було в каталозі, створюється автоматично — з назвою, фото і штрихкодом.
Фото товару підвантажується й зменшується до мініатюри само, окремої дії не потрібно.
Повторне сканування того самого штрихкоду не створює новий рядок, а додає +1 до кількості.
Для товарів, доданих у закупку раніше (з каталогу або при попередньому редагуванні), застосунок сам підтягує їхні коди й мініатюри, щоб повторний скан коректно склався в наявний рядок.

Що може змінитися

Розумний пошук у бета-режимі, тож ми доопрацьовуємо: набір джерел, з яких беруться назви й фото, швидкість відповіді та якість розпізнавання рідкісних товарів. Логіка «спершу ваш каталог, потім зовнішній довідник» і поведінка сканера змінюватися не планують.

Часті питання

Чи можна сканувати штрихкоди в рахунку або акті? Ні. Сканер працює лише у формах закупівлі. У решті документів позиції додаються з каталогу товарів — але там теж можна ввести штрихкод у пошук і знайти потрібний товар за кодом.

Чи є сканування камерою на телефоні? Ні. Потрібен USB- або Bluetooth-сканер. Bluetooth-сканер можна підключити й до телефона — для застосунку він виглядає як клавіатура.

Я відсканував, а нічого не відбувається. Перевірте, що ви саме у формі закупки (створення або редагування), а не в іншому документі, і що сканер налаштований у режимі клавіатури з натисканням Enter у кінці коду.

Пошук довго крутиться. Це нормально? Так. Результат приходить від зовнішньої служби, тому не миттєво. Можете тим часом сканувати далі — рядки заповняться самі.

Товар знайшовся, але з нульовою ціною. Так і має бути: зовнішній довідник дає назву й фото, а не вашу ціну. Закупівельну ціну вкажіть у рядку закупки, продажну — у картці товару.

Де побачити штрихкод збереженого товару? У картці товару, в полі «Код товару». За цим самим значенням товар шукається у списку товарів.