Електронна черга замовлень Arrivals

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

• Мінімальні вимоги
• Встановлення та запуск електронного табло Arrivals
• Налаштування електронного табло Arrivals
• Налаштування шаблонів
• Вирішення проблем

     Додаток Arrivals — це електронне табло, на якому відвідувач вашого закладу зможе побачити, в якому статусі знаходиться замовлення, і коли його можна буде отримати. Також Arrivals можна розташувати в зоні відправлення замовлень на доставку, і тоді на екрані відображатиметься інформація для кур'єрів – коли будуть готові замовлення, в який термін їх слід доставити прізвище кур'єра, відповідального за замовлення.

     Процес використання Arrivals виглядає так:

1. Клієнт робить замовлення та отримує чек з його номером.
2. Замовлення передається на кухню та на табло відображається його номер (або ім'я та частину телефонного номера клієнта).
3. Після приготування на кухні відзначають, що замовлення готове, і статус замовлення на табло змінюється.
4. Гість бачить на екрані інформацію про готовність замовлення та забирає його.
5. Менеджер зазначає, що замовлення подано, і він перестає відображатись на табло.

     На екрані може бути доступна наступна інформація про замовлення: номер, статус, час отримання, час очікування, ім'я клієнта, його телефон.

     Додаток має веб-сторінку, з якої ви можете перейти до певного шаблону електронного табло. Шаблон визначає зовнішній вигляд екрана: розташування інформації на сторінці та колірну схему. Основні установки додатку виконуються у спеціальному конфігураційному файлі.

     Мінімальні вимоги 

     Перед встановленням та використанням Arrivals переконайтеся в наступному:

• Ваш тариф Syrve Cloud Professional чи Enterprise, або у складі LT системи використовується модуль "Кухонний екран" (KDS) або Delivery. Використання Arrivals можливе лише за наявності хоча б одного з цих модулів.
• Встановлено Net.Framework версії 4.7.2 та вище.

     Пристрої, на яких запускатиметься Arrivals і термінали з Syrve POS повинні знаходитися в одній мережі.

     Встановлення та запуск електронного табло Arrivals 

Щоб встановити додаток Arrivals:

1. У Syrve Office перевірте, чи встановлена ліцензія на модуль Arrivals_v3 (Web FrontApi) . Програма ліцензується за кількістю підключень, тобто за запущеними браузерами.
2. Оберіть з якого джерела Arrivals потрібно зчитувати замовлення: з KDS “Кухонний екран” чи з терміналу доставки (він же Головна каса Syrve POS) 
3. Завантажте додаток Arrivals та скопіюйте в будь-який зручний каталог на компьютер.
   Знайти Arrivals можна на партнерському ftp-сервері у папці: /release_syrve/<версія Syrve>/Plugins/External. На момент написання статті актуальна версія додатку Arrivals_v3.1.7
4. Завантажте і встановіть плагін Resto.Front.Api.WebServer для Syrve POS, звідки зчитуються дані.
   Знайти плагін можна на партнерському ftp-сервері у папці: /release_syrve/<версія Syrve>/Plugins/Front/Resto.Front.Api.WebServer. Скопіюйте папку плагіна до каталогу SyrvePOS C:\Program Files\syrve\syrveRMS\Front.Net\Plugins .
5. Налаштуйте Arrivals для підключення до WebApi сервісу Syrve у конфігураційному файлі config.json (або config.js) в каталозі додатку Arrivals, перевіривши рядок налаштувань
   "webServiceUrl": "http://localhost:9042".
   У “webServiceUrl” треба вказати ip-адресу того Syrve POS, де знаходиться плагін Resto.Front.Api.WebServer.

6. Щоб відкрити Arrivals, запустіть файл mongoose-windows.exe з каталогу додатку. Відкриється стартова сторінка Arrivals у браузері, з якої можна перейти до конкретного шаблону.

     Налаштування електронного табло Arrivals 

     Основні налаштування Arrivals розташовані у файлі config.json (або config.js), який розташований у каталозі з програмою.

     У таблиці нижче приведено опис параметрів, що використовуються. Актуальна документація доступна у файлі documentation.json у каталозі з додатком.

webServiceUrl

deliveryScheme

orderType

showStatus

completeStatus

hideStatus

inProgressStatusName

type

format

completeStatusName

orderNumberLength

leadOrderNumberSymbol

ordersRefreshTimeout

imageChangeTimeout

notResponseTimeout

splashChangeTimeout

splashShowTimeout

completeStatusImage

notResponseImage

licenseLimitImage

logoImage

backgroundImage

OrderCompleteSound

showTables

hideTables

     Примітка. При налаштуванні параметрів showTables та hideTables у всіх відділеннях номери столів мають бути унікальні, т.к. Arrivals не може визначити, з якого відділення надійшло замовлення. Наприклад, якщо в Залі та Барі є столи з номером 101, то жодне замовлення з цих столів не відобразиться на екрані.
 

     Коди (id) статусів замовлень, які використовуються у налаштуванні:

• 0 - Чекає.
• 1 - Пора готувати.
• 2 - Готується.
• 3 - Готується2.
• 4 - Готується3.
• 5 - Готується4.
• 6 - Приготовлено.
• 7 - Подано.
• 8 - Видалено.

     Усі зображення, які використовуються у конфігураційному файлі Arrivals, знаходяться у папці content. Тут розміщуються логотипи, фонове зображення, звук та інші файли, які можуть використовуватись незалежно від шаблону. Не використовуйте зовнішні джерела файлів, вони не підтримуються.

     У каталозі content\images розміщено рекламні зображення, які змінюють одне одного на табло. Не розміщуйте тут інші зображення, наприклад, логотип, фоновий малюнок тощо.

     У каталозі content\images-fullscreen розташовані зображення, які змінюють одне одного та відображаються на весь екран за відсутності замовлень.

     Для впорядкування файлів всередині каталогу content можна створити інші папки із зображеннями. Тоді в конфігураційному файлі config.json вказуйте директорію, де вона розташована. Наприклад, у каталозі content ви створили підкаталог logo та розмістили там файл logo.png. Тоді прописуючи це зображення в будь-якому параметрі, вкажіть "logo\logo.png".

     Налаштування шаблонів 

     У Arrivals додається кілька готових шаблонів. Вони розташовуються в каталозі templates, кожен у своєму підкаталозі, назва якого збігається з назвою шаблону. Усередині цього каталогу міститься:

• HTML-файл. У ньому задається структура сторінки, яка відображається на табло під час вибору шаблону.
• CSS-файл із описом зовнішнього вигляду html-файлу.

     Ви можете використовувати будь-який з готових шаблонів або створити новий.

     Щоб створити новий, ви можете скопіювати вже наявний каталог шаблону і перейменувати його на власний розсуд. Потім відредагуйте файли, розміщені всередині каталогу, відповідно до своїх корпоративних стандартів.

     Вирішення проблем

     Найчастіша проблема проявляється у вигляді помилки “Каса недоступна” на екрані Arrivals

     Для вирішення потрібно діагностувати проблему

1.     Перевірити, шо у файлі config.js параметр "webServiceUrl": "http://192.168.1.105:9042".  вказано  ip-адресу того Syrve POS, де знаходиться плагин Resto.Front.Api.WebServer і починається обов’язково з  http://

2.     Перевірити успішність старту WebServer у файлі логу
plugin-Resto.Front.Api.WebServer.log :
- якщо файл відсутній, або з попередженнями вигляду “ Access to address is denied: HTTP could not register URL http://*:9042/. Your process does not have access rights to this namespace (see http://go.microsoft.com/fwlink/?LinkId=70353 for details). Grant administrator privileges to the current user or log in as administrator and allow the current user to listen that url running command like this: “netsh http add urlacl url=http://*:<port>/ user=<user>”  - запустити Syrve POS з правами Адміністратора. 

- якщо файл присутній і є останній рядок логу “Web server started.
http://192.168.1.105:9042/ ”  але “Каса недоступна” та при переході на старінку http://192.168.1.105:9042/ - помилка “HTTP Error 503. The service is unavailable.” це свідчить, що порт зайнятий. Треба замінити порт у конфігураційному файлі плагіна (Resto.Front.Api.WebServer.dll.config) та додатку (config.js).

3.     Перевірити та усунути мережеві проблеми. Головне правило - пристрої де встановлено плагін, додаток, та де має відображатися електронна черга повинні бути доступні один одному, бажано у одній мережі, де коректно налаштовано брандмауер.

Повернутись до інших Лайфхаків