Iiko — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(iikoCloud)
(Протокол обмена)
 
(не показано 17 промежуточных версий 2 участников)
Строка 1: Строка 1:
===1. Контакты===
+
=Контакты=
 
*[[iiko_client_api@iiko.ru]] – техническая поддержка по API.
 
*[[iiko_client_api@iiko.ru]] – техническая поддержка по API.
 
Лицензия приобретена у компании «АРГО»:
 
Лицензия приобретена у компании «АРГО»:
Строка 7: Строка 7:
 
*8-800-500-56-88 - телефон офиса
 
*8-800-500-56-88 - телефон офиса
 
При обращениях указываем «ID организации: 124018» (iikoOffice - Помощь - О программе).
 
При обращениях указываем «ID организации: 124018» (iikoOffice - Помощь - О программе).
===2. Монитор сеансов===
+
=Установка и обновление программы=
 +
Дистрибутив для установки/обновления L:\SBIS-Projects\Счета - фактуры\2. Техническая стыковка\Soft\iiko RMS7.4.6
 +
 
 +
Последнее обновление скачал https://iiko.daolog.net/746
 +
 
 +
Ставится простой установкой поверх.
 +
=Монитор сеансов=
 
Для открытия монитора текущих сеансов надо перейти по ссылке http://test-iiko-app:8080/resto/service/monitoring/connections.jsp
 
Для открытия монитора текущих сеансов надо перейти по ссылке http://test-iiko-app:8080/resto/service/monitoring/connections.jsp
  
Строка 14: Строка 20:
 
*Удалить файлы: «C:\Program Files\iiko\iikoRMS\Server\data\RestrictionsState.dat», «C:\Program Files\iiko\iikoRMS\Server\data\HostAccess.dat».
 
*Удалить файлы: «C:\Program Files\iiko\iikoRMS\Server\data\RestrictionsState.dat», «C:\Program Files\iiko\iikoRMS\Server\data\HostAccess.dat».
 
*Запустить сервер iiko
 
*Запустить сервер iiko
===3. Установка и обновление программы===
+
=Заказы=
Дистрибутив для установки/обновления L:\SBIS-Projects\Счета - фактуры\2. Техническая стыковка\Soft\iiko RMS7.4.6
+
Бывают двух видов:
 +
*Заказ клиента в зале заведения
 +
*Заказ на доставку
 +
 
 +
==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  файлов которые можно посмотреть при помощи [https://sourceforge.net/p/compactview CompactView].
  
Последнее обновление скачал https://iiko.daolog.net/746
+
Не закрытые заказы: файл \Entities\entities.sdf, таблица FrontEntities, тип Resto.CashServer.Data.Orders.CommonOrder
  
Ставится простой установкой поверх.
 
  
===3. Заказы===
+
===Локальные настройки===
*Заказ клиента в зале заведения
+
Папка с настройками
*Заказ на доставку
+
%HOMEPATH%\AppData\Roaming\iiko\CashServer
  
==iikoFront==
+
При создании папки генерится идентификатор терминала (в каком файле где???) который нужно зарегистрировать на сервере (включить в группу) чтобы он получил доступ, пока нет регистрации у пользователя ошибка "Не настроена группа".
Для работы с заказами в зале требуется лицензия "iikoFront Fast Food"
 
Для работы с заказами по доставке требуется лицензия "iikoFront ???"
 
  
 
В случае ошибки "Не настроена группа" при запуске iikoFront необходимо открыть iikoOffice - Администрирование - Настройки торгового оборудования - В левой колонке выбираем Бар/Зал/Кухня и в разделе "Официальные станции и компьютеры пользователей" отмечаем галкой наш ПК. Для запуска на сервере "127.0.0.1".
 
В случае ошибки "Не настроена группа" при запуске 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==
 
==iikoOffice==
Строка 35: Строка 77:
  
 
==iikoCloud==
 
==iikoCloud==
 +
Требует отдельной лицензии - аренда БД на сервере.
 +
 
Инструкция по подключению: https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud
 
Инструкция по подключению: https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud
  
Строка 49: Строка 93:
  
 
===Ресторанные заказы===
 
===Ресторанные заказы===
"Есть одно важное ограничение обычные ресторанные заказы (заказы на стол) созданные вручную в iikoFront нельзя получить через апи, информацию по ним можно получить только если заказ был создан через апи." (ТП iiko)
 
  
 
Получить заказы по столам: https://api-ru.iiko.services/#tag/Orders/paths/~1api~11~1order~1by_table/post
 
Получить заказы по столам: https://api-ru.iiko.services/#tag/Orders/paths/~1api~11~1order~1by_table/post
 
Ошибка:
 
 
{
 
  "correlationId": "b032d691-ca6e-4417-9546-9e82bf2555e7",
 
  "errorDescription": "Server version (7.0.6022) for organization id = 72ba5682-eb9b-4fbc-8ad8-a80236c72182 is incompatible for this URL. Minimal allowed version is 7.1.5"
 
}
 

Текущая версия на 16:37, 20 августа 2021

Контакты

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

При обращениях указываем «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