Описание

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

Автоматизация электронной очереди с iikoArrivals выглядит следующим образом:

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

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

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

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

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

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

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

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

  1. В iikoOffice проверьте, установлена ли лицензии на модуль iikoArrivals_v3 (Web FrontApi). Приложение лицензируется по количеству подключений, т. е. по числу запущенных браузеров.
  2. Скачайте iikoArrivals и скопируйте в любой удобный каталог.
    Найти iikoArrivals можно на партнерском ftp-сервере в папке последней версии iiko: <версия iiko>\Plugins\External.
  3. Установите плагин Resto.Front.Api.WebServer для iikoFront. Для этого скопируйте папку плагина в каталог C:\Program Files\iiko\iikoRMS\Front.Net\Plugins.
  4. Настройте 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
orderTypeNames
Названия типов заказов,  которые будут отображаться в iikoArrivals. Хранятся в iikoOffice - Розничные продажи - Типы заказов

showOrderWithTab

Параметр работает при использовании Табов

Если true и заказа заполнен Таб, то заказ не будет отображаться на экране

Если false, то боудут отображаться все заказы с заполнеными и пустыми Табами


false
showStatus Статус заказа, при котором начинает отображаться на экране. Указывается id статуса в KDS. 0
completeStatus Статус заказа, при котором он помечается как готовый. Указывается id статуса в KDS.
6
hideStatus

Статус заказа, при котором он прекращает отображаться на экране. Указывается id статуса в KDS.

5
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

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

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


showOrderSources

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

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


hideOrderSources

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

Пустая строка - показывать все источник


logConsole
Если true - выводит в консоль логи приложения. Нужно для определения места ошибки. Поскольку консоль потребляет память, раз в 5 минут происходит её очистка. false
showKitchenOrderFromTerminalGroup
Показывать заказы из другой группы. В случае значения true - может некорректно работать отображение и фильтрация полей ExternalNumber и OriginName
false
useOrderStatus
false - приложение использует статусы приготовления блюд

true - используются виртуальный статус, который проставляется и меняется только специальным плагином-балансировщиком.

false
showOrderStatus

Статус заказа, при котором начинает отображаться на экране в обсласти "Готовится"

Используется при useOrderStatus: true

0
completeOrderStatus

Статус заказа, при котором начинает отображаться на экране в обсласти "Готов"

Используется при useOrderStatus: true


hideOrderStatus

Статус заказа, при котором он прекращает отображаться на экране

Используется при useOrderStatus: true


cookingColumnSortType

Параметр определяющий способ сортировки заказов в области "Готовится"
Возможные варианты:
0 - по номеру заказа
1 - сортировать заказы по времени перехода в статус для отображения в этой зоне по возрастанию ("новый" заказ отображается в конце списка)
2 - сортировать заказы по времени перехода в статус для отображения в этой зоне по убыванию (("новый" заказ отображается в начале списка)

0
completedColumnSortType

Параметр определяющий способ сортировки заказов в области "Готов"
Возможные варианты:
0 - по номеру заказа
1 - сортировать заказы по времени перехода в статус для отображения в этой зоне по возрастанию ("новый" заказ отображается в конце списка)
2 - сортировать заказы по времени перехода в статус для отображения в этой зоне по убыванию (("новый" заказ отображается в начале списка)


0


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

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

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

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

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

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

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

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

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

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