Zero Block
Click "Block Editor" to enter the edit mode. Use layers, shapes and customize adaptability. Everything is in your hands.
Tilda Publishing
create your own block from scratch
Zero Block
Click "Block Editor" to enter the edit mode. Use layers, shapes and customize adaptability. Everything is in your hands.
Tilda Publishing
create your own block from scratch

Налаштування інтеграції Expirenza

ВАЖЛИВО: починаючи з 04.2025р ми налаштовуємо інтеграцію Expirenza виключно по податковим категоріям

Для цього клієнту перш за все потрібно звернутися в Expirenza, для того, щоб аккаунт-менеджер переключив в кабінеті Expirenza режим роботи з "Категорії страв" на "Податкові категорії"

Також наполегливо прошу при отриманні заявки від Expirenza на підключення нового клієнта - перший час першими вточнювати: який режим роботи обраний? А також, якщо обраний режим роботи "Категорії страв" -> надавати запит на переключення в режим роботи "Податкові категорії"

Прошу дуже уважно ознайомитись з ось цим пунктом меню в налаштуваннях

Максим Ванденко
02.04.2025р
Що для цього потрібно?
  1. Створити заявку на чергового в планфікс на чергового за назвою Інтеграція Expirenza.
  2. Налаштування проводиться частково за нами, частково за клієнтом.
  3. Для роботи плагіну Expirenza в Syrve необхідна ліцензія "Syrve API Payment Connector".
Ми налаштовуємо пункти:
  • Підключення плагіну Expirenza до Syrve
  • Налаштування основного типу оплати
  • Створення віртуального касира
  • Нумерація столів
  • Оплата та закриття замовлень
  • Налаштування друку сервісних чеків
  • Налаштування округлення сум
  • Налаштування Syrve POS
Клієнт налаштовує пункти:
  • Категорії та розрахунки
  • Налаштування персоналу
З цікавого:
  • розподіл коштів по розрахунковим рахункам можна налаштувати по категоріям страв (не використовуємо для нових клієнтів) або по податковим категоріям (використовуємо для нових клієнтів). Інформація змінена від 02.04.2025р.
  • непроведена оплати при закритті замовлення видаляється і розноситься по касам (як треба)
Що робимо, коли все налаштували зі свого боку?
  1. Повідомляємо клієнта про потребу налаштування категорій та персоналу.
  2. Просимо протестувати закриття замовлень по ShakeToPay\Expirenza
  3. Перекидуємо мʼячик на бік клієнта в планфіксі.

Часті помилки, що можуть виникнути:
  1. Не друкується QR-код, хоча в шаблоні він є.
  • не включений в адмінці монобанку ( перевірити можна через стан підключення до плагіну)
  • поточний драйвер принтеру не вміє друкувати QR-код ( спробуй поміняти на Win-Win)
  • кошти прийшли на не той рахунок ( перевірити категорії страв).
Процес налаштування:

Налаштування Syrve Office/Syrve HQ (Якщо клієнт чейновий НЕ РОБІТЬ Т/О в РМС, розшарте з чейну)
Налаштування податкових категорій
До цього пункту підходимо ДУЖЕ УВАЖНО! і налаштовуємо його В ТАНДЕМІ З КЛІЄНТОМ!

0) Якщо клієнт - ЧЕЙНОВИЙ, з уже існуючими РМС, у яких працює розподілення по категоріям страв, і він запускає +1 точку - то цей пункт ми пропускаємо повністю і переходимо одразу до налаштування ТО.
1) Заходимо в "Товари та склади" → "Податкові категорії"
1.1) Якщо у клієнта податкових категорій немає взагалі, у них немає жодної фіскальної каси і при цьому вони НЕ працюють з захистом від дурня - це як мінімум привід запропонувати перейти на цю систему
1.2) При створенні нової категорії, ПДВ (%) вказуємо по порядку, починаючи з 1
На виході, має вийти щось схоже на це:
В полі ПДВ (%) всі значення мають бути УНІКАЛЬНИМИ. Інакше всі страви пройдуть виключно на одного контрагента в Expirenza
(відредаговано 20.10.2025р.)

2) Розносимо в особистому кабінеті Експірензи податкові категорії по відповідним їм розрахунковим рахункам
Для цього достатньо показати ось цей скріншот людині, яка є відповідальною з боку закладу (це - приклад)
Налаштування основного типу оплати
  1. Виберіть пункт меню "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати".
  2. Заповніть форму наступним чином:
  • В поле "Найменування" введіть “Expirenza”
  • У випадаючому списку параметра "Тип" виберіть значення "Банківські картки"
  • В поле "Назва в чеку" введіть “Expirenza”
3. Позначте такі опції:
  • Забороняти вводити вручну
  • Застосовувати для всіх категорій страв
  • Друкувати товарний чек (опціонально)
  • Може прийматися ззовні
  • Є фіскальним.
4. У випадаючому списку параметра "Проведення оплат" виберіть значення "Як зовнішній, так і на стороні ресторану".
  • В поле "Код" встановіть значення "EXPZ"
  • 5. Натисніть "Зберегти".
(опціонально) Налаштування типу оплати для Dark Kitchen
Для оплати замовлень створених за допомогою модулю Syrve Delivery, Expirenza використовує окремий тип оплати. Його налаштування дещо відрізняються від базового типу оплати "Expirenza".
  1. Виберіть пункт меню "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати"
  2. Заповніть форму наступним чином:
  • В поле "Найменування" введіть “EXPZ Delivery”
  • У випадаючому списку параметра "Тип" виберіть значення "Банківські картки"
  • В поле "Назва в чеку" введіть “EXPZ Delivery”
3. Позначте такі опції:
  • Можна комбінувати з іншими типам оплат
  • Застосовувати для всіх категорій страв
  • Друкувати товарний чек (опціонально)
  • Може прийматися ззовні
  • Є фіскальним
4. В пункті "Проведення оплат" встановіть значення "Як зовнішній, так і на стороні ресторану".
  • В поле "Код" встановіть значення "DELIV"
5. Натисніть "Зберегти".

Частування Expirezna
Налаштування типу оплати для функції "Частування"
Цей тип оплати використовується для проведення розрахунків із використанням функції "Частування".
Детальніше про функцію "Частування" можна дізнатися у цій статті.
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) Створіть сертифікати для продажу частувань з такими параметрами:
ЗВЕРНІТЬ УВАГУ! У цій статті приведені лише основні властивості елементу номенклатури, важливі для роботи функції "Частування".
Будь ласка, не забувайте налаштовувати інші параметри елементу номенклатури, відповідно до практик прийнятих у кожному окремому закладі (наприклад, податкову категорію у вкладці "Додаткова інформація").
Створення віртуального касира
1) Виберіть пункт меню "Співробітники" → "Співробітники" і натисніть кнопку "Додати".
2) На сторінці "Основні відомості":
  • В поле "Ім'я в системі" введіть “Expirenza”
  • В полі “Посада” виберіть “Системний адміністратор”
  • Активуйте опцію "Тільки для плагінів"
  • Активуйте опцію "Співробітник"
3) Перейдіть на сторінку "Додаткові відомості" та встановіть унікальний ПІН-код з 4-6 цифр (він знадобиться пізніше для налаштування Syrve POS)
4) Натисніть "Зберегти"

Приклад коректно створеного віртуального касира
  • ЗВЕРНІТЬ УВАГУ! Наразі, перелік мінімально необхідних прав для віртуального касира Expirenza виглядає так:
Нумерація столів
Для коректної роботи системи, переконайтесь, що у вашому закладі (в термінах Syrve - “групі”) всі столи мають унікальний номер.
Expirenza сприймає столи з однаковими номерами, як один і той самий стіл, навіть, якщо ці столи знаходяться у різних залах.
1) Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства";
2) Оберіть відділення зі списку та перейдіть на вкладку “Налаштування столів”;
3) Порівняйте нумерацію столів у кожному відділенні;
4) Якщо номери столів дублюються, змініть нумерацію столів таким чином, щоб кожен стіл мав унікальний номер.
Приклад: У вашому закладі є відділення “Зал” та “Бар”, в кожному з яких існує стіл №5.
  • У такому разі, ви можете лишити нумерацію стола у відділенні “Зал” без змін, а у відділенні “Бар” змінити номер стола на №105.
Оплата та закриття замовлень
Після отримання оплати від гостя, Expirenza автоматично закриває замовлення у вашій системі.
Для коректної роботи плагіну, переконайтесь, що в Syrve Office / Syrve HQ виконані наступні налаштування:
  1. Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства";
  2. Оберіть відділення зі списку та перейдіть на вкладку “Загальні налаштування”;
  3. Ввімкніть опцію “Дозволити оплату замовлення без пречека”;
  4. Збережіть зміни;
  5. Повторіть ці дії для всіх відділень вашого закладу.
(опціонально) Налаштування округлення сум

Expirenza вимагає при налаштуванні інтеграції включати галочку "Округлення ціни за одиницю на користь гостя"

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

Альтернатива - залишити працювати галочку "Округляти вартість замовлення до цілого на користь гостя"
В такому випадку плагін на заокруглення не потрібен, адже суму до сплати завжди буде показувати в цілому числі.
Варто налаштувати шаблон з округленнями по контрагентах.

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

Встановлення плагіну Expirenza
Ящо у вашому закладі є декілька станцій з Syrve POS, то плагін необхідно встановити лише на головну станцію.
1) Завантажте архів з плагіном за посиланням.
2) Закрийте програму Syrve POS;
3) Визначте шлях для розпакування архіву - через провідник Windows подивіться де встановлена тека "iiko".
Можливі варіанти:
  • C:\Program Files\
  • C:\Program Files (x86)\
1) Залежно від версії, пройдіть подальший шлях по теках "iiko" → "iikoRMS" → "Front.Net" → "Plugins"
2) Створіть в теці "Plugins" теку “Resto.Front.Api.monoPayment”
3) Розпакуйте в цю теку вміст архіву з кроку 1.
4) Після коректного розпакування архіву файли будуть знаходитися за одним з двох шляхів:
  • C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.monoPayment
  • C:\Program Files(x86)\iiko\iikoRMS\Office\Plugins\Resto.Front.Api.monoPayment
5) Вставте в теку “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" вище.