Подключение iiko

Подключение iiko связывает вашу систему iiko с платформой enumslab, чтобы по данным продаж, заказов, доставок, складов и накладных можно было строить отчёты и сценарии (мониторинг, аналитику). Подключение выполняется через ваши учётные данные iiko — устанавливать что-либо на сервер не нужно.

Внутри платформы iiko-подключение помечается типом системы iiko.

Как работает подключение

iiko предоставляет два независимых API, и подключение enumslab может использовать оба сразу, чтобы покрыть весь объём данных:

• iiko Cloud (Transport API) — облако iiko. Отсюда берутся список организаций, меню (в том числе внешние меню агрегаторов доставки), стоп-листы, заказы доставки и столов, бронирования, сотрудники и курьеры, типы оплат, группы терминалов, справочники.
• iikoServer (Resto API / OLAP) — ваш сервер iiko. Отсюда берутся OLAP-отчёты (продажи и проводки), остатки на складах, приходные и расходные накладные, поставщики, склады, полный каталог номенклатуры, технологические карты, единицы измерения.

Соответственно, подключение хранит до четырёх учётных значений (ключи именуются ровно так):

• cloud_api_login — apiLogin для iiko Cloud (Transport API);
• server_url — адрес вашего сервера iikoServer;
• server_login — логин пользователя iikoServer;
• server_password — пароль пользователя iikoServer.

Все учётные данные хранятся в зашифрованном виде на наших серверах. Мы не передаём их третьим лицам и обрабатываем исключительно в зашифрованном виде.

Как подключить

Подключение iiko настраивается командой enumslab при подключении вашей компании к платформе. От вас потребуется только передать учётные данные iiko — мы сделаем всё остальное и убедимся, что подключение работает корректно.

Если в дальнейшем вам нужно изменить учётные данные или перенастроить подключение — просто напишите нам через страницу контактов.

Выбор организации и подразделения

Когда iiko-подключение выбрано, при построении отчёта появляется обязательное поле Подразделение (помечено звёздочкой). Это выбор филиалов: платформа сама собирает единый список, объединяя список организаций из iiko Cloud и список подразделений (измерение Department) из OLAP-отчёта по продажам, и показывает все филиалы независимо от того, в какой подсистеме iiko они заведены.

Как пользоваться выбором:

• Нажмите на поле — раскроется список. Можно отметить Все подразделения или выбрать несколько филиалов галочками.
• Сводка над списком показывает текущий выбор: — не выбрано —, Все подразделения, название одного филиала или счётчик вида «N из M выбрано».
• Если в списке ровно один филиал, он выбирается автоматически.
• Список фильтруется под текущий тип отчёта: для отчётов на основе OLAP и складских данных (продажи, проводки, остатки, накладные) показываются филиалы из OLAP-продаж; для доставок и бронирований — только филиалы с облачными данными. При смене типа отчёта несовместимые филиалы из выбора автоматически убираются.

Без выбранного подразделения отчёт не строится — под полем выводится подсказка «Выберите подразделения или "Все", чтобы построить отчёт».

Что становится доступно после подключения

Два пункта бокового меню показываются только при выбранном iiko-подключении (они помечены типом системы iiko):

• Конструктор отчётов (для iiko) — построение отчётов по данным iiko: продажи и проводки (OLAP), доставки, бронирования, остатки складов, приходные и расходные накладные, номенклатура, технологические карты — с выбором подразделения. Требует право Конструктор отчётов (report_builder).
• Мониторинг — сценарии наблюдения и оповещений по данным iiko. Требует право Мониторинг iiko (iiko_monitoring).

Остальные разделы меню (Библиотека, Ассистент, Мои отчёты и др.) не привязаны к типу системы и показываются по своим правам доступа независимо от того, выбрано iiko-подключение или 1С.

В состав функционала подключения входит набор инструментов iiko: облачные (организации, меню и внешние меню, стоп-листы, заказы доставки и столов, бронирования, сотрудники и курьеры, типы оплат, группы терминалов, справочники) и серверные (OLAP-отчёты, остатки складов, приходные и расходные накладные, поставщики, склады, каталог номенклатуры, техкарты, единицы измерения; есть и инструменты записи — создание накладных, продуктов, поставщиков и др.). Конкретный набор зависит от того, какие учётные данные заданы и какие права выданы пользователю.

Ограничения и частые вопросы

• Нужно ли что-то устанавливать на сервер iiko? Нет. iiko подключается по сети, по учётным данным API. Установка агента нужна только для 1С.
• Почему в выборе пусто или «Подразделения не найдены»? Список подразделений зависит от заданных учётных данных и типа отчёта. Если для отчёта нужен OLAP, а заданы только облачные данные (или наоборот) — подходящих филиалов не будет. Список кэшируется на сутки.
• Долго строится отчёт по продажам. OLAP-запросы по большому ресторану за 30 дней могут считаться на стороне iiko десятки секунд; платформа ждёт ответа iiko до 5 минут (300 секунд), так что ожидание на крупных данных — норма.
• Видны ли мои пароли в интерфейсе? Нет, только в маскированном виде; в открытом виде они не возвращаются нигде.