iiko Integration
Connect iiko for product sync and order push
This article is currently available in Russian only. You can use your browser's built-in translation, or switch to the Russian version.
Switch to Russian version →iiko — одна из самых популярных POS-систем для ресторанов и кафе в России. Интеграция Bazex с iiko позволяет синхронизировать товары, отслеживать остатки в реальном времени и автоматически передавать заказы в кассу.
Настройка подключения
1Получите API-ключ iiko Cloud
Войдите в iiko Cloud (cloud.iiko.services). Перейдите в раздел интеграций и создайте API-логин. Скопируйте сгенерированный API-ключ — он потребуется для подключения в Bazex.
2Подключите в Bazex
Откройте Маркетплейс, найдите iiko в каталоге. Введите API-ключ и ID организации. Нажмите Проверить подключение — система проверит корректность учётных данных и связь с iiko Cloud API.
3Синхронизация товаров
После подключения Bazex выполнит начальный импорт вашего каталога из iiko. Товары сопоставляются по externalId — уникальному идентификатору из iiko. При последующих синхронизациях обновляются остатки и цены.
4Активируйте интеграцию
Включите интеграцию для запуска автоматической синхронизации. С этого момента данные между Bazex и iiko будут обновляться непрерывно.
Проверьте сопоставление товаров
Возможности после подключения
Синхронизация товаров
Bazex автоматически импортирует каталог из iiko и поддерживает его в актуальном состоянии. Каждый товар связан с iiko через поле externalId, что обеспечивает точное сопоставление при обновлениях.
Стоп-листы
Bazex опрашивает стоп-листы iiko каждые 3 минуты. Если товар попал в стоп-лист (закончился на кухне), он автоматически помечается как недоступный на вашем сайте. Также доступен ручной запрос обновления стоп-листа.
Передача заказов
Заказы, оформленные через ваш сайт на Bazex, автоматически отправляются в iiko. Повар видит заказ в системе кассы без ручного ввода.
Вебхуки iiko
При активации интеграции Bazex регистрирует вебхуки в iiko для получения мгновенных уведомлений:
- DeliveryOrderUpdate — обновления статусов заказов из iiko (готовится, готов, передан курьеру).
- StopListUpdate — мгновенное обновление стоп-листа без ожидания планового опроса.
Импорт заказов из iiko
Заказы, оформленные через собственные каналы iiko (терминал, приложение), также импортируются в Bazex. При этом заказы, изначально созданные в Bazex, фильтруются для исключения дублирования.
Устранение неполадок
- Автоматический выключатель (circuit breaker) — если iiko API возвращает ошибки 5 раз подряд, интеграция временно приостанавливается и автоматически возобновляется после восстановления связи.
- Кэширование токенов — Bazex кэширует токен авторизации iiko для повышения производительности и снижения нагрузки на API.
- Ошибка подключения — проверьте, что API-ключ актуален и ID организации указан верно. При необходимости пересоздайте API-логин в iiko Cloud.
Работа с несколькими точками
Was this article helpful?