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. Натисніть "Зберегти".


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

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

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

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

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

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

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

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

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

ЗВЕРНІТЬ УВАГУ! Наразі, перелік мінімально необхідних прав для віртуального касира 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. Перевірте список ваших категорій:

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

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

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

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

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

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

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

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”;

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

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

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


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

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

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

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

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

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

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

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

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

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

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


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

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

Last updated