Iiko — различия между версиями
(→iikoCloud) |
(→Протокол обмена) |
||
| (не показаны 22 промежуточные версии 2 участников) | |||
| Строка 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 - Помощь - О программе). | ||
| − | == | + | =Установка и обновление программы= |
| + | Дистрибутив для установки/обновления 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 | ||
| − | === | + | =Заказы= |
| − | + | Бывают двух видов: | |
| + | *Заказ клиента в зале заведения | ||
| + | *Заказ на доставку | ||
| + | |||
| + | ==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]. | ||
| − | + | Не закрытые заказы: файл \Entities\entities.sdf, таблица FrontEntities, тип Resto.CashServer.Data.Orders.CommonOrder | |
| − | |||
| − | === | + | ===Локальные настройки=== |
| − | + | Папка с настройками | |
| − | + | %HOMEPATH%\AppData\Roaming\iiko\CashServer | |
| − | + | При создании папки генерится идентификатор терминала (в каком файле где???) который нужно зарегистрировать на сервере (включить в группу) чтобы он получил доступ, пока нет регистрации у пользователя ошибка "Не настроена группа". | |
| − | |||
В случае ошибки "Не настроена группа" при запуске 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== | ||
| + | "Через апи сервера можно получить доступ к отчетам с помощью которых можно получить информацию о закрытых заказах, сервер не знает о заказах которые еще открыты." (ТП iiko) | ||
| + | |||
==iikoCloud== | ==iikoCloud== | ||
| + | Требует отдельной лицензии - аренда БД на сервере. | ||
| + | |||
Инструкция по подключению: https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud | Инструкция по подключению: https://ru.iiko.help/articles/#!api-documentations/connect-to-iiko-cloud | ||
| Строка 38: | Строка 85: | ||
===Доставка=== | ===Доставка=== | ||
Заказ по id: https://api-ru.iiko.services/#tag/Deliveries:-Retrieve/paths/~1api~11~1deliveries~1by_id/post | Заказ по 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 | Заказы по статусам и датам: 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 | Получить заказы по столам: https://api-ru.iiko.services/#tag/Orders/paths/~1api~11~1order~1by_table/post | ||
Текущая версия на 16:37, 20 августа 2021
Содержание
Контакты
- 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
