iiko — зачем нужна синхронизация

[object Object]

iiko — зачем нужна синхронизация

Если у вас стоит iiko (POS-система для ресторанов) — вы уже ведёте в ней меню, склад, смены, отчёты. Misea умеет читать iiko и подключать её к онлайн-каналам (QR-меню, доставка, сайт).

Зачем связывать iiko и Misea

Одна и та же база данных в двух местах — это ад. Изменили цену в iiko — нужно помнить обновить и в Misea. Убрали блюдо с продажи — в Misea оно всё ещё продаётся онлайн, гости заказывают то, чего нет.

Интеграция решает это: iiko остаётся источником правды, Misea забирает из неё меню и остатки.

Что синхронизируется

Из iiko в Misea (чтение)

Меню — блюда, цены, категории, модификаторы, фото (если есть в iiko).
Остатки — сколько каждого блюда доступно. «0 порций» → блюдо скрыто на витрине.
Стоп-лист — если на кассе повар поставил «стоп» на ризотто, Misea снимет его с продажи.
Типы продаж / локации — какие филиалы работают, их адреса, часы.

Из Misea в iiko (запись)

Заказы — онлайн-заказ из QR / доставки автоматически создаётся в iiko как чек.
Чеки — оплата через YooKassa привязывается к чеку в iiko.

Что НЕ синхронизируется

Сотрудники / смены — Misea ведёт свой учёт смен (/schedule, /timesheet), iiko — свой. Они не связаны.
Инвентаризация склада ингредиентов — iiko сама.
Отчёты — Misea строит свои (по онлайн-каналам), iiko — свои.

Это сознательно: Misea = онлайн-канал, iiko = офлайн-касса.

Частота синхронизации

Меню и цены — раз в час автоматически + по кнопке Синхронизировать сейчас.
Остатки — раз в 15 минут.
Стоп-лист — раз в 1 минуту (почти realtime).
Заказы из Misea в iiko — сразу после оплаты гостем.

Архитектура

Misea общается с iiko через облачное API iiko (iikoCloud API). Для подключения нужно:

Логин и пароль от iikoCloud (тот же, что у владельца для входа в iiko Web).
Организация — внутри iikoCloud может быть несколько, выбираете нужную.
Терминал — конкретная ресторан-точка, откуда брать меню.

Инструкция: iiko: подключение шаг-за-шагом.

Что, если iiko недоступен

Misea кеширует последнюю успешную синхронизацию. Если iiko упал:

Меню и остатки не обновляются, но показывают последнее известное состояние.
Онлайн-заказы принимаются, но не уходят в iiko до восстановления связи.
После восстановления — очередь заказов автоматически отправляется.

Так что гости не замечают кратковременных разрывов связи.

Цены и прайс-листы

Если в iiko у вас настроены разные прайсы (будни vs выходные, бизнес-ланч до 15:00):

Misea читает активный сейчас прайс.
Бизнес-ланч автоматически меняется с наступлением 15:00.

Модификаторы

iiko различает:

Группы модификаторов — «Молоко в латте», «Степень прожарки».
Объёмы — «Большой / средний / маленький».

Оба варианта поддерживаются и отображаются в Misea как Модификаторы.

Ограничения

Фото блюд — если их нет в iiko, гостям в Misea нечего показать. Загрузите фото в iiko или в Misea через /products — Misea запомнит переопределение.
Описания блюд — аналогично: если в iiko только название, описания добавляются в Misea.

После ручного дополнения описание/фото не перезаписывается синхронизацией — Misea помнит, что это ваш override.