Что синхронизировать с Delivery-Iiko

Menu / Products: Синхронизация номенклатуры и цен с сайтом/приложением. Метод: /api/1/nomenclature.
Orders: Передача входящих заказов из агрегаторов в iiko. Метод: /api/1/orders/create.
Order Statuses: Обновление статуса заказа (готов, доставляется) для отображения клиенту. Метод: /api/1/orders/status.
Deliveries/Couriers: Передача данных о курьерах и их координатах для внешних систем логистики. Метод: /api/1/deliveries/courier/location.
Tables/Availability: Проверка доступности столов и стоп-листов в реальном времени. Метод: /api/1/reserve/table_availability.
Customer CRM: Синхронизация профиля клиента и бонусных баллов с CRM. Метод: /api/1/loyalty/iiko/customer/get.
Terminal Groups: Привязка заказов к конкретной кассе или точке продаж (организации). Метод: /api/1/terminal_groups.

Технические особенности API Delivery-Iiko

Аутентификация: Используется протокол авторизации через /api/1/auth/access_token, возвращающий токен (Bearer), который необходимо передавать в заголовке Authorization.
Формат данных: Обмен данными осуществляется исключительно в формате JSON (UTF-8).
Rate Limits: API поддерживает лимитирование запросов. При превышении порога (зависит от тарифа и нагрузки) сервер возвращает код 429 Too Many Requests.
Обработка ошибок: Стандартные коды: 401 (ошибка авторизации), 400 (невалидный JSON или параметры), 500 (внутренняя ошибка сервера iiko).
Webhooks: Система поддерживает механизм событий (например, при изменении статуса заказа) через /api/1/webhooks, требующий предварительной регистрации URL-адреса.
Версионирование: Используется префикс версии в URL (например, /api/1/... или /api/2/...). Рекомендуется использовать актуальную версию, указанную в документации IikoCloud API.
Песочница: Полноценная тестовая среда для разработчиков доступна через IikoCloud Developer Portal, где можно генерировать ключи API для контура разработки.

Часто задаваемые вопросы о Delivery-Iiko

Как получить API-ключ для работы с Iiko?

Для доступа необходимо зарегистрировать интеграцию в бэк-офисе iiko (раздел «Корпоративное управление» -> «Интеграции»). После настройки доступа вы получите apiLogin, который используется для получения токена авторизации.

Есть ли лимиты на количество API-запросов?

Да, iiko применяет лимиты, зависящие от типа лицензии и используемого облачного узла. При интенсивной нагрузке рекомендуется реализовать очередь запросов (queue) и повторы (retry) с экспоненциальной задержкой при получении ошибки 429.

Поддерживает ли Iiko работу с вебхуками?

Да, API позволяет подписываться на изменения заказов, статусов и номенклатуры. Для получения событий ваш сервер должен иметь публичный IP-адрес и валидный TLS-сертификат для приема POST-запросов от iiko.

Существует ли тестовый режим (sandbox)?

Для интеграторов доступен портал разработчика iiko, который позволяет создать виртуальную организацию и терминалы для отладки методов без использования реальных данных ресторана.

Как проверить совместимость версий API?

Актуальная документация всегда доступна по адресу https://api-ru.iiko.cloud/. При обновлении серверной части iiko старается сохранять обратную совместимость, но deprecated-методы помечаются в changelog, который следует отслеживать в личном кабинете.

Где найти полную документацию API?

Официальная документация поставляется в формате Swagger/OpenAPI, доступном в личном кабинете партнера iiko. Там же можно протестировать каждый метод напрямую из браузера, подставив свой токен доступа.

Настроить интеграцию Delivery-Iiko под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.