Керівництво користувача та огляд інтеграції

Юзер гайд для нових користувачів

1. Що таке SmartReports

SmartReports показує дані із Syrve по кожній торговій точці:
виторг, кількість замовлень, доставку, кухню та присутність персоналу.
Бот працює через офіційні API Syrve Cloud / Server і не бачить нічого, що не потрапило на сервер касової системи.


2. Перший доступ до бота

  1. Власник або адміністратор видає інвайт-посилання на чат-бота.

  2. Після входу відображається головне меню з кнопками:

    • Сьогодні / Вчора / 7 днів – вибір періоду, для якого будуть будуватися звіти.

    • Основний звіт – короткий зріз по точці: виторг, кухня, персонал.

    • Інші звіти – додаткові аналітичні звіти.

    • Щоденний звіт – класичний «Z-звіт» за день у зрозумілому вигляді.

    • Доставка – аналітика та затримки по доставках.

    • Кухня – поточний стан кухні та запізнення замовлень.

    • Інструкції – довідка всередині бота.

    • Налаштування – локальні налаштування саме для цього чату.

    • Адмін-панель – розширені функції для користувачів із правами адміністратора.

    • Оновити – перечитування даних та оновлення меню.


3. Налаштування чату

Екран «Налаштування» відповідає лише за поточний чат (групу / особистий діалог).

3.1. Підписка на розсилку

Якщо чат не підписаний, бот показує звіти лише «за запитом» (по натисканню кнопок), але сам нічого не шле.

3.2. Пороги сповіщень

Ці пороги використовуються:

3.3. Групи ролей (прив’язка)

Якщо поточна абревіатура не підходить, у блоці «Абревіатури груп» дозволено змінити або додати власну.

3.4. Абревіатури груп

3.5. Розклад і частота

У цьому блоці налаштовуються одразу три речі:

  1. Час(и) автозвіту – список годин на добу у форматі HH:MM, коли чат отримує автоматичний Основний звіт.

  2. Тихі години – проміжок часу, коли бот не надсилає:

    • автозвіти;

    • алерти по кухні;

    • алерти по доставці.

  3. Мінімальний інтервал між алертами:

    • окремо для доставки;

    • окремо для кухні.

Якщо інтервал = 0, алерти приходять щоразу, коли є причина, але все одно з урахуванням тихих годин.


4. Адмін-панель

Адмін-панель доступна лише користувачам, які внесені в список адміністраторів.

Основні дії:

4.1. Прив’язка точок до чату

У блоці користувачів вибирається потрібний Telegram-чат (або користувач) і до нього прив’язуються торгові точки із Syrve.
Саме ця прив’язка визначає, по яких ресторанах бот буде показувати звіти та надсилати алерти.

4.2. Ліміти виручки (інкасація)

У відповідному розділі задається ліміт виручки для кожної точки.
Далі працює фоновий модуль:

Натискання кнопки оновлює базовий рівень («з цієї суми починається новий відлік»).


5. Основний звіт

Основний звіт – це зведення по кожній прив’язаній точці на поточний момент:

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


6. Щоденний звіт

Щоденний звіт показує класичні показники за обраний день:

Важливий момент:

Якщо, наприклад, показано:

Кількість замовлень: 11
Кількість доставок: 0

це означає 11 замовлень із залу та 0 доставок.
Якщо доставок 5, а замовлень загалом 20 – то замовлень із залу було 15 (20–5).


7. Кухня: як рахується запізнення

Екран «Кухня» та алерти по кухні працюють так:

  1. Бот бере всі відкриті замовлення за сьогодні (зал + доставка), де є хоч одна позиція, яка ще не видана й не видалена.

  2. Для кожного замовлення рахується час «на кухні»:

    • використовується момент, коли замовлення/позиція пішла в роботу (друк чека на кухню, старт готування, іноді час створення);

    • для попередньо замовлених (pre-order) враховується фактичний старт, а не момент створення.

  3. Час у хвилинах порівнюється з кухонним порогом з налаштувань.

  4. Якщо замовлення вже повинно бути готовим і перевищує поріг, воно вважається «повільним» та потрапляє до списку «черепах».

У секції «Кухня» по кожній точці видно:


8. Доставка: як рахується запізнення

За доставку відповідає окремий сервіс, який дивиться тільки доставочні замовлення.

Логіка:

  1. Для кур’єрських доставок фактичний час в дорозі рахується від моменту,
    коли замовлення передано кур’єру, до поточного часу.

  2. Для самовивозу використовується час, на який гість повинен забрати замовлення.
    Якщо поточний час ще не дійшов до дедлайну, запізнення не вважається.

  3. Після перевищення порогу для доставок замовлення вважається «черепахою» і:

    • потрапляє у звіт «Доставка»;

    • може потрапити в алерт «повільні доставки» з переліком замовлень.

У звіті «Доставка» для вибраного періоду зазвичай показуються:

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


9. Інші звіти

9.1. «Топ-страви за період»

Виводить список найпопулярніших позицій меню за обраний період:

Це допомагає бачити хіти продажів та «баласт» у меню.

9.2. «Виторг / чеки / …»

Цей звіт агрегує базові фінансові показники за період:

Формули можуть трохи відрізнятися в залежності від профілю бота; у цьому гайді описано лише загальний зміст, без конкретних формул
(точна логіка береться безпосередньо з коду інтеграції з Syrve, який тут не наводиться).

9.3. «Tax Guard»

Tax Guard – окремий аналітичний звіт для контролю номенклатури:

Конкретні критерії відбору залежать від налаштувань профілю; у цьому описі наведено тільки загальний принцип без технічних деталей
(частину логіки реалізовано у внутрішніх модулях, які не показуються в цьому файлі).


10. Якщо в ресторані є замовлення, а в боті – нулі

SmartReports отримує дані не з каси напряму, а із сервера / хмари Syrve через Transport / API-плагін:

  1. На касі працює плагін API Transport.

  2. Він відправляє інформацію про чеки та замовлення на сервер / у хмару.

  3. Бот забирає дані вже із сервера через API.

Якщо на касі замовлення є, а в боті:

найімовірніша причина:

У такому випадку ситуацію вирішує технічний спеціаліст / інтегратор всередині Syrve, а не бот.
Після відновлення роботи плагіна дані починають надходити, і звіти в SmartReports оновлюються автоматично.

 

11. Додаткові пояснення на основі перших запитань

11.1. Чим відрізняються «Сьогодні», «Основний звіт» і «Щоденний звіт»

У головному меню є три перші кнопки:

Це швидкі кнопки Основного звіту. Кожна з них одразу формує Основний звіт за відповідний період без додаткових питань.

Нижче є окремі розділи:

Коротко:


11.2. Як зараз рахується «Середній чек»

У блоці «💰 Виторг — сьогодні» середній чек наразі рахується так:

Середній чек = Виторг / Кількість замовлень (чеків)

Тобто це середній чек на замовлення, а не на гостя.

Приклад:

Саме тому значення 901.88 ₴ відрізняється від розрахунку «виторг / кількість гостей».
Якщо рахувати на гостя, буде:

Це вже інша метрика – «середній чек на гостя».

У різних ресторанах використовуються обидва підходи:

У планах розвитку – додати можливість:


11.3. Побажання до нових звітів від перших користувачів

Під час перших впроваджень уже з’явилися типові запити, які варто врахувати в дорожній карті:

  1. Звіт по категоріях за день

    • розбиття денного виторгу за категоріями (наприклад: «продуктова корзина», «барна корзина», інші групи);

    • з можливістю одразу бачити ТО за день у розрізі цих категорій;

    • бажано також показувати собівартість (с/с) дня в розрізі основних кошиків.

  2. Середній чек із урахуванням гостей

    • варіант середнього чеку «на гостя» (виторг / кількість гостей);

    • опціонально – вибір формули або одночасний показ:

      • «середній чек на замовлення»;

      • «середній чек на гостя».

  3. Прогноз виконання плану по ТО

    • відображення, на скільки відсотків уже виконано план по товарообігу за день;

    • приблизний прогноз, яким буде очікуваний ТО до кінця дня, виходячи з поточного темпу продажів (виторг + час, що минув).

Для реалізації таких звітів потрібен або:

Як влаштований бот: від звітів до налаштувань

Як бот отримує дані

Бот не зберігає власну копію даних і не рахує нічого самостійно. Щоразу, коли ви відкриваєте будь-який розділ, бот звертається до Syrve напряму і отримує актуальні цифри в реальному часі. Це означає, що якщо касир щойно закрив замовлення або кладовщик провів списання — ці дані вже будуть у звіті при наступному відкритті.

Більшість звітів використовують аналітичну систему Syrve, яка зберігає деталізовані дані по кожній позиції кожного замовлення. Складські звіти та оперативні модулі (Кухня, Доставка) працюють інакше — вони звертаються безпосередньо до відповідних баз і документів Syrve.


Головне меню і навігація

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

Кнопки периодів: «Сьогодні», «Вчора», «7 днів» і «Кастомний период» відкривають однаковий набір звітів, але одразу з потрібним проміжком часу. Не потрібно окремо вибирати дату в кожному звіті — достатньо натиснути потрібний период один раз.

Прямі кнопки нижче ведуть у розділи: Основний звіт, Щоденний звіт, Доставка, Кухня, Персонал, Інші звіти, Інструкції, Налаштування та, за наявності відповідних прав, в Адмін-панель.


Основні звіти

Основний звіт

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

Як рахується виручка: бот бере з аналітики Syrve суму по всіх позиціях замовлень із вже застосованою знижкою. Тобто якщо страва коштує 200 грн, а гість отримав знижку 10% — у виручку піде 180 грн. Повністю видалені та скасовані замовлення виключаються автоматично.

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


Щоденний звіт

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

Як рахується виручка: так само як в Основному звіті — сума позицій зі знижкою з аналітики Syrve.

Звідки доставки та залові замовлення: ці дані надходять через окремий інтерфейс Syrve Cloud — не з аналітики, а напряму з системи замовлень.

Як рахується середній чек: виручка ÷ кількість замовлень.


Оперативний контроль

Кухня

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

Позначення статусів:

Як рахується запізнення: бот дивиться, скільки хвилин замовлення реально знаходиться в кухонній роботі, і порівнює з порогом. Якщо поріг 15 хв, а замовлення вже в роботі 22 хв — бот покаже запізнення 7 хв. Для темпових або відкладених замовлень бот орієнтується на фактичний старт кухні.

Налаштування порогу: «Налаштування → Пороги сповіщень → Кухня» (5–240 хв). Частота сповіщень: «Налаштування → Частота кухні». Це розділ не для підсумків дня, а для оперативного втручання прямо зараз.


Доставка

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

Як рахуються запізнення:

Далі фактичний час порівнюється з порогом. Наприклад, якщо ліміт 60 хв, а кур'єр уже їде 74 хв — бот покаже перевищення на 14 хв.

Деталізація: можна відкрити конкретне замовлення і перевірити адресу, дедлайн, статус та фактичний час. Налаштування: «Налаштування → Пороги сповіщень → Доставка» (10–240 хв).


Персонал

Розділ «Персонал» дозволяє працювати з кадровими даними Syrve прямо з Telegram — без окремого входу в бекофіс.

Доступні дії:

Дані синхронізуються з Syrve напряму — зміни одразу відображаються в системі.


Управління доступами та користувачами

Користувачі, інвайти і доступи

Керування користувачами знаходиться в «Адмін-панель → Користувачі».

Типовий сценарій запрошення: адміністратор створює інвайт (діє 30 хв), надсилає посилання новому співробітнику. Після входу відкриває картку і призначає права та точки доступу. Саме від цих налаштувань залежить, які розділи людина побачить і по яких точках бот будуватиме звіти.

Рівні прав:

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


Точки доступу

Кожен користувач бачить звіти тільки по тих точках (ресторанах/філіях), які прив'язані до його акаунту. У шапці меню показується кількість точок доступу. Якщо значення 0 або у звітах постійно нулі — найчастіше точки ще не прив'язані.


Ліміти виторгу

Що це: контрольний механізм для касової дисципліни. Адміністратор задає суму-поріг по конкретній точці, після чого бот відстежує накопичення виручки за день і надсилає сповіщення, коли поріг перевищено.

Після інкасації або контрольної дії ліміт можна відмітити як оброблений, щоб не дублювати сигнал. Налаштування: «Адмін-панель → Ліміти виручки».


Налаштування

Розділ «Налаштування» відкривається кнопкою ⚙️ у головному меню.

Загальні налаштування

Доступно всім користувачам:

Доступно адміністраторам:


Ролі та абревіатури груп

«Групи ролей» — це зв'язок між ролями співробітників у Syrve та звітами в боті. У Syrve є ролі (офіціант, бармен, сушист, кур'єр), а в боті вони об'єднуються в зручні скорочення (КПЕ, ПКС, ПВР, КР тощо). У звітах по персоналу замість хаотичного переліку ролей відображаються акуратні групи.

Покрокове налаштування:

Після налаштування у звітах по персоналу та відпрацюваннях видно, до якої групи належить кожен співробітник.


Автозвіти, email і тихі години

Бот може автоматично надсилати звіти у Telegram-чат за розкладом — без ручного відкриття меню.

Що можна задати («Налаштування → Розклад і частота → Автозвіти»):

Що входить в автозвіт: щоденний підсумок по всіх точках: виручка, гості, замовлення, середній чек, доставки. За наявності відповідних прав — також списання, негативні залишки, залежалі запаси.


Нормативи кухні

Модуль «Нормативи кухні» дозволяє задати, скільки часу має займати приготування, і отримувати сповіщення при перевищенні.

Два режими роботи:

Налаштування режиму страв:

Частота сповіщень: мінімальна пауза між повідомленнями про перевищення — щоб бот не спамив одним сигналом щосекунди. «Налаштування → Частота кухні».


Режим навчання

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

Трек визначається автоматично за роллю:

Статуси навчання:

Як запустити: «Налаштування → Навчання → Почати».

Дії під час навчання: «Далі» / «Назад» — крок вперед або назад; «Пропустити» — пропустити поточний крок; «Пауза» — зберегти прогрес і вийти; «Перезапустити» — почати з початку; «Завершити» — закінчити достроково.

Під час навчання бот показує демо-дані — реалістичні цифри для практики без ризику змінити реальні налаштування.


Аналітичні звіти (розділ «Інші звіти»)

Блок «Інші звіти» містить детальні аналітичні звіти для продажів, сервісу, складу та контролю операцій. Це звіти не для миттєвої тривоги, а для аналізу причин і закономірностей.

Виручка по точках

Що показує: детальний фінансовий зріз — виручку, кількість замовлень, кількість гостей і середній показник у двох варіантах по кожній точці.

Як рахується:

Рядки відсортовані від найвищої виручки до найнижчої.


Продажі по категоріях страв

Що показує: по кожній точці — яка категорія меню скільки заробила, скільки разів замовлялася і яку частку займає в загальній виручці.

Як рахується частка: виручка категорії ÷ загальна виручка точки × 100. Наприклад, якщо суші дали 18 000 грн із загальних 60 000 грн — їхня частка 30%.


Знижки

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

Як рахується: бот бере поле суми знижки з кожного рядка замовлення і групує за точкою, типом знижки та офіціантом. Зручно відстежувати, де знижки застосовуються надто часто або в нетипових обсягах.


Видалення страв

Що показує: скільки позицій було видалено з замовлень, ким, на яку суму і з яким коментарем. Розбивка по офіціанту, типу видалення (зі списанням або без) і причині.

Що рахується по кожній позиції:

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


Офіціанти та гості

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

Як рахуються середні:

Можна натиснути на точку та побачити розбивку по кожному офіціанту окремо.


Топ страв

Що показує: рейтинг страв за обраний период — топ-10 або топ-20 за двома критеріями: кількістю проданих порцій і виручкою.

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


Час приготування на кухні

Що показує: три середніх показники по кожній точці, що характеризують швидкість роботи кухні.

Три показники:

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


Складські звіти

Складські звіти влаштовані інакше, ніж звіти продажів — вони не беруть дані з аналітики Syrve, а звертаються безпосередньо до складської бази та документів.

Списання

Що показує: акти списання товарів зі складу за обраний период.

По кожному документу: дата, номер, статус (новий / проведений / видалений), склад, рахунок витрат, перелік товарів із кількістю та собівартістю.

Фільтри: склад, статус, пошук по назві товару або номеру документа.


Від'ємні залишки

Що показує: товари, яких на складі менше нуля — тобто по яких облік пішов у мінус.

Як працює: бот запитує поточні складські залишки у Syrve на конкретний момент. Можна обрати: прямо зараз, кінець поточного операційного дня, кінець вчорашнього дня або конкретна дата і час.

«Порушення»: якщо від'ємний залишок перевищує встановлений поріг (за замовчуванням 0,01 одиниці) — позиція позначається як порушення. Поріг можна налаштувати. Фільтри: склад, конкретні товари, поріг.


Рух товару (залежалі запаси)

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

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

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


Як читати запізнення у кухні та доставці

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

Логіка для кухні: бот дивиться, скільки хвилин замовлення реально перебуває в кухонній роботі, і порівнює з лімітом. Приклад: ліміт 15 хв, замовлення вже 22 хв → бот покаже перевищення 7 хв.

Логіка для доставки:

Приклад: ліміт 60 хв, кур'єр вже в дорозі 74 хв → бот покаже перевищення 14 хв. Тобто бот не просто каже «є проблема», а показує, на скільки саме хвилин замовлення вийшло за норму.


Демо-режим

Демо-режим — це окремий глобальний режим роботи бота для показу функціоналу. Його перемикає тільки супер-адмін у адмін-меню.

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

Демо-стенд спільний для всіх запрошених. Звичайні користувачі бачать одне одного як «Анонім N», супер-адмін бачить реальні імена учасників.


Інструкції, FAQ і зворотний зв'язок

Розділ «Інструкції» — це вбудована база знань усередині бота. Тут зібрані статті з поясненням модулів, короткий FAQ для найчастіших питань і форма зворотного зв'язку.

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

Окремо в меню може бути блок спільноти з форумом, Telegram-групою, сайтом та додатковими посиланнями — якщо адміністратор їх заповнив.


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