Промо-купони — інструкція користувача
Промо-купон — короткий код (наприклад BLACK-A7K9), який клієнт показує касиру, а касир сканує/вводить у документі продажу. Купон дає знижку на конкретний товар, у межах обмеженої дати дії та кількості використань. Розпроведення документа продажу автоматично «повертає» купон у вільний пул.
Де знайти інструменти
Усі функції згруповані в розділі «Промо акції» (список «Аналітичні звіти та обробки» в меню => підприємство). Розділ з’являється лише коли увімкнено фіче-флаг купонів — якщо ви його не бачите, зверніться до адміністратора.
У розділі три елементи:
| Елемент | Тип | Що робить |
|---|---|---|
| Промо-купон | Плагін на документі продажу | Сканер/ввід коду купона прямо у відкритому документі продажу |
| Генерація промо-купонів | Обробка | Створює партію кодів з параметрами акції |
| Статистика використання промо акцій | Звіт | Список купонів, баланс, документи де купон списувався |
Як згенерувати партію купонів
Відкрийте обробку «Генерація промо-купонів» (Розділ → Промо акції → Генерація промо-купонів).
Поля форми
| Поле | Опис | Приклад |
|---|---|---|
| Назва акції | Внутрішня назва (у звіті/коментарі) | Чорна п'ятниця 2026 |
| Товар | Конкретна номенклатура, на яку діє знижка | Кава Lavazza 1 кг |
| Тип знижки | Тогл: Відсоток / Сума | Відсоток |
| Знижка | Значення (% або грн) | 15 |
| Діє з | Дата початку дії (за замовч. — сьогодні) | 01.12.2026 |
| Діє до | Останній день дії | 31.12.2026 |
| Ліміт використань | Скільки разів КОЖЕН код можна застосувати | 1 |
| К-сть купонів | 0 — один універсальний код = префікс; N — N унікальних prefix-XXXX | 100 |
| Префікс коду | Текст, з якого починається код | BLACK |
Натисніть «Сформувати». У повідомленні з’явиться список згенерованих кодів (наприклад BLACK-A7K9, BLACK-3F2D, ...). Скопіюйте їх для розсилки клієнтам/друку на флаєрах.
Типові сценарії
1. Один спільний код на всю акцію (наприклад BLACKFRIDAY15)
- К-сть купонів =
0 - Префікс коду =
BLACKFRIDAY15 - Ліміт використань = скільки людей може застосувати загалом (наприклад
500)
Код BLACKFRIDAY15 зможе ввести 500 різних клієнтів по 1 разу кожен.
2. Персональні купони для розсилки
- К-сть купонів =
100(скільки клієнтів) - Префікс =
BLACK(або скорочення, щоб легше було диктувати) - Ліміт використань =
1
Отримаєте 100 унікальних кодів BLACK-A7K9, BLACK-3F2D, … — кожен можна застосувати лише раз.
3. Постійна знижка для VIP
- К-сть купонів =
1для прізвища (або 0 з персональним префіксом) - Ліміт використань =
999(або великий ліміт) - Діє до = далека дата (наприклад через рік)
Обмеження
- Якщо префікс уже використовувався в інший день і є коди з тим самим префіксом — генератор шукає унікальні суфікси з нульового, за 200 спроб. Якщо не знайде — побачите помилку «Не вдалося підібрати унікальні суфікси». Тоді змініть префікс або зменшіть кількість.
- Знижка типу «Сума» більша за ціну товару → продаж піде з total = 0 (товар безкоштовний, не «з мінусовою ціною»).
Як застосувати купон у документі продажу
- Створіть/відкрийте документ продажу як зазвичай.
- Збережіть документ (хоча б один раз) — для застосування купона документ повинен мати ід (бути в режимі редагування).
- У панелі плагінів документа натисніть кнопку «Промо-купон».
- У вікні, що відкриється, введіть код (або відсканійте сканером — фокус уже на полі).
- Натисніть Enter / кнопку відправки.
Що відбувається
- Якщо код некоректний/прострочений/вичерпаний → повідомлення (
Купон не знайдено або вичерпано,Термін дії купона минув,Купон ще не активний). - Якщо все добре:
- У табличній частині документа з’являється новий рядок з товаром купона, 1 шт., зі знижкою. У колонці «Опис рядка» буде
Промо-купон <код>для відстеження. - Якщо в документі вже був рядок цього товару без купона (звичайний продаж) — у нього віднімається 1 одиниця. Якщо було рівно 1 — рядок видаляється. Логіка така, що клієнт уже планував купити цей товар, а купон дає знижку на ту саму одиницю, а не подвоює замовлення.
- У табличній частині документа з’являється новий рядок з товаром купона, 1 шт., зі знижкою. У колонці «Опис рядка» буде
- Якщо потрібно — застосуйте інший купон (на інший товар / іншу знижку): кнопку можна тиснути повторно.
- Завершіть продаж стандартно — кнопкою «Провести». У цей момент система спише купон з балансу (поставить проводку «−1»).
Якщо клієнт передумав
- Видалили рядок купона вручну → купон не буде списано (бо проводка створюється лише при проведенні документа).
- Розпровели документ після проведення → система автоматично прибирає проводку списання, купон повертається у вільний пул і його можна застосувати знову.
Скасування з помилкою
Якщо балансу не вистачає (наприклад одночасно сканували один і той самий код у двох документах) — провести документ не вдасться, і ви побачите помилку «Перевищено кількість використань промо-купона». Тоді видаліть рядок купона з документа і проведіть звичайний продаж.
Звіт «Статистика використання промо акцій»
Розділ → Промо акції → Статистика використання промо акцій.
Параметри
- Дата з / Дата до — період, у якому шукаються документи використання.
Що показує
Кожен рядок = пара (купон, документ використання у періоді). Якщо купон не використовувався у періоді — один рядок з документом «— не використано —».
Доступні групування:
- Товар — за номенклатурою акції.
- Код — за конкретним купоном (під ним згруповані документи).
- Документ використання — за документом продажу (під ним згруповані купони, які він списав).
Метрики:
- Використано — скільки разів код уже застосовано (за весь час, не тільки за період).
- Баланс — скільки ще доступно використань.
- Оборот — сума total_sum рядків купона у відповідному документі.
- Використань — лічильник 1/0 на рядок (під групою = кількість використань у періоді).
У властивостях групи «Код» бачите розшифровку: назву акції, тип/значення знижки, дати дії, стан (Активний / Погашено), обмеження.
Часті питання
Чому я не бачу розділу «Промо акції»? Не увімкнено фіче-флаг купонів. Зверніться до адміністратора БД (запис у dbconfig з config_key = 35).
Чи можна редагувати згенеровані купони після створення? Окремого редактора немає — параметри акції зашиті в момент генерації. Якщо потрібно змінити — створіть нову партію з новим префіксом і повідомте клієнтів. Старі коди продовжать працювати до закінчення Діє до.
Чи можна одному клієнту застосувати кілька купонів в одному чеку? Так, плагін викликається стільки разів, скільки потрібно — кожен раз додає окремий рядок зі своєю знижкою.
Купон вийшов прострочений, але клієнт наполягає — як обійти? Сторонній обхід не передбачено. Можна вручну: вставити у документ рядок цього товару зі знижкою і поставити коментар «Промо-купон <код> (прострочений)» — система не контролюватиме (це звичайна знижка касира).
Чи списується баланс одразу при скануванні? Ні. Списання відбувається лише при проведенні документа. Поки документ не проведений — купон тимчасово заблокований у поточному документі (повторне сканування того ж коду в цьому ж документі дасть помилку), але баланс не списаний.