Інтеграція Syrve з Choice QR

Швидке переміщення по статті:

Інтеграція з Syrve доступна для таких функцій:

доставка/take-away (самовивіз)
замовлення до столу
оплата біля столу

Для цієї інтеграції потрібні наступні ліцензії:

Syrve Live API (Transport) (доставка/самовивіз/замовлення до столу/оплата біля столу)
ApiPayments (доставка/самовивіз/замовлення до столу/оплата біля столу)
SyrveDelivery (доставка/самовивіз)
Важливо! Якщо ви не бажаєте використовувати доставку і самовивіз - ця ліцензія не потрібна.

Ці ліцензії входять до тарифних планів Syrve Cloud Professional та Enterprise.

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

При наявності необхідних ліцензії, потрібно провести наступні налаштування у Syrve Office:

У головному вікні вибрати пункт меню Обмін даними, далі у розділі Syrve Live → натиснути Налаштування Syrve Live.
Після натискання кнопки, у браузері відкриються на налаштування Syrve Web,
Далі потрібно виконати наступні дії:
1. Перейти до налаштувань Syrve Live API у блоці Зовнішні замовлення
2. Натиснути API Інтеграції → Додати та ввести назву нового API-логіна (Ім'я API логіна) → у Шаблоні прав виберіти Всі права → ввести ваш Email (обов'язкове поле) → натиснути на кнопку Додати точку (відділення) → обрати ваш заклад для інтеграції встановивши галочку → та натиснути Зберегти.
  Після цих дій, потрібно скопіювати поле API - ключ 7184fa17-411 (це приклад!) та зберегти його, наприклад у текстовому редакторі Блокнот (далі ключ необхідно буде ввести в налаштуваннях Choice).
3. Повернувшись у Syrve Office потрібно відкрити розділ Обмін даними → у блоці Legacy API натиснути Стан підключення → заповнити форму реєстрації та натиснути кнопку Зареєструвати.
4. Натиснути на Вивантаження меню, цей розділ відображає меню для вивантаження у Syrve WEB, в даному прикладі для інтеграції з Choice.
  У вікні вивантаження потрібно створити нову папку та назвати її наприклад "Choice" → обрати потрібні категорії зі стравами/товарами та натиснути кнопку Додати вибрані товари.
  
  Важливо! Кожну категорію потрібно вивантажувати окремо за прикладом вказаним далі.
  
  Після додавання усіх необхідних страв та товарів потрібно зберегти їх натиснувши Зберегти та надіслати їх у Syrve WEB натиснувши кнопку Вивантажити.
5. Для використовування функції доставки у Choice необхідно створити страву чи товар з назвою "Доставка *** грн" та вказати ціну, після чого додати її у вивантаження меню, наприклад:
  Це потрібно для передачі ціни за доставку з Choice у Syrve POS.
6. Для позначення замовлень котрі надходять з Choice у системі Syrve потрібно відкрити Роздрібні продажі → Типи оплати → натиснути кнопку Додати, та в полі Найменування вказати CHOICE → тип оплати потрібно обрати Банківські картки → встановити галочку у Може прийматися ззовні обрати тип Як зовнішній, так і на стороні ресторану → та ввести Код "CHOI" → Зберегти.
7. Налаштування функціоналу Оплата біля столика та чайових у Choice - описано нижче у розділі Налаштування функціоналу "Оплата біля столика" та чайових.

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

Відкрити адмін-панель → Інтеграції → Інтеграції з POS системами → зі списку обираємо Syrve → у поле AUTH CODE ввести API-ключ, котрий був згенерований вище, у розділі b. 2. → натиснути кнопку Активувати (Якщо у вас виникла помилка, у поле API URL потрібно ввести посилання https://api-eu.iiko.services/api/1 ).
Після активації, потрібно вказати наступні налаштування:
- У відкритій вкладці Інтеграція з POS системами обрати тип оплати в колонці PAYMENT ID.
- Вибрати потрібну організацію та BRANCH ID.
- Для приймання замовлень безпосередньо в pos-систему потрібно встановити галочку для Send order direct to POS.
- Натиснути кнопку Зберегти.
Якщо у меню немає найменувань, потрібно натиснути кнопку Синхронізація меню та зачекати, поки система вивантажить його → після повідомлення Синхронізація пройшла успішно для налаштування меню по секціям потрібно перейти у Редактор меню.
Важливо! Модифікатори для страв потрібно вводити у ручному режимі.
- Після налаштування меню, потрібно натиснути кнопку Меню, після чого меню завантажиться у файл Excel формату (*.xlsx).
Для налаштування модифікаторів, у вкладці Інтеграції з POS системами потрібно натиснути на кнопку Меню для його завантаження у файл Excel формату (*.xlsx), або відкрити його якщо він вже завантажений, в даному файлі за модифікатори відповідає змінна Modificators:
Далі у редакторі меню Chocie, в полі Доповнення до їжі (наприклад: кетчуп чи майонез) потрібно натиснути кнопку Додати та внести необхідну інформацію: назву групи модифікаторів, самі модифікатори, ціни, і POS-ID.

Важливо! Якщо у завантаженому файлі меню біля модифікатора вказано SINGLE - у Chocie потрібно вибрати тип опції Єдиний та встановити галочку Обов'язковий. Якщо біля модифікатора вказано MULTI - у Chocie потрібно вибрати тип опції Множинний та за необхідності поставити галочку Обчислюваний.

Страви до котрих присвоєний модифікатор вказані у стовпці Група.
Далі до потрібної страви можна підключити створену групу модифікаторів. У даному прикладі групу модифікаторів потрібно підключити до "Бонакви" та натиснути кнопку Зберегти.

Налаштування доставки у Choice

В адмін-панелі Choice → Інтеграції → Доставка → потрібно внести налаштування (описані у 5 пункті) → після внесення налаштувань навпроти цін на доставку необхідно ввести POS-ID, для цього потрібно відкрити файл меню, котрий завантажували при налаштуванні меню, у колонці Доставка скопіювати pos-id для відповідної ціни та вставити у відповідне поле POS-ID в Choice після чого натиснути кнопку Зберегти зміни.

Налаштування замовлення до столу у Choice

Створити схеми залів у Syrve Office.
У Choice перейти в розділ Інтеграції → Інтеграції з POS системами та натиснути кнопку Зони щоб отримати файл Excel формату (*.xlsx) з даними столів для подальшого налаштування.
Після завантаження списку столів, у Choice необхідно відкрити розділ Редактор зон та створити зони (наприклад бар,зал,караоке), для кожної зони потрібно створити стіл та вставити pos-id (із завантаженого файлу) для відповідного столу.

Важливо! Для створеного в Syrve столика №1 - обов'язково потрібно обирати pos-id відповідного столика №1 з завантаженого файлу.

Додавання столових приборів та пакування

В Syrve Office потрібно створити товар "Пакет" чи "Ланч-бокс" та додати його в Вивантаження меню, далі у Choice перейти в Інтеграції → Інтеграції з POS системами та натиснути кнопку Меню для завантаження файлу меню Excel формату.
Після чого у розділі Доставка/самовивіз натиснути кнопку Додати упаковку → ввести назву пакування, ціну та вставити POS-ID відповідного товару "Пакет" чи "Ланч-бокс" із завантаженого файлу меню.
Для додавання столових приборів, в Syrve Office так-само потрібно створити товар "Столові прибори" та додати його у Вивантаження меню, у Choice перейти в розділ Інтеграції → Інтеграції з POS системами та натиснути кнопку Меню для завантаження файлу меню з доданим товаром "Столові прибори". Після чого у розділі Доставка/самовивіз відкрити пункт Столові прилади та ввести (скопіювати) POS-ID товару "Столові прибори" із завантаженого файлу меню у відповідне поле в Choice.

Налаштування функціоналу "Оплата біля столика" та чайових

Для роботи даного функціоналу необхідно додати плагін Plugins.ChoiceQR у папку плагінів Syrve POS (c:\Program Files\SyrveRMS\Front.Net\Plugins\).
Запустити Syrve POS після завантаження котрого автоматично створиться файл конфігурації плагіна BeOpen.Front.ChoiceQR.dll.config у папці CashServer.
Далі відкрийти сторінку налаштувань інтеграції Choice: https://<ваш_домен>.choiceqr.com/admin/features/pos → Інтеграції → Інтеграція з POS системами ввести код авторизації, встановити галочку Use plugin та натиснути на кнопку Активувати.
Після активації відкриється вікно з підтвердженням зв'язку та налаштуваннями плагіна.
У папці з плагіном потрібно відкрити у текстовому редакторі файл конфігурації BeOpen.Front.ChoiceQR.dll.config ввести у ньому веб-адресу (WebSocketAddress) та ключ (AuthHeaderValue).
Після введення даних потрібно зберегти файл та перезавантажити Syrve POS.
У вікні налаштувань з 2-го кроку потрібно затвердити налаштування натиснувши кнопку Confirm connected plugin, відкриється сторінка з результатом, котру можна закрити.
Оновивши сторінку налаштувань інтеграції Choice https://<ваш_домен>.choiceqr.com/admin/features/pos потрібно ввести відповідні налаштування типу оплати для чайових, додати їх у Syrve Web, та натиснути Зберегти.
Для фіксації чайових, в Choice їх потрібно додавати в замовлення як страву. Для цього у налаштуваннях Tips Payment Id необхідно вказати Use dish tips. В Syrve Office відповідно створити страву із вільною ціною, котра буде використовуватись як чайові.
Активувати чайові відповідним перемикачем Чайові.
У головному меню Syrve POS натисніть кнопку Доповнення та виберіть ChoiceQR Показати список столів та страв у логах.
Список столів та страв буде додано в кінець лога у файлі, котрий знаходиться в %appdata%\CashServer\Logs\plugin-BeOpen.Front.ChoiceQR.log.
Після додавання страви "чайові" з лог-файлу plugin-BeOpen.Front.ChoiceQR.log потрібно скопіювати id страви "чайові" ввести даний id у конфігураційному файлі плагіна з кроку 3 (змінна DishIdForTips) та перезапустити Syrve POS.
Додати зони та столики.Id столиків можна дізнатися у лог файлі plugin-BeOpen.Front.ChoiceQR.log з кроку 8.
Відкрити необхідний стіл на сайті Choice.

Важливо! Оскільки плагін Choice QR не підтримує дві однакові страви з різними розмірами, у замовленні буде використовуватись остання з них.