r_keeper
1. Підключення плагіна Expirenza до r_keeper
Ліцензія
Для роботи Expirenza використовується інтеграція з Касовим сервером за допомогою XML-інтерфейсу. Методи API касового сервера дозволяють “читати” довідники, створювати та оплачувати замовлення.
Для оплати з автоматичним закриттям рахунку використовується метод PayOrder, який доступний з додатковою ліцензією “R-Keeper модуль XML-интерфейс для Приложения”.
Використання XML-інтерфейсу за підпискою може бути недоступно в деяких версіях r_keeper: Documentation.
Установка плагіну
Плагін Expirenza необхідно встановити на один комп'ютер з Касовим сервером r_keeper.
Завантажте архів з плагіном за посиланням: r_keeperPlugin.
Розпакуйте вміст архіву в теку
C:\monoPayment
.Правою кнопкою миші натисніть на файл install.bat і запустіть його, використовуючи пункт контекстного меню Windows “Запустити від імені Адміністратора”.
Переконайтесь, що у Планувальнику завдань Windows з‘явились такі завдання:
expz-rkeeper-daily-%HASH%
(для своєчасного оновлення плагіна)expz-rkeeper-logon-%HASH%
(для автоматичного запуску плагіна у разі перезавантаження касового сервера)
Для перезапуску плагіна необхідно використовувати файл "run_on_system_start_client.bat
".
Конфігураційний файл properties.txt
Скопіюйте в теку
C:\monoPayment
конфігураційний файл properties.txt, який раніше отримали від менеджера ExpirenzaЗгенеруйте параметр "
usr
". Це можна зробити самостійно, згідно з цією інструкцією, або скористатись спеціальним сервісом: https://admin.expirenza.com/technical/rkeeper/usrВставте отримане значення "
usr
" в параметр "SELLER_TOKEN
" в конфігураційному файліproperties.txt
.
2. Робота з API.
Увімкніть роботу з API
У менеджерській станції r_keeper необхідно включити використання API:
Перейдіть в розділ "Сервіс" → "Станції та Пристрої".
Виберіть ваш Касовий сервер зі списку.
У блоці "HTTP Обмеження" встановіть такі значення:
"XML інтерфейс" = HTTP Access
;У блоці "HTTP Server" встановіть такі значення: “
HTTP Data Port
” =8099
;Скопіюйте значення з "
HTTP Data Port
" в параметр "RKEEPER_PORT
" в конфігураційному файліproperties.txt
.
Створіть користувача для роботи з API
Перейдіть в розділ "Персонал" → "Працівники".
Створіть нову роль і відкрийте вкладку "Властивості".
У блоці "Головне" встановіть такі значення:
"Назва" = expirenza.
"Статус" = Активний.
4. У блоці "Обмеження" встановіть такі значення:
"Привілей на об'єкт" =
HTTP Access
;
5. У блоці "Касові обмеження" → "Операції" ввімкніть такі пункти:
6. У блоці "Менеджерські обмеження" → "Привілеї на об'єкти" ввімкніть такі пункти:
HTTP Access
7. У блоці "Менеджерські обмеження" → "Привілеї" ввімкніть такі пункти:
8. Збережіть створену роль.
9. Перейдіть на вкладку "Працівники" нової ролі "expirenza".
10. Створіть нового користувача з роллю "expirenza".
11. Для нового користувача, в блоці "Головне" встановіть такі значення:
"Назва" =
ExpirenzaXML
;"Статус" = Активний;
12. Вставте значення з поля “Назва” у “XMLAPI_USER
” у конфігураційному файлі properties.txt;
13. Для нового користувача, в блоці "Основні" → "Обліковий запис" створіть пароль.
Поле "Код карти" залиште порожнім;
14. Збережіть створеного користувача
15. Вставте пароль в параметр "XMLAPI_PASS
" в конфігураційному файлі properties.txt
.
Замовлення за столом
Це налаштування є опціональним,у випадку якщо ви хочете підключити функцію "Замовлення за столом "
Для створення замовлення за столом, необхідно додати нову опцію у файл properties.txt
.
Опція яку треба додати: EXPIRENZA_TABLE_ORDER_CODE
Опис опції: Код Типу замовлення, що буде створено.
Після додавання опції у файл, треба налаштувати тип замовлення:
Станція менеджера → Замовлення → Типи замовленнь.
Тип замовлення має бути доступний на касі, що використовує плагін. Тип замовлення має мати назву "Expirenza".
3. Оплата і закриття рахунків
Додайте "касира"
Перейдіть в розділ "Персонал" → "Працівники".
Виберіть роль "Касири".
Створіть нового користувача з роллю "Касири".
Для нового касира, в блоці "Головне" встановіть такі значення:
Назва" = Expirenza
"Статус" = Активний
5. Скопіюйте значення з поля "Головне" → "Код" і вставте в параметр "CASHIER_CODE
" в конфігураційному файлі properties.txt
.
Додайте "валюту"
Перейдіть в розділ "Гроші" → "Валюта".
У списку виберіть тип "Кредитні карти".
Створіть нову валюту.
У блоці "Головне" встановіть такі значення:
"Назва" = Expirenza.
"Статус" = Активний
У блоці "Основне" встановіть такі значення:
"Враховувати в звітах" = 31 Так, крім заліку передоплат;
У блоці "Обмеження" ввімкніть такі пункти:
Немає в решті;
Без решти;
Повернення страв;
Скопіюйте значення з поля "Головне" → "Код" і вставте в параметр "
PAY_TYPE_CODE
" в конфігураційному файліproperties.txt
.
Вкажіть ресторан для підключення
1. Відкрийте менеджерську станцію;
2. Зайдіть у меню “Сервіс” → “Станції та пристрої”;
3. Виберіть ресторан, що підключається;
4. Перейдіть до розділу “Властивості” вибраного ресторану;
Скопіюйте значення “Код” та внесіть у параметр
RESTAURANT_CODE
у конфігураційному файліproperties.txt
Налаштуйте друк чека
1. Перейдіть в розділ "Сервіс" → "Станції та пристрої";
2. Зі списку виберіть касову станцію на якій має виконуватися друк чека;
3. Перейдіть до розділу “Властивості” обраної касової станції;
4. Скопіюйте значення з поля "Головне" → "Код" та внесіть у параметр "CASHES_CODE
" в конфігураційному файлі properties.txt
.
4. Розрахунки
Expirenza автоматично розподіляє кошти від продажу на відповідні банківські рахунки вашого закладу. Для цього використовується класифікація страв.
Після завершення етапу технічного підключення ви зможете налаштувати розподіл коштів в розділі "Банківські рахунки" електронного кабінету закладу.
Налаштуйте класифікацію страв та напоїв
1. Перейдіть в розділ "Меню" → "Класифікації страв".
2. Виберіть зі списку класифікацію, згідно з якою розподілятимуться кошти від продажів у закладі, що підключається. Як правило, партнери обирають класифікацію "Відділ ФР".
3. Перейдіть до розділу “Властивості” вибраної класифікації страв;
4. Скопіюйте значення “Код” та внесіть у параметр CLASSIFIER_CODE
у конфігураційному файлі properties.txt
.
Перевірте класифікацію страв та напоїв
1. Перейдіть в розділ "Меню" → "Меню";
2. Переконайтеся, що для кожної страви у блоці “Класифікації встановлено коректне значення "Відділ ФР".
5. Персонал
Налаштування персоналу
Expirenza автоматично завантажує список персоналу з вашої системи. Це дозволяє нам:
Відправляти персоналу ресторану повідомлення про успішні оплати через Telegram-бот;
Перераховувати офіціантам їхні чайові на особисту картку.
Система завантажує дані тільки тих співробітників, у яких заповнене поле "Моб. телефон", тому першим кроком необхідно додати цей параметр:
Перейдіть в розділ "Налаштування" → "Налаштування" → "Розширені властивості" і виберіть пункт "Властивості для довідників".
На вкладці "Типи розширених властивостей" додайте "Новий тип розширених властивостей" з такими параметрами:
"Системне ім'я" = mobilePhone
"Назва" = Моб. телефон
"Коментар" = Моб. телефон
Натисніть на “три крапки” біля параметра "Список Типів", виберіть пункт "Додати елемент";
За допомогою меню вставки виберіть пункт "Додати елемент";
Виберіть тип об'єкта "Працівник";
В меню "Персонал" виберіть "Працівники" → "Розширені властивості". Для співробітників з посадами "касир", "офіціант", "бармен" (і / або іншими посадами, за якими співробітники в вашому закладі беруть участь в проведенні оплати і закриття рахунків) заповніть поле "Моб. телефон "в форматі" +380673435656 ".
7. Налаштування передачі додаткових даних для фіскального чеку
Даний крок є опціональним, технічно без нього оплати все також будуть працювати, але цей крок все одно важливо виконати при налаштуванні плагіну.
Тому як чек збагачується новими даними, котрих вимагає закон.
Аби уникнути штрафів за "незбагачений" чек - важливо виконати це налаштування.
Перед початком налаштування впевніться що версія вашого плагіну -> 60 або вище.
У файлі налаштувань плагіну Expirenza необхідно додати строку:
Номер порту має бути тим який надалі буде використовуватись для з'єднання з касовою станцією r_keeper.
Порт має бути вільним, або плагін не запуститься.
Якщо порт не вказаний, плагін запускається на випадковому вільному порті.
На касову станцію с фіскальними реєстраторами додаємо драйвер у розділі "Пристрої" :
http auth terminal driver (xml) ver 2
У рядку підключення драйверу вказуємо наступний шлях:
http://127.0.0.1:1234/api/terminal/
Шлях підключення драйверу обов'язково має закінчуватись на -"/"
:1234 -
порт що раніше був вказаний у файлі налаштувань плагіну Expirenza.
127.0.0.1
- якщо каса та плагін знаходяться на одному пристрої, то адреса вказується 127.0.0.1
У іншому випадку - адреса пристрою на якому запущено плагін.
Вкладка " Принтер "
Створюємо новий принтер с найменуванням "
AuthShakeToPay
".У властивостях принтера треба обрати модуль
http auth terminal driver (xml) ver 2
, проставити галочку "журналювати".
Логи драйверу записуються у корінь папки каси. Наприклад: ..\Rk7Cash\cvhttpv2_0.LOG
У властивостях станції для термінала авторизації призначаємо створений нами принтер.
У довіднику "валюти" ставимо галочку на валюті Expirenza -> "використовувати термінал авторизації"
8. Завершення технічного підключення
Для завершення етапу "Технічне підключення" заповніть, будь ласка, контрольну анкету.
Після того, як анкета буде заповнена, ми перевіримо підключення на нашому боці та надішлемо вам подальші інструкції.
Last updated