Syrve

Підключення плагіну Expirenza до Syrve

Ліцензія

Запросіть у вашого менеджера Syrve додаткову ліцензію "Syrve API Payment Connector".

Вона буде потрібна під час налаштування Syrve POS, для підключення додаткового методу оплати.

---

Налаштування Syrve Office / Syrve HQ

Налаштування основного типу оплати

1. Виберіть пункт меню "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати".

2. Заповніть форму наступним чином:

   • В поле "Найменування" введіть “Expirenza”

   • У випадаючому списку параметра "Тип" виберіть значення "Банківські картки"

   • В поле "Назва в чеку" введіть “Expirenza”

3. Позначте такі опції:

   • Забороняти вводити вручну

   • Застосовувати для всіх категорій страв

   • Друкувати товарний чек (опціонально)

   • Може прийматися ззовні

   • Є фіскальним.

4. У випадаючому списку параметра "Проведення оплат" виберіть значення "Як зовнішній, так і на стороні ресторану".

   • В поле "Код" встановіть значення "EXPZ"

5. Натисніть "Зберегти".

Правильно створений тип оплати

(опціонально) Налаштування типу оплати для Dark Kitchen

Для оплати замовлень створених за допомогою модулю Syrve Delivery, Expirenza використовує окремий тип оплати. Його налаштування дещо відрізняються від базового типу оплати "Expirenza".

1. Виберіть пункт меню "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати"

2. Заповніть форму наступним чином:

   • В поле "Найменування" введіть “EXPZ Delivery”

   • У випадаючому списку параметра "Тип" виберіть значення "Банківські картки"

   • В поле "Назва в чеку" введіть “EXPZ Delivery”

3. Позначте такі опції:

   • Можна комбінувати з іншими типам оплат

   • Застосовувати для всіх категорій страв

   • Друкувати товарний чек (опціонально)

   • Може прийматися ззовні

   • Є фіскальним

4. В пункті "Проведення оплат" встановіть значення "Як зовнішній, так і на стороні ресторану".

   • В поле "Код" встановіть значення "DELIV"

5. Натисніть "Зберегти".

Приклад коректно створеного типу оплати для Dark Kitchen

Налаштування типу оплати для функції "Частування"

Цей тип оплати використовується для проведення розрахунків із використанням функції "Частування".

Детальніше про функцію "Частування" можна дізнатися у цій статті.

1. У Syrve Office перейдіть у розділ "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати".

2. Заповніть форму наступним чином:

   • В полі "Найменування" вкажіть “EXPZ Certificate”

   • В полі "Тип" виберіть "Банківські картки"

   • В полі "Назва в чеку" вкажіть “EXPZ Certificate”

3. Позначте такі опції:

   • Забороняти вводити вручну

   • Можна комбінувати з іншими типами оплати

   • Застосовувати для всіх категорій страв

   • Може прийматися ззовні

   • Є фіскальним

4. В полі “Проведення оплати” виберіть "Як зовнішній, так і на стороні ресторану"

   • В полі "Код" вкажіть "EXPZC"

5. Натисніть "Зберегти".

Приклад коректно створеного типу оплати для функції "Частування"

Налаштуйте відображення оплати із використанням функції "Частування" у фіскальному чеку, як "Сертифікат"

Нижче наведено процес зміни найменування типу оплати у фіскальному чеку на прикладі ПРРО Checkbox.

Більше інформації, щодо застосування РРО / ПРРО у разі оплати товарів та послуг з використанням подарункових сертифікатів наведено у розʼясненнях ДПС (тут і тут) та у блозі M.E.Doc.

Детальніше про функцію "Частування" можна дізнатися у цій статті.

1. В Syrve Office перейдіть у розділ “Адміністрування” → “Налаштування обладнання”

2. Оберіть зі списку РРО / ПРРО яке використовується в закладі

3. Для типу оплати "EXPZ Certificate" призначте “Реєстр ФР”

4. Перейдіть до налаштування РРО / ПРРО (на прикладі ПРРО checkbox)

5. У менеджері каси checkbox перейдіть у “Налаштування" → "Способи оплати”

6. Вкажіть спеціальну назву для способу оплати, що відповідає “Реєстру ФР”, який ви встановили для типу оплати "EXPZ Certificate" - “Подарунковий сертифікат”, "Сертифікат", "Передоплата", тощо.

7. Збережіть зміни

ЗВЕРНІТЬ УВАГУ! У Checkbox “Спосіб №1” зарезервовано для готівки. Тому “Реєстру ФР” з номером 1 у Syrve відповідатиме “Спосіб №2” у Checkbox

---

Створення “сертифікатів” для продажу частувань у номенклатурі закладу

Ці "сертифікати" використовуються для обліку продажів здійснених у закладі з використанням функції "Частування"

Детальніше про функцію "Частування" можна дізнатися у цій статті.

1. У Syrve Office перейдіть до розділу “Товари та склад” → “Номенклатура”

2. Створіть сертифікати для продажу частувань з такими параметрами:

параметр	значення	коментар
Назва	EXPZ Certificate (N)	Де "N"- умовне позначення, наприклад (ФОП) або (Кухня)
Тип номенклатури	Послуга	--
Тип місця приготування	Відповідно до налаштувань закладу	Створіть окремий сертифікат за кількістю ФР на які розділяється замовлення. Наприклад, у закладі оплату за Бар та Кухню приймають різні ФОП. В такому разі необхідно створити два сертифікати - один під Кухню і другий під Бар.
Ціна в прайс-листі ресторану	1,00	--
Вільна ціна	true	Це дозволить проводити через POS-систему продаж сертифікатів на довільну суму.
Включати в прайс-лист	Всі місця продажів	--

Приклад сертифіката для місця приготування "Кухня"

Приклад сертифіката для місця приготування "Бар"

ЗВЕРНІТЬ УВАГУ! У цій статті приведені лише основні властивості елементу номенклатури, важливі для роботи функції "Частування".

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

Створення віртуального касира

1. Виберіть пункт меню "Співробітники" → "Співробітники" і натисніть кнопку "Додати".

2. На сторінці "Основні відомості":

   • В поле "Ім'я в системі" введіть “Expirenza”

   • В полі “Посада” виберіть “Системний адміністратор”

   • Активуйте опцію "Тільки для плагінів"

   • Активуйте опцію "Співробітник"

Приклад коректно створеного віртуального касира

3. Перейдіть на сторінку "Додаткові відомості" та встановіть унікальний ПІН-код з 4-6 цифр (він знадобиться пізніше для налаштування Syrve POS)

4. Натисніть “Зберегти”

ПІН-код віртуального касира Expirenza у Syrve

ЗВЕРНІТЬ УВАГУ! Наразі, перелік мінімально необхідних прав для віртуального касира Expirenza виглядає так:

Код	Найменування
F_APIO	Авторизувати касові внесення та вилучення
F_CASH	Приймати платежі
F_CLOR	Переглядати закриті замовлення
F_CLOS	Переглядати суми в закритих замовленнях
F_PRPRE	Проводити передоплату
F_CGC	Змінювати кількість гостей
F_CHO	Відкривати замовлення в якості офіціанта
F_DNPI	Видаляти ненадруковані рядки
F_CCB	Авторизовувати операції повʼязані зі скасуванням попереднього чека
F_OMO	Відкривати кілька замовлень на один стіл
F_REP	Авторизувати видалення передоплати
F_AOT	Створювати і редагувати замовлення інших офіціантів
F_COW	Авторизувати перенесення замовлення іншому офіціантові
F_CPOTB	Роздруковувати попередній чек на замовлення інших офіціантів
D_DEP	Видаляти зовнішні платежі
B_CEXORD	Створювати зовнішні замовлення
F_PAW	Приймати оплату у якості офіціанта
PS_ADM	Проводити адміністративні операції з платіжними системами
F_EFA	Дозволяти вводити дробову кількість товару
F_MPR	Обʼєднувати столи з віддрукованими стравами
F_APA	Підтверджувати нарахування бонусних балів
F_ID	Встановлювати надбавку і знижку для замовлення
F_IDCN	Встановлювати надбавку і знижку за карткою гостя без її прокатки
F_IDGC	Встановлювати надбавку і знижку по картці гостя
F_CMP	Змінювати номер столу з віддрукованими стравами

Категорії та розрахунки

Переконайтесь, що у Syrve Office / Syrve HQ для кожної страви встановлено значення "Категорія" (наприклад, “Бар алкоголь”, “Бар безалкогольний”, “Кухня” тощо), адже Expirenza за цією ознакою розподіляє кошти від продажу страв і напоїв на відповідні банківські рахунки.

Ви зможете налаштувати розподіл коштів у адмін-панелі Expirenza у розділі "Банківські рахунки".

Приклад правильно встановлених категорій - Усім стравам призначені категорії

Кожна страва має категорію

Приклад неправильно встановлених категорій - Існують страви без категорій

Порожні категорії для страв

1. Перевірте список ваших категорій:

   • Виберіть пункт меню "Товари і склади" → "Страви" і натисніть кнопку "Дії".

   • У списку, виберіть пункт "Редагувати список категорій".

   • Якщо список категорій не відповідає вашій номенклатурі, тоді додайте нові категорії.

2. Для присвоєння категорії кільком стравам одночасно, виділіть мишкою всі страви в теці і натисніть "Дії" → "Редагувати".

3. Встановіть необхідну категорію в пункті "Категорія"

4. Натисніть "Зберегти".

Налаштування персоналу

Expirenza автоматично завантажує список персоналу з вашої системи. Це дозволяє нам:

• Надсилати їм сповіщення про успішні оплати через Telegram-бота.

• Перераховувати офіціантам (та курʼєрам закладів Dark Kitchen) їхні чайові на особисту картку.

Система завантажує дані лише тих працівників, у кого заповнене поле “Моб. телефон”.

• Виберіть пункт меню "Співробітники" → "Співробітники".

• Для зручності відсортуйте персонал за ознакою "Посада".

1. Переконайтесь, що у співробітників з посадами "касир", "офіціант", "бармен", "кур'єр" (і / або іншими посадами, за якими співробітники у вашому закладі беруть участь в проведенні оплати і закриття рахунків) заповнене поле "Моб. телефон".

2. Якщо поле "Моб. телефон" не заповнене, то додайте кожному співробітнику номер телефону в форматі "+380XXXXXXXXX" в поле "Моб. телефон" і натисніть "Зберегти".

Нумерація столів

Для коректної роботи системи, переконайтесь, що у вашому закладі (в термінах Syrve - “групі”) всі столи мають унікальний номер.

Expirenza сприймає столи з однаковими номерами, як один і той самий стіл, навіть, якщо ці столи знаходяться у різних залах.

1. Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства";

2. Оберіть відділення зі списку та перейдіть на вкладку “Налаштування столів”;

3. Порівняйте нумерацію столів у кожному відділенні;

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

Приклад: У вашому закладі є відділення “Зал” та “Бар”, в кожному з яких існує стіл №5.

У такому разі, ви можете лишити нумерацію стола у відділенні “Зал” без змін, а у відділенні “Бар” змінити номер стола на №105.

Оплата та закриття замовлень

Після отримання оплати від гостя, Expirenza автоматично закриває замовлення у вашій системі.

Для коректної роботи плагіну, переконайтесь, що в Syrve Office / Syrve HQ виконані наступні налаштування:

1. Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства";

2. Оберіть відділення зі списку та перейдіть на вкладку “Загальні налаштування”;

3. Ввімкніть опцію “Дозволити оплату замовлення без пречека”;

4. Збережіть зміни;

5. Повторіть ці дії для всіх відділень вашого закладу.

Налаштування відкладеного сканування маркування товару

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

Сканування коду маркування може здійснюватися при додаванні акцизного товару до замовлення або при закритті замовлення.

Зважаючи, що закриття замовлення плагіном відбувається без участі персоналу закладу, для коректного закриття замовлень, переконайтеся, що у Syrve Office / Syrve HQ налаштування виконані, як зазначено нижче:

1. Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства";

2. Оберіть відділення зі списку та перейдіть на вкладку "Загальні налаштування";

3. Відключіть опцію "Дозволити відкладене сканування марок";

4. Збережіть зміни;

5. Повторіть ці дії для всіх відділень вашого закладу.

Налаштування друку сервісних чеків

Перед закриттям замовлення, Syrve обовʼязково перевіряє чи були надруковані сервісні чеки ("зустрічки"). Якщо сервісні чеки не були надруковані, то закрити замовлення буде неможливо.

1. Перейдіть в пункт меню "Адміністрування";

2. Виберіть розділ "Налаштування торгового підприємства";

3. Оберіть групу зі списку;

4. На вкладці "Загальні налаштування" активуйте опцію "Сервісний друк під час виходу із замовлення";

5. Збережіть зміни;

6. Повторіть такі дії для всіх груп вашого закладу.

(опціонально) Налаштування округлення сум

Якщо у вашому закладі використовується округлення сум, для коректного зарахування коштів на банківські рахунки, переконайтеся, що налаштування округлення в Syrve Office / Syrve HQ відповідають наведеним нижче:

1. Виберіть “Адміністрування” → “Налаштування торгового підприємства”;

2. Перейдіть на вкладку "Налаштування валюти";

3. У блоці "Округлення" → "Округлення у Syrve POS" перевірте такі налаштування:

   • Відключіть опцію "Округляти вартість замовлення до цілого на користь гостя";

   • Увімкніть опцію "Округлення ціни за одиницю на користь гостя".

4. Натисніть “Зберегти зміни”.

---

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

Встановлення плагіну Expirenza

Ящо у вашому закладі є декілька станцій з Syrve POS, то плагін необхідно встановити лише на головну станцію.

1. Завантажте архів з плагіном за посиланням.

2. Закрийте програму Syrve POS;

3. Визначте шлях для розпакування архіву - через провідник Windows подивіться де встановлена тека "iiko".

   Можливі варіанти:

   • C:\Program Files\

   • C:\Program Files (x86)\

4. Залежно від версії, пройдіть подальший шлях по теках "iiko" → "iikoRMS" → "Front.Net" → "Plugins"

5. Створіть в теці "Plugins" теку “Resto.Front.Api.monoPayment”

6. Розпакуйте в цю теку вміст архіву з кроку 1.

7. Після коректного розпакування архіву файли будуть знаходитися за одним з двох шляхів:

   • C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.monoPayment

   • C:\Program Files(x86)\iiko\iikoRMS\Office\Plugins\Resto.Front.Api.monoPayment

8. Вставте в теку “Resto.Front.Api.monoPayment” файл “properties.txt”, який раніше отримали від менеджера Expirenza.

Налаштування ключів

1. Зайдіть в теку "Resto.Front.Api.monoPayment" і відкрийте файл "properties.txt" за допомогою редактора Блокнот.

2. Встановіть наступні значення:

   • RESTO_ID - заповнюється менеджером Expirenza;

   • SECRET_KEY - заповнюється менеджером Expirenza;

   • PLUGIN_USER - ПІН-код з чотирьох цифр користувача Expirenza, якого ви створили під час налаштування Syrve Office / Syrve HQ.

3. Закрийте Блокнот вибравши варіант "Зберегти зміни".

Приклад коректно заповненого блокнота

Перевірка плагіна в Syrve POS

1. Запустіть Syrve POS і перейдіть в меню “Доповнення”;

2. Виберіть пункт “Expirenza”;

3. У блоці "Основні налаштування" перевіряються обов'язкові умови для роботи плагіна Expirenza у ресторані. Тобто результат всіх перевірок у цьому блоці має бути "так".

4. У блоці "Додаткові налаштування" перевіряються умови які потрібні лише закладам зі специфічним типом обслуговування, як от додатковий тип оплати для Dark Kitchen, або не стосуються безпосередньо плагіна.

   Наприклад, як активація друку платіжних QR-кодів на попередньому чеку або накладній доставки.

---

Можливі проблеми у процесі установки

Блокування файлів брандмауером Windows

Залежно від налаштувань безпеки вашого комп'ютера, брандмауер Windows може блокувати деякі типи файлів.

Для коректної роботи плагіна Expirenza необхідно переконатися, що його файли не були заблоковані.

Як перевірити і розблокувати файли плагіна?

1. Зайдіть в теку "Resto.Front.Api.monoPayment".

2. Правою кнопкою миші натисніть на перший файл, а потім виберіть "Властивості" і перейдіть у вкладку "Загальні".

3. Якщо у вкладці "Загальні" ви бачите повідомлення про блокування файлу (як на зображенні нижче, то файл необхідно розблокувати.

4. Біля повідомлення про блокування файлу натисніть кнопку "Розблокувати", а потім натисніть кнопку "Застосувати".

5. Аналогічним чином перевірте і, за потреби, розблокуйте всі файли в теці "Resto.Front.Api.monoPayment".

6. Після розблокування файлів, перезавантажте Syrve POS і повторіть дії описані в пункті "Перевірка Syrve POS" вище.

---

Завершення технічного підключення

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

Заповнити контрольну анкету