# Syrve ## Підключення плагіну Expirenza до Syrve > **Ліцензія** Запросіть у вашого менеджера Syrve додаткову ліцензію "`Syrve API Payment Connector`". Вона буде потрібна під час налаштування Syrve POS, для підключення додаткового методу оплати. *** ## Налаштування Syrve Office / Syrve HQ ### **Налаштування основного типу оплати** 1. Виберіть пункт меню "Роздрібні продажі" → "Типи оплати" і натисніть кнопку "Додати". 2. Заповніть форму наступним чином: * В поле "Найменування" введіть “Expirenza” * У випадаючому списку параметра "Тип" виберіть значення "Банківські картки" * В поле "Назва в чеку" введіть “Expirenza” 3. Позначте такі опції: * Забороняти вводити вручну * Застосовувати для всіх категорій страв * Друкувати товарний чек (опціонально) * Може прийматися ззовні * Є фіскальним. 4. У випадаючому списку параметра "Проведення оплат" виберіть значення "Як зовнішній, так і на стороні ресторану". * В поле "Код" встановіть значення "EXPZ" 5. Натисніть "Зберегти".

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

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

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

*** ### Налаштування типу замовлення Expirenza для замовлень за столом #### 1. Створення типу замовлення Шлях у меню:\ Роздрібні продажи → Типи замовлень #### Кроки 1. Перейдіть: Роздрібні продажи → Типи замовлень. 2. Натисніть Додати (створення нового типу замовлення). 3. Заповніть поля: * Найменування: `Expirenza` * Режим обслуговування: `Звичайне замовлення` Натисніть Зберегти / Зберіжіть зміни. ✅ Результат: у довіднику “Типи замовлень” з’явиться новий тип Expirenza.
#### 2. Як це працює (логіка підстановки в замовленні за столом) Під час створення замовлення за столом:
1. Спочатку система шукає тип замовлення з назвою Expirenza. 2. Якщо Expirenza не знайдено, система використовує перший доступний тип замовлення, який “попався” у списку (це поточна логіка). > Примітка: логіка fallback (“взяти перший що попався тип”) спрацьовує лише якщо Expirenza відсутній/не створений/недоступний. #### 3. Де побачити поточний тип замовлення Тип замовлення можна переглянути в картці/формі створеного замовлення за столом у полі “Тип замовлення” (або аналогічному полі в заголовку/деталях замовлення).
#### 4. Перевірка налаштування 1. Переконайтесь, що тип Expirenza створений і збережений у Типи замовлень. 2. Створіть нове замовлення за столом. 3. Перевірте, що в замовленні підставився Тип замовлення = Expirenza. #### Типові проблеми * Тип замовлення **Expirenza** не підставляється: перевірте, що назва введена точно `Expirenza` і зміни збережені. * Тип не видно в списку / не знаходиться: перевірте права доступу до довідника/налаштувань та чи активний запис (якщо у вашій системі є ознака активності). * Підставляється “не той” тип: це очікувано, якщо Expirenza не знайдено — тоді спрацьовує підстановка першого типу за поточною логікою. *** ### **Створення віртуального касира** 1. Виберіть пункт меню "Співробітники" → "Співробітники" і натисніть кнопку "Додати". 2. На сторінці "Основні відомості": * В поле "Ім'я в системі" введіть “Expirenza” * В полі “Посада” виберіть “Системний адміністратор” * Активуйте опцію "Тільки для плагінів" * Активуйте опцію "Співробітник"

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

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

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

{% hint style="warning" %} **ЗВЕРНІТЬ УВАГУ!** Наразі, перелік мінімально необхідних прав для віртуального касира Expirenza виглядає так: {% endhint %}
КодНайменування
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 у розділі "Банківські рахунки". {% hint style="success" %} Приклад правильно встановлених категорій - **Усім стравам призначені категорії** {% endhint %}

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

{% hint style="danger" %} Приклад неправильно встановлених категорій - **Існують страви без категорій** {% endhint %}

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

1. Перевірте список ваших категорій: * Виберіть пункт меню "Товари і склади" → "Страви" і натисніть кнопку "Дії". * У списку, виберіть пункт "Редагувати список категорій". * Якщо список категорій не відповідає вашій номенклатурі, тоді додайте нові категорії.
2. Для присвоєння категорії кільком стравам одночасно, виділіть мишкою всі страви в теці і натисніть "Дії" → "Редагувати". 3. Встановіть необхідну категорію в пункті "Категорія" 4. Натисніть "Зберегти".
### **Налаштування персоналу** {% hint style="info" %} Expirenza автоматично завантажує список персоналу з вашої системи. Це дозволяє нам: * Надсилати їм сповіщення про успішні оплати через Telegram-бота. * Перераховувати офіціантам (та курʼєрам закладів Dark Kitchen) їхні чайові на особисту картку. {% endhint %} Система завантажує дані лише тих працівників, у кого заповнене поле “Моб. телефон”. * Виберіть пункт меню "Співробітники" → "Співробітники". * Для зручності відсортуйте персонал за ознакою "Посада".
1. Переконайтесь, що у співробітників з посадами "касир", "офіціант", "бармен", "кур'єр" (і / або іншими посадами, за якими співробітники у вашому закладі беруть участь в проведенні оплати і закриття рахунків) заповнене поле "Моб. телефон". 2. Якщо поле "Моб. телефон" не заповнене, то додайте кожному співробітнику номер телефону в форматі "`+380XXXXXXXXX`" в поле "Моб. телефон" і натисніть "Зберегти". ### **Нумерація столів** Для коректної роботи системи, переконайтесь, що у вашому закладі (в термінах Syrve - “групі”) всі столи мають **унікальний** номер. Expirenza сприймає столи з однаковими номерами, як один і той самий стіл, навіть, якщо ці столи знаходяться у різних залах. 1. Перейдіть в пункт меню "Адміністрування" → "Налаштування торговельного підприємства"; 2. Оберіть відділення зі списку та перейдіть на вкладку “Налаштування столів”; 3. Порівняйте нумерацію столів у кожному відділенні; 4. Якщо номери столів дублюються, змініть нумерацію столів таким чином, щоб кожен стіл мав унікальний номер. {% hint style="info" %} **Приклад:** У вашому закладі є відділення “Зал” та “Бар”, в кожному з яких існує стіл №5. У такому разі, ви можете лишити нумерацію стола у відділенні “Зал” без змін, а у відділенні “Бар” змінити номер стола на №105. {% endhint %} ### **Оплата та закриття замовлень** Після отримання оплати від гостя, 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** {% hint style="warning" %} Ящо у вашому закладі є декілька станцій з Syrve POS, то плагін необхідно встановити лише на головну станцію. {% endhint %} 1. Завантажте архів з плагіном[ за посиланням.](https://plugins.expirenza.com/syrve-plugin-v7/Resto.Front.Api.monoPayment.zip) 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" вище.
*** ## Завершення технічного підключення Для завершення етапу "Технічне підключення" заповніть, будь ласка, контрольну анкету. Після того, як анкета буде заповнена, ми перевіримо підключення на нашому боці і надішлемо вам подальші інструкції. {% hint style="success" %} [Заповнити контрольну анкету](https://forms.gle/RY4oYvfagTvvJ4sv6) {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.expirenza.com/setup/pos/syrve.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.