iiko — типичные ошибки
401/403, конфликты SKU, несинхронизованные позиции, дубли модификаторов, задержка остатков.
iiko — типичные ошибки
🔴 «401 Unauthorized» / «403 Forbidden»
Причина: неверный логин/пароль или у пользователя iikoCloud недостаточно прав.
Решение:
- Войдите на iiko.biz тем же логином/паролем — если не получается, сбросьте.
- Если логин работает в iikoCloud, но 401 в Misea — проверьте, что у пользователя есть роль API access или Administrator в iikoCloud → Настройки → Пользователи.
- Иногда пароль содержит символы, не поддерживаемые API (редко) — смените на без спецсимволов.
🔴 «Organization not found»
Причина: выбран неверный UUID организации, или организация удалена.
Решение:
/settings/integrations→ iiko → удалить текущее подключение.- Перевойти — в выпадающем списке после ввода логина/пароля Misea сама покажет доступные организации.
🟠 «Синхронизация прошла, но блюд нет в /products»
Причина 1: в iiko-меню все блюда помечены как «Скрытые» или «Не для продажи».
Решение: в iikoCloud → Меню → проверьте, что блюда активны хотя бы в одном прайсе.
Причина 2: неверно выбран Терминал (тот, где нет меню).
Решение: /settings/integrations → iiko → Изменить терминал → выбрать правильный.
🟠 «Цены в Misea устарели»
Причина: автосинхронизация отключена, вы меняли цены в iiko пару часов назад.
Решение:
- Ручной Синхронизировать сейчас.
- Или в
/settings/integrations→ iiko → Расписание синхронизации → уменьшите интервал (15 мин).
🟠 «Остатки показывают 0, хотя блюдо есть»
Причина 1: в iiko у блюда включено поштучное списание, остатки на складе 0.
Решение: проверьте склад в iiko, заведите остаток ингредиентов.
Причина 2: у блюда нет технологической карты в iiko, поэтому остаток не считается.
Решение: блюдо без техкарты → заведите техкарту или пометьте блюдо как «не считать остатки» в iiko → тогда Misea будет считать его всегда доступным.
🔴 «Конфликт SKU: блюдо уже существует»
Причина: в Misea уже есть блюдо с тем же SKU (артикулом), например потому что вы сначала добавили вручную, потом подключили iiko.
Решение: /products → найдите дубликат по имени → удалите ручной вариант → пересинхронизируйте.
🟠 «Дубли модификаторов»
Причина: в iiko один и тот же модификатор привязан к блюдам как прямая группа и как общий шаблон.
Решение: в iikoCloud оставьте один из вариантов. Misea различает прямые и общие — в Misea это Модификаторы и шаблоны модификаторов.
🔴 «Timeout при синхронизации»
Причина: очень большое меню (500+ позиций) или медленное API iikoCloud.
Решение:
- Подождите 5 минут и повторите.
- Если повторяется часто — «Разбить синхронизацию на пачки» включите в
/settings/integrations→ iiko → Расширенные.
🔴 «Заказ не ушёл в iiko»
Причина 1: iikoCloud временно недоступен. Misea кеширует и повторит автоматически.
Проверить: /orders → карточка заказа → вкладка Интеграции → статус «iiko: В очереди» или «Отправлено».
Причина 2: блюдо в заказе имеет неверный iiko_id (удалено из iiko, но осталось в Misea).
Решение: /products → проверьте, нет ли блюд с красным флажком «Больше нет в iiko» → удалите или пересоздайте.
🟠 «Фото не обновляется после замены в iiko»
Причина: вы когда-то вручную загрузили фото в Misea, оно помечено как override.
Решение: /products → блюдо → фото → кнопка Сбросить override → при следующей синхронизации подтянется фото из iiko.
🔴 «Работало, теперь перестало»
Причина: в iikoCloud поменялся пароль или отозвали API-доступ.
Решение: /settings/integrations → iiko → Проверить соединение. Если красный — введите новый пароль.
Где смотреть логи
/settings/integrations → iiko → История синхронизаций (50 последних запусков с таймстампом и статусом). Для детального лога за конкретную синхронизацию — клик на строку.
Если ничего не помогло, пришлите нам в поддержку лог и ID организации — разберёмся.