[+]
Интеграции
[+]
[+]
 
 
 
Updated on 12/7/2018
Direct link to topic in this publication:
Специальные решения iiko
iikoArrivals

Приложение iikoArrivals – это электронное табло, на котором посетитель вашего заведения сможет увидеть, в каком статусе находится заказ, и когда его можно будет получить. Процесс использования iikoArrivals выглядит следующим образом:

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

На экране может быть доступна, например, следующая информация о заказе: номер, статус, время получения заказа, время ожидания, имя клиента, его телефон.

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

Минимальные требования

Перед установкой и использованием iikoArrivals убедитесь в следующем:

  • Установлена система iiko версии 4.3.2 и выше.
  • В составе системы iiko используется модуль «Кухонный экран» (KDS) или iikoDelivery. Использование iikoArrivals возможно только при наличии хотя бы одного из этих модулей.
  • Установлен Net. Framework версии 4.5 и выше (работа с Windows XP и POS Ready 2009 не поддерживается).

Устройства, на которых будет запускаться iikoArrivals и терминалы с iikoFront должны находиться в одной сети.

Установка и запуск приложения

Чтобы установить приложение iikoArrivals:

  1. В iikoOffice проверьте наличие установленной лицензии на модуль iikoArrivals_v3 (Web FrontApi). Приложение лицензируется по количеству подключений, т. е. по числу запущенных браузеров.
  2. Загрузите приложение по ссылке ftp://iikoarrivals:wjpfei35@ftp.iiko.ru и скопируйте в любой удобный каталог.
  3. Установите плагин Resto.Front.Api.WebServer для iikoFront. Для этого скопируйте папку плагина в каталог C:\Program Files\iiko\iikoRMS\Front.Net\Plugins. Настройте iikoArrivals для подключения к WebApi сервиса iiko в конфигурационном файле config.json, который расположен в каталоге приложения iikoArrivals. Подробнее параметрах конфигурации см. в разделе Настройка приложения, стр. 5.

Чтобы открыть iikoArrivals, запустите файл mongoose-windows.exe из каталога с приложением. В результате откроется стартовая страница iikoArrivals в браузере, с которой вы можете перейти к конкретному шаблону.

Настройка приложения

Основные настройки iikoArrivals расположены в файле config.json, который расположен в каталоге с приложением.

В таблице ниже привеждено описание используемых параметров. См. также файл documentation.json.

Параметр Описание Значение по умолчанию
webServiceUrl Адрес WebApi сервиса http://localhost:9042
deliveryScheme

Схема работы с доставочным заказом. Параметр определяет, какие статусы будет проверять приложение. Вы можете указать:

  • Delivery, тогда будут использоваться статусы доставки.
  • KDS, в этом случае будут использоваться статусы кухонного экрана.
Delivery
orderType

Типы заказов, которые будут отображаться в iikoArrivals. Возможные значения:

  • Ordinary – обычный заказ.
  • Pickup – доставка самовывоз.
  • Courier – доставка курьером.
Ordinary, Pickup, Courier
showStatus Статус заказа, при котором начинает отображаться на экране. Указывается id статуса в KDS. 0
completeStatus Статус заказа, при котором он прекращает отображаться на экране. Указывается id статуса в KDS. 5
hideStatus Статус заказа, при котором он помечается как готовый. Указывается id статуса в KDS. 6
inProgressStatusName Формат отображения статуса, когда заказ еще находится на приготовлении. Включает в себя два параметра: type и format.  
type

Тип формата вывода статуса. Возможны следующие значения:

  • ServeTime – Время получения заказа.
  • CookingTime – Время готовки.
  • RemainingTime – Время ожидания.
  • DeliverTime – Время доставки.
  • SpecialText – Стандартное слово.
ServeTime
format Формат вывода статуса. Зависит от типа формата (параметр type). Например, для типов с выводом времени используйте [HH:mm], а для типа со стандартным словом (SpecialText) – укажите это слово. HH:mm
completeStatusName Слово, отображаемое когда заказ готов. «Готов»
orderNumberLength Количество символов в номере заказа. 2
leadOrderNumberSymbol Символ, который дописывается в начало номера заказа, если количество символов в номере меньше, чем orderNumberLength. 0
ordersRefreshTimeout Промежуток времени в секундах, через который табло периодически обновляется. 15
imageChangeTimeout Промежуток времени в секундах, через который меняются изображения на табло. 30
notResponseTimeout Время ожидания ответа кассы в секундах. 30
splashChangeTimeout Промежуток времени в секундах, через который меняются всплывающие окна с готовыми заказами. 4
splashShowTimeout Время отображения всплывающего окна с готовым заказом в секундах. 3
completeStatusImage Изображение готового заказа. Если задан файл, то выводится указанное изображение. Если оставить значение пустым, то подставляется значение из настройки completeStatusName. complete.png
notResponseImage Изображение с ошибкой ответа кассы. error.png
licenseLimitImage Изображение с ошибкой количества лицензий. license-error.png
logoImage Изображение с логотипом. logo.png
backgroundImage Фоновое изображение. Значение пустое
orderCompleteSound Звук, который проигрывается, когда заказ отмечается приготовленным. Укажите файл в формате .mp3. sound.mp3
showTables

Номера столов, заказы которых отображаются на экране. Несколько столов перечислите через запятую.

Пустая строка - показывать все столы.


hideTables

Номера столов, заказы которых не отображаются на экране. Несколько столов перечислите через запятую.

Пустая строка - показывать все столы.


Warning Внимание! При настройке параметров showTables и hideTables во всех отделениях номера столов должны быть уникальные, т.к. ikoArrivals не может определить, из какого отделения поступил заказ. Например, если в Зале и в Баре есть столы с номером 101, то ни один заказ с этих столов не отобразится на экране. 

Коды (id) статусов заказов, которые используются в настройке:

  • 0 - Ожидает.
  • 1 - Пора готовить.
  • 2 - Готовится.
  • 3 - Готовится2.
  • 4 - Готовится3.
  • 5 - Готовится4.
  • 6 - Приготовлено.
  • 7 - Подано.
  • 8 - Удалено.

Все изображения, которые используются в конфигурационном файле iikoArrivals, находятся в папке content. Здесь располагаются логотипы, фоновое изображения, звук и прочие файлы, которые могут использоваться не зависимо от шаблона. Не используйте внешние источники файлов, они не поддерживаются.

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

В каталоге content\images-fullscreen расположены изображения, которые сменяют друг друга и отображаются на весь экран при отсутствии заказов.

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

Настройка шаблонов

В iikoArrivals прилагается несколько готовых шаблонов. Они располагаются в каталоге templates, каждый в своем подкаталоге, название которого совпадает с названием шаблона. Внутри этого каталога содержится:

  • Html-файл. В нем задается структура страницы, которая отображается на табло при выборе шаблона.
  • CSS-файл с описанием внешнего вида html-файла.

Вы можете использовать любой из готовых шаблонов, либо создать новый.

Чтобы создать новый, вы можете скопировать уже имеющийся каталог шаблона и переименовать его по своему усмотрению. Затем отредактируйте расположенные внутри каталога файлы в соответствии со своими корпоративными стандартами.