Ресториум подключается к кассе iiko напрямую: один раз вводите доступы — и поверх ваших продаж включаются семь управленческих отчётов, которые обновляются сами. Что это за отчёты и какие задачи они закрывают, мы разобрали в отдельной статье. Здесь — практика: как подготовить iiko и подключить её к Ресториуму. По времени это 10–15 минут: два шага на стороне iiko и два — в Ресториуме.
Сразу зафиксируем главное: Ресториум только читает данные — продажи, остатки, накладные, справочники. Он ничего не создаёт, не меняет и не удаляет в вашей iiko.
Что понадобится
- Доступ администратора в iikoOffice (BackOffice) — чтобы создать сервисного пользователя и выдать ему права.
- Адрес сервера iiko. Для облачной iiko это адрес вида
my-restoran.iiko.it— тот же, через который открывается ваш iikoOffice. Для собственного сервера — его адрес, доступный из интернета. - Бизнес-пространство в Ресториуме на тарифе с интеграцией iiko — интеграции живут в бизнес-пространствах (вкладка «Для бизнеса» в настройках).
Шаг 1. Создайте отдельного API-пользователя в iiko
Технически можно подключиться и под существующей учёткой, но правильнее завести отдельного сервисного пользователя — например, restorium_api. Причины простые: его действия видны в журналах iiko отдельной строкой, ему можно выдать ровно те права, которые нужны, а при необходимости — отозвать доступ одним движением, не трогая учётки сотрудников.
В iikoOffice откройте раздел «Сотрудники» и добавьте нового сотрудника:
- Карточка — именно «Сотрудник», с назначенной должностью. Это важно: пользователей с карточкой «Гость» или учёток «только для плагинов» серверный API iiko не пускает — вы получите ошибку «пользователь не является сотрудником».
- В учётных данных задайте имя для входа в систему (логин, например
restorium_api) и надёжный пароль. - Имя и должность могут быть любыми понятными — например, «Ресториум API», должность «Аналитика».
Шаг 2. Выдайте права
Права выдаются в iikoOffice: Администрирование → Права доступа. Удобнее всего завести отдельную роль (например, «API-аналитика»), выдать права ей и назначить её сервисному пользователю — так настройка остаётся прозрачной.
Вот полный список того, что использует Ресториум, и что каждое право открывает:
| Право в iiko | Код | Что открывает в Ресториуме |
|---|---|---|
| Просматривать отчёты | B_RPT | Базовый доступ к отчётам — пререквизит для трёх прав ниже |
| Право просматривать отчёты по продажам | B_CASR | Отчёты «Обзор», «ABC-анализ», «Категории», «Официанты» |
| Просматривать OLAP-отчёт по проводкам | B_VOTR | «ОПиУ» (обороты счетов) и расход в «Ликвидности» |
| Просматривать складские отчёты | B_VSR | «Ликвидность»: остатки по складам |
| Работа с товарами и складами | B_STO | Справочник складов — разрез «Ликвидности» по складам |
| Просмотр номенклатурных справочников | B_VN | Названия и категории товаров в отчётах |
| Создавать и редактировать накладные | B_INVC | «Закупки»: чтение приходных накладных. Так называется право в iiko — Ресториум при этом накладные только читает |
| Работа с данными о персонале | B_PER | Необязательно: часы и выработка в отчёте «Официанты» |
Если какое-то право не выдать, катастрофы не случится: Ресториум покажет, какие отчёты недоступны и почему (об этом — в шаге 4). Начать можно с минимума — продаж и отчётов — и добавить остальное позже.
Про лицензии iiko: подключение по серверному API занимает слот лицензии только на время запроса. Ресториум работает короткими сессиями и всегда освобождает слот сразу после обмена данными, а основная синхронизация идёт ночью — когда касса свободна.
Шаг 3. Подключите iiko в Ресториуме
В Ресториуме откройте Настройки → «Для бизнеса», выберите нужное заведение и перейдите на вкладку «Интеграции». Заполните три поля:
- Адрес сервера — например,
my-restoran.iiko.it. Можно вводить безhttps://— протокол подставится автоматически. - Логин — сервисный пользователь из шага 1, например
restorium_api. - Пароль — его пароль. Хранится в зашифрованном виде и в интерфейсе больше не отображается.
Нажмите «Сохранить», затем — «Проверить связь». Если всё в порядке, у подключения появится статус «Активно»:
Шаг 4. Сверьте чек-лист прав
После успешной проверки связи Ресториум сам пробует каждую область данных и показывает блок «Права API-пользователя» — что доступно, а чего не хватает:
Идеальная картина — все строки со статусом «Доступно». Если где-то стоит «Нет прав», выдайте недостающее право в iiko (Администрирование → Права доступа) и нажмите «Проверить права» — статус обновится сразу, ждать ничего не нужно.
Чек-лист честно показывает и частичные ситуации: например, без права на данные о персонале отчёт «Официанты» будет работать, но без колонок «Часы» и «Выработка».
Когда появятся данные
Сразу после подключения Ресториум начнёт подтягивать историю продаж примерно за полтора месяца — обычно это занимает от нескольких минут. Дальше всё обновляется автоматически: полная синхронизация каждую ночь, а блоки «Сегодня» и «Вчера» в «Обзоре» — в течение дня.
Смотреть отчёты — в разделе «Аналитика»: Обзор, ОПиУ, ABC-анализ, Категории, Ликвидность, Закупки, Официанты. В каждом есть кнопка «AI-разбор» — ассистент объяснит цифры и подскажет, что с ними делать.
Частые ошибки
«Пользователь не является сотрудником» / упоминание должности
У API-пользователя карточка не «Сотрудник» или не назначена должность. Откройте карточку в iikoOffice и проверьте: тип — сотрудник, должность — заполнена, учётка — не «только для плагинов».
Неверный логин или пароль
Проверьте учётные данные входа в iikoOffice под этим пользователем. Если пароль недавно меняли в iiko — обновите его и в Ресториуме (поле «Пароль» на вкладке «Интеграции») и снова нажмите «Проверить связь».
«Доступ запрещён»
Учётка живая, но прав не хватает. Откройте чек-лист из шага 4 — он покажет, какие именно права нужно довыдать.
«Сервер недоступен»
Проверьте адрес: для облачной iiko — точный адрес вашего сервера вида my-restoran.iiko.it, без лишних путей. Собственный сервер должен быть доступен из интернета; если он опубликован на нестандартном порту, укажите адрес вместе с портом.
Отчёт «Закупки» пустой
Либо не выдано право на накладные (B_INVC), либо в выбранном периоде просто нет приходных накладных в iiko.
Безопасность и отключение
- Пароль сервисного пользователя хранится в зашифрованном виде и не отображается в интерфейсе.
- Ресториум обращается к iiko только на чтение — данные кассы, склада и документов остаются нетронутыми.
- Отключить интеграцию можно в любой момент кнопкой «Отключить» на той же вкладке — сохранённые доступы будут удалены, данные в самой iiko это не затрагивает. Для мгновенного отзыва доступа со стороны iiko достаточно деактивировать сервисного пользователя.
Что дальше
После подключения загляните в разбор всех семи отчётов — там по каждому показано, какую задачу ресторана он закрывает: от реальной прибыли в ОПиУ до денег, замороженных на складе. А если iiko у вас пока не подключена к Ресториуму — попробуйте на демо-доступе и посмотрите на своё заведение целиком.