[{"data":1,"prerenderedAt":358},["ShallowReactive",2],{"help-article-invoice-540":3,"help-view-invoice":37},{"data":4},{"help":5},{"id":6,"name":7,"article":8},"20","Інвойс",{"id":9,"catalog":10,"category":11,"keywords":14,"title":25,"description":26,"body":27,"legacy":28,"created_by":29,"created_at":33,"updated_at":34,"edge_associated_articles":35},"540",{"id":6,"name":7},{"id":12,"name":13},"86","Огляди можливостей",[15,16,17,18,19,20,21,22,23,24],"штрихкод","сканер штрихкодів","сканувати штрихкод","знайти товар за штрихкодом","код товару","GTIN","EAN","barcode","розумний пошук товару","штрихкод у картці товару","Штрихкоди: сканування й пошук товару","Штрихкод у OneB Invoice — це поле **«Код товару»** в картці товару. Якщо туди записано штрихкод, товар можна знайти за ним у пошуку, а в закупці — просто відсканувати сканером, і рядок заповниться сам. Ця стаття пояснює сам механізм: де працює сканер, як влаштований пошук за штрихкодом і чому результат приходить не мит","Штрихкод у OneB Invoice — це поле **«Код товару»** в картці товару. Якщо туди записано штрихкод, товар можна знайти за ним у пошуку, а в закупці — просто відсканувати сканером, і рядок заповниться сам. Ця стаття пояснює сам механізм: де працює сканер, як влаштований пошук за штрихкодом і чому результат приходить не миттєво.\n\nСтаття написана з погляду вас — власника або співробітника робочого простору.\n\n**Де це в застосунку:** Управління → Товари та послуги (поле «Код товару») і Документи → Закупки → форма створення чи редагування закупки (кнопка «Сканувати штрихкод»)\n\n## Штрихкод живе в полі «Код товару»\n\nОкремого поля «штрихкод» у картці товару немає — його роль виконує **«Код товару»**. Це зроблено навмисно: у одних компаній там артикул, у інших — штрихкод, і система працює з обома однаково.\n\nПрактичний наслідок: пошук у розділі **Товари та послуги** шукає і за назвою, і за кодом. Тобто, вставивши штрихкод у рядок пошуку, ви знайдете потрібний товар. Те саме працює в каталозі товарів, який відкривається з форми документа: почніть вводити штрихкод — і потрібна позиція знайдеться, навіть якщо ви не памʼятаєте її назви.\n\nКоли товар створюється автоматично після сканування, застосунок теж записує штрихкод саме в «Код товару».\n\n## Де працює сам сканер\n\nРежим сканування вмикається **лише у формах закупівлі** — при створенні закупки і при її редагуванні. У рахунку, кошторисі, акті, видатковій чи договорі сканер не активний: там позиції додаються з каталогу або вручну.\n\nНічого спеціально вмикати не треба — щойно ви відкрили форму закупки, сторінка вже слухає сканер. Кнопка **«Сканувати штрихкод»** поруч із «Обрати з каталогу» лише відкриває коротку підказку; сканування працює й без натискання на неї.\n\nПідходить будь-який USB- або Bluetooth-сканер, який працює «як клавіатура» — це майже всі побутові моделі. Застосунок сам відрізняє швидку «чергу» символів від сканера від звичайного набору руками і не дає штрихкоду випадково потрапити в поле, у якому стояв курсор.\n\n**Камерою телефона сканувати не можна** — такої функції в застосунку немає. Якщо треба сканувати «в полі», підключіть до телефона чи планшета Bluetooth-сканер: він для системи виглядає як клавіатура, і все працює так само. Але зручніше все ж робити це за компʼютером.\n\n## Як влаштований пошук за штрихкодом\n\nПісля кожного сканування застосунок шукає товар у два кроки.\n\n**Крок 1 — ваш каталог.** Спершу система дивиться, чи немає у ваших товарах позиції з таким кодом. Якщо є — рядок заповнюється миттєво, разом із назвою, одиницею виміру й останньою закупівельною ціною цього товару.\n\n**Крок 2 — розумний пошук.** Якщо у вашому каталозі такого штрихкоду немає, запит іде до зовнішнього довідника товарів. Ось тут і починається головна особливість: **пошук асинхронний**. Застосунок відправляє запит і не чекає відповіді «на місці» — він продовжує роботу, а результат приходить пізніше, коли зовнішня служба його підготує.\n\nПоки триває пошук, біля назви рядка крутиться індикатор. Застосунок сам перепитує результат кожні кілька секунд і підставляє його, щойно він зʼявиться. Зазвичай це секунди, зрідка — до хвилини й довше; якщо відповіді немає надто довго, пошук зупиняється, а штрихкод залишається в рядку, і назву можна вписати руками.\n\nЧерез асинхронність можна не чекати: скануйте наступний товар, заповнюйте ціни й кількості. Кілька пошуків спокійно йдуть одночасно, і кожен «приземлиться» у свій рядок.\n\nЯкщо товар знайдено, а вас у цьому рядку вже щось не влаштовує — застосунок нічого не перезапише мовчки. Коли ви почали редагувати рядок під час пошуку, знахідка приходить як **пропозиція**: біля назви зʼявляється позначка, натиснувши на яку, ви підставите знайдену назву.\n\n## Що потрапляє в каталог\n\nКоли розумний пошук знаходить товар, якого у вас ще немає, застосунок **сам створює картку товару**: назва, фото (якщо воно є в довіднику) і штрихкод у полі «Код товару». Тип ставиться «Товар», а ціна — нульова: закупівельну ціну ви вписуєте в закупці, продажну задаєте самі в картці товару.\n\nШтрихкод має бути числом із 8–14 цифр — саме такі коди розпізнає система (це звичайні EAN-8, EAN-13, UPC та подібні).\n\n## Обмеження й нюанси\n\nСканер працює тільки у формах закупівлі — при створенні й редагуванні закупки. В інших типах документів кнопки «Сканувати штрихкод» немає, і сторінка сканер не слухає.\n\nСканування камерою телефона не підтримується. Потрібен фізичний USB- або Bluetooth-сканер, який працює в режимі клавіатури.\n\nДля сканування й пошуку потрібне право керувати товарами. Якщо у вашій ролі його немає, пошук за штрихкодом не спрацює. Докладніше — [Користувачі й ролі робочого простору](https://wiki.oneb.app/help/invoice/articles/419).\n\nЛіміт розширеного пошуку **не блокує сканування**. Це найчастіше непорозуміння: коли ліміт вашого тарифу вичерпано, пошук продовжує працювати — просто застосунок більше не звертається до платних зовнішніх джерел і шукає лише у безкоштовних. Практичний наслідок один: рідкісні товари знаходитимуться рідше. Ніякої помилки чи блокування ви не побачите. Докладніше про ліміти — [Тарифний план і ліміти](https://wiki.oneb.app/help/invoice/articles/442).\n\nАвтоматичне створення товару впирається в ліміт кількості товарів вашого тарифу. Якщо ліміт вичерпано, картка товару не створиться, але назва все одно підставиться в рядок закупки — документ ви оформите, просто товар не поповнить довідник.\n\nФункція позначена як **beta**: розумний пошук ще розвивається, тож зрідка товар може не знайтися. Вмикати нічого не треба — це не експериментальна функція з налаштувань, а звичайна частина форми закупки.\n\n## Що відбувається автоматично\n\n* Знайдений товар, якого не було в каталозі, створюється автоматично — з назвою, фото і штрихкодом.\n\n* Фото товару підвантажується й зменшується до мініатюри само, окремої дії не потрібно.\n\n* Повторне сканування того самого штрихкоду не створює новий рядок, а додає **+1 до кількості**.\n\n* Для товарів, доданих у закупку раніше (з каталогу або при попередньому редагуванні), застосунок сам підтягує їхні коди й мініатюри, щоб повторний скан коректно склався в наявний рядок.\n\n## Що може змінитися\n\nРозумний пошук у бета-режимі, тож ми доопрацьовуємо: набір джерел, з яких беруться назви й фото, швидкість відповіді та якість розпізнавання рідкісних товарів. Логіка «спершу ваш каталог, потім зовнішній довідник» і поведінка сканера змінюватися не планують.\n\n## Часті питання\n\n**Чи можна сканувати штрихкоди в рахунку або акті?**\nНі. Сканер працює лише у формах закупівлі. У решті документів позиції додаються з каталогу товарів — але там теж можна ввести штрихкод у пошук і знайти потрібний товар за кодом.\n\n**Чи є сканування камерою на телефоні?**\nНі. Потрібен USB- або Bluetooth-сканер. Bluetooth-сканер можна підключити й до телефона — для застосунку він виглядає як клавіатура.\n\n**Я відсканував, а нічого не відбувається.**\nПеревірте, що ви саме у формі закупки (створення або редагування), а не в іншому документі, і що сканер налаштований у режимі клавіатури з натисканням Enter у кінці коду.\n\n**Пошук довго крутиться. Це нормально?**\nТак. Результат приходить від зовнішньої служби, тому не миттєво. Можете тим часом сканувати далі — рядки заповняться самі.\n\n**Товар знайшовся, але з нульовою ціною.**\nТак і має бути: зовнішній довідник дає назву й фото, а не вашу ціну. Закупівельну ціну вкажіть у рядку закупки, продажну — у картці товару.\n\n**Де побачити штрихкод збереженого товару?**\nУ картці товару, в полі «Код товару». За цим самим значенням товар шукається у списку товарів.\n\n## Дивіться також\n\n* [Сканування штрихкодів у закупці](https://wiki.oneb.app/help/invoice/articles/479)\n\n* [Товари та послуги](https://wiki.oneb.app/help/invoice/articles/317)\n\n* [Закупки: облік рахунків від постачальників](https://wiki.oneb.app/help/invoice/articles/456)\n\n* [Тип і категорія товару](https://wiki.oneb.app/help/invoice/articles/486)\n\n* [Тарифний план і ліміти](https://wiki.oneb.app/help/invoice/articles/442)\n\n",false,{"id":30,"name":31,"photo_url":32},"37","Ярослав Плакида","https://account.oneb.app/uploads/usr/photo/1/JMQPpCmTUtL2j8Mecr5W3TbY5ZbyK4fw.jpeg?w=300&h=300&fit=crop&s=7712ff4ac866b4965be19403505c01c8",1787998719,1788959191,{"edges":36},[],{"data":38},{"help":39},{"id":6,"name":7,"language":40,"edge_categories":43,"edge_translations":356},{"id":41,"name":42},"uk","Українська",{"page_info":44,"edges":46},{"has_next_page":28,"end_cursor":45},"W1s0XSxbMiw1NV1d",[47,79,111,143,175,203,234,266,297,329,341],{"node":48},{"id":49,"name":50,"created_at":51,"articles_count":52,"edge_preview_articles":53},"54","Початок роботи",1698401262,14,{"edges":54},[55,59,63,67,71,75],{"node":56},{"id":57,"title":58},"548","Що відбувається з даними при видаленні",{"node":60},{"id":61,"title":62},"524","Історія змін документа і відновлення версії",{"node":64},{"id":65,"title":66},"509","Що OneB Invoice робить сам",{"node":68},{"id":69,"title":70},"506","Вхід у застосунок, зміна пошти й перемикання просторів",{"node":72},{"id":73,"title":74},"505","Робочий простір: що це, аліас і кілька просторів",{"node":76},{"id":77,"title":78},"455","Головна сторінка: швидкі дії, статистика і контроль оплат",{"node":80},{"id":81,"name":82,"created_at":83,"articles_count":84,"edge_preview_articles":85},"71","Документи",1730719366,7,{"edges":86},[87,91,95,99,103,107],{"node":88},{"id":89,"title":90},"529","Документ за QR-кодом",{"node":92},{"id":93,"title":94},"526","Редагування й копіювання рахунку",{"node":96},{"id":97,"title":98},"521","Додатки до договору",{"node":100},{"id":101,"title":102},"520","Зв'язки між документами: «в рамках», батьківський документ і копія",{"node":104},{"id":105,"title":106},"518","Публічна сторінка документа очима клієнта",{"node":108},{"id":109,"title":110},"517","Картка рахунку: що можна зробити після створення",{"node":112},{"id":113,"name":114,"created_at":115,"articles_count":116,"edge_preview_articles":117},"84","Покрокові інструкції",1783639591,52,{"edges":118},[119,123,127,131,135,139],{"node":120},{"id":121,"title":122},"560","Як додати печатку компанії на документи",{"node":124},{"id":125,"title":126},"556","Як імпортувати договір із Word (.docx) у шаблон",{"node":128},{"id":129,"title":130},"531","Публічний звіт для бухгалтера чи партнера",{"node":132},{"id":133,"title":134},"514","Сторони договору й заповнення даних контрагентом",{"node":136},{"id":137,"title":138},"513","Підпис «від руки» і «на папері»",{"node":140},{"id":141,"title":142},"512","Картка договору: вкладки Огляд, Специфікація, Повʼязані, Додатки, Історія",{"node":144},{"id":145,"name":146,"created_at":147,"articles_count":148,"edge_preview_articles":149},"85","Поняття й терміни",1783640071,8,{"edges":150},[151,155,159,163,167,171],{"node":152},{"id":153,"title":154},"545","SWIFT і SEPA реквізити",{"node":156},{"id":157,"title":158},"544","Бюджет проєкту (бета)",{"node":160},{"id":161,"title":162},"541","Учасники проєкту, задачі та ставки",{"node":164},{"id":165,"title":166},"511","Що означають сторінки помилок",{"node":168},{"id":169,"title":170},"508","Публічне посилання на документ: як працює і як захистити",{"node":172},{"id":173,"title":174},"417","Типи документів у OneB Invoice: що є що",{"node":176},{"id":12,"name":13,"created_at":177,"articles_count":178,"edge_preview_articles":179},1783640913,12,{"edges":180},[181,185,189,191,195,199],{"node":182},{"id":183,"title":184},"549","Журнали дня і тижня, звіт з обліку часу",{"node":186},{"id":187,"title":188},"547","Імпорт записів часу",{"node":190},{"id":9,"title":25},{"node":192},{"id":193,"title":194},"536","Архів проєктів: куди подівся проєкт",{"node":196},{"id":197,"title":198},"523","Вибіркова аналітика: як побудувати власний звіт",{"node":200},{"id":201,"title":202},"454","Платежі: вхідні, вихідні та контроль оплат",{"node":204},{"id":205,"name":206,"created_at":207,"articles_count":148,"edge_preview_articles":208},"87","Сценарії використання",1783724309,{"edges":209},[210,214,218,222,226,230],{"node":211},{"id":212,"title":213},"546","Бухгалтер обслуговує кількох ФОП",{"node":215},{"id":216,"title":217},"542","Робота з іноземним замовником від А до Я",{"node":219},{"id":220,"title":221},"538","Файли проєкту",{"node":223},{"id":224,"title":225},"462","Погодинна робота: від обліку годин до рахунку й акта",{"node":227},{"id":228,"title":229},"461","Продаж товарів: від замовлення до видаткової накладної",{"node":231},{"id":232,"title":233},"460","Проєктна робота: кошторис, аванс, етапні акти і контроль бюджету",{"node":235},{"id":236,"name":237,"created_at":238,"articles_count":239,"edge_preview_articles":240},"93","Налаштування",1787996248,9,{"edges":241},[242,246,250,254,258,262],{"node":243},{"id":244,"title":245},"553","Доступ для служби підтримки: як дати боту тимчасовий доступ до свого простору",{"node":247},{"id":248,"title":249},"537","Додаткові поля у специфікації (колонки кошторису)",{"node":251},{"id":252,"title":253},"535","Категорії товарів",{"node":255},{"id":256,"title":257},"533","Валюти й курси",{"node":259},{"id":260,"title":261},"532","Загальні налаштування робочого простору",{"node":263},{"id":264,"title":265},"515","Формати дати, часу, чисел і валюти",{"node":267},{"id":268,"name":269,"created_at":270,"articles_count":84,"edge_preview_articles":271},"94","Кабінет клієнта та публічні сторінки",1787996251,{"edges":272},[273,277,281,285,289,293],{"node":274},{"id":275,"title":276},"543","Вітрина очима покупця",{"node":278},{"id":279,"title":280},"528","Кабінет у Telegram Mini App",{"node":282},{"id":283,"title":284},"527","Клієнт подає заявку з кабінету",{"node":286},{"id":287,"title":288},"525","Кабінет очима клієнта: головна, документи, деталі, профіль",{"node":290},{"id":291,"title":292},"522","Вхід клієнта в кабінет: посилання, код і Telegram",{"node":294},{"id":295,"title":296},"519","Кабінет клієнта: що це і як увімкнути",{"node":298},{"id":299,"name":300,"created_at":301,"articles_count":302,"edge_preview_articles":303},"95","Інтеграції та API",1787996254,6,{"edges":304},[305,309,313,317,321,325],{"node":306},{"id":307,"title":308},"534","Telegram-бот для клієнтів",{"node":310},{"id":311,"title":312},"448","Інтеграція зі School Today: рахунки за харчування учнів",{"node":314},{"id":315,"title":316},"447","Інтеграція з Prom.ua: рахунки із замовлень магазину",{"node":318},{"id":319,"title":320},"440","Webhooks: миттєві сповіщення ваших систем про події (бета)",{"node":322},{"id":323,"title":324},"439","Публічне API та API-ключі (бета)",{"node":326},{"id":327,"title":328},"281","Інтеграція OneB Invoice та OneB Finance",{"node":330},{"id":331,"name":332,"created_at":333,"articles_count":334,"edge_preview_articles":335},"58","Функціонал ",1707816481,1,{"edges":336},[337],{"node":338},{"id":339,"title":340},"402","Кабінет клієнта: що це, як увімкнути та як ним користуватися",{"node":342},{"id":343,"name":344,"created_at":345,"articles_count":346,"edge_preview_articles":347},"55","Зворотний зв'язок",1698401315,2,{"edges":348},[349,353],{"node":350},{"id":351,"title":352},"423","Часті питання: швидкі відповіді підтримки",{"node":354},{"id":355,"title":344},"133",{"edges":357},[],1791429733990]