Iiko

Контакты

• iiko_client_api@iiko.ru – техническая поддержка по API.

Лицензия приобретена у компании «АРГО»:

• http://argorest.ru/
• support@argorest.ru
• 8-800-550-24-50 - телефон технической поддержки
• 8-800-500-56-88 - телефон офиса

При обращениях указываем «ID организации: 124018» (iikoOffice - Помощь - О программе).

Установка и обновление программы

Дистрибутив для установки/обновления L:\SBIS-Projects\Счета - фактуры\2. Техническая стыковка\Soft\iiko RMS7.4.6

Последнее обновление скачал https://iiko.daolog.net/746

Ставится простой установкой поверх.

Монитор сеансов

Для открытия монитора текущих сеансов надо перейти по ссылке http://test-iiko-app:8080/resto/service/monitoring/connections.jsp

Если возникла ситуация, что зависли сеансы, которые нет возможности завершить штатным методом, то необходимо:

• Открыть «Настройка сервера iikoRMS» и на вкладке «General» остановить сервер.
• Удалить файлы: «C:\Program Files\iiko\iikoRMS\Server\data\RestrictionsState.dat», «C:\Program Files\iiko\iikoRMS\Server\data\HostAccess.dat».
• Запустить сервер iiko

Заказы

Бывают двух видов:

• Заказ клиента в зале заведения
• Заказ на доставку

iikoFront

Лицензии

Для работы с заказами в зале "iikoFront Fast Food"

Для синхронизации заказов между терминалами "iikoTableService"

Для работы с заказами по доставке ???

Локальная папка %HOMEPATH%\AppData\Roaming\iiko\CashServer\, удаление папки = удалению терминала. При следующем запуске будет создана новая и новый терминал надо будет регистрировать. config.xml - настройки подключания

Протокол обмена с сервером

Не закрытые заказы передаются на сервер через события UserEvent

• orderOpened - создание нового заказа
• addItemToOrder - Изменение позиции в заказе
• deletedNewItems - Удаление позиции в заказе

iikoFront кроме сервера устанавливает tcp соединения со всеми другими зарегистрированными клиентами по порту 8506. Вероятно так контролируются лицензии на количество работающих терминалов. Если есть главная касса, то все подчиненные терминалы устанавливают tcp соединение с ней и синхронизируют данные заказов по этому соединению (используется .NET WCF).

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

Локальная база данных

База данных находится в каталоге %HOMEPATH%\AppData\Roaming\iiko\CashServer\EntitiesStorage в виде sdf файлов которые можно посмотреть при помощи CompactView.

Не закрытые заказы: файл \Entities\entities.sdf, таблица FrontEntities, тип Resto.CashServer.Data.Orders.CommonOrder

Локальные настройки

Папка с настройками %HOMEPATH%\AppData\Roaming\iiko\CashServer

При создании папки генерится идентификатор терминала (в каком файле где???) который нужно зарегистрировать на сервере (включить в группу) чтобы он получил доступ, пока нет регистрации у пользователя ошибка "Не настроена группа".

В случае ошибки "Не настроена группа" при запуске iikoFront необходимо открыть iikoOffice - Администрирование - Настройки торгового оборудования - В левой колонке выбираем Бар/Зал/Кухня и в разделе "Официальные станции и компьютеры пользователей" отмечаем галкой наш ПК. Для запуска на сервере "127.0.0.1".

В случае ошибки "Главная касса выключена" при запуске iikoFront необходимо открыть iikoOffice - Администрирование - Настройки торгового оборудования - В левой колонке выбираем "лютик" и в разделе "Точки продаж" убираем галку "Главная касса".

"Есть одно важное ограничение обычные ресторанные заказы (заказы на стол) созданные вручную в iikoFront нельзя получить через апи, информацию по ним можно получить только если заказ был создан через апи." (ТП iiko)

Логи

Логи находятся %HOMEPATH%\AppData\Roaming\iiko\CashServer\Logs

• lock-service.log - журнал установки снятия блокировок - например при открытии заказа
• update-tasks-queue.log - добавление записей в очередь на обновление
• trace.log - обновление записей на этом клиенте (не важно пользователем и сервисом синхронизации)
• front-update-service.log - логи синхронизации записей

iikoOffice

"Через апи сервера можно получить доступ к отчетам с помощью которых можно получить информацию о закрытых заказах, сервер не знает о заказах которые еще открыты." (ТП iiko)

iikoCloud

Требует отдельной лицензии - аренда БД на сервере.

Инструкция по подключению: https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud

Авторизация: https://api-ru.iiko.services/#tag/Authorization

Доставка

Заказ по id: https://api-ru.iiko.services/#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_id/post

Для получения информации по доставочным заказам за период можно использовать следующий метод https://api-ru.iiko.services/#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_delivery_date_and_source_key_and_filter/post

Заказы по статусам и датам: https://api-ru.iiko.services/#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_delivery_date_and_status/post

Если известен id заказа то можно воспользоваться методом https://api-ru.iiko.services/#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_id/post

Ресторанные заказы

Получить заказы по столам: https://api-ru.iiko.services/#tag/Orders/paths/~1api~11~1order~1by_table/post