Подключение к iiko

Woo2iiko общается с iiko через iiko Cloud API (базовый URL https://api-ru.iiko.services/api/1/). Для авторизации есть два способа.

Способ 1. Token broker (рекомендуется)

Получение временных iiko-токенов через сервер авторизации woo2iiko по лицензионному ключу.

Плюсы:

• Не требует хранения постоянного API-ключа в админке.
• Токены автоматически обновляются.
• Единая точка управления доступом.

Как настроить:

1. Откройте WooCommerce → iiko → Settings → API connection.
2. Выберите режим Token broker.
3. Вставьте ваш лицензионный ключ woo2iiko.
4. Сохраните.

Рекомендуется

Token broker — предпочтительный способ для большинства пользователей.

Способ 2. Legacy API key

Прямое подключение к iiko Cloud API по API-ключу.

Плюсы:

• Не зависит от внешнего сервиса авторизации.
• Полный контроль.

Минусы:

• API-ключ хранится в настройках сайта.
• Нужно следить за его актуальностью.

Как настроить:

1. Получите API-ключ в личном кабинете iiko Cloud.
2. В WooCommerce → iiko → Settings → API connection выберите Legacy API key.
3. Вставьте API-ключ.
4. Сохраните.

Таймаут запросов

Настройка Время ожидания запроса к iiko (iiko_request_timeout, по умолчанию 15 секунд) — максимальное время HTTP-запроса к iiko Cloud API.

• Увеличьте, если сервер iiko отвечает медленно (например, при импорте больших номенклатур).
• Слишком большое значение может привести к таймаутам PHP.

Проверка подключения

После сохранения:

1. На странице настроек должна появиться информация об организации.
2. В блоке debug info виден статус подключения.
3. Можно запустить импорт номенклатуры — если данные пришли, подключение работает.

Что проверять при сбое

• Правильность ключа (license key / API key).
• Доступность сервера: исходящие HTTPS к api-ru.iiko.services.
• Не заблокирован ли IP хостинга на стороне iiko.
• Нет ли ошибок в логах.

Если нужно сменить способ авторизации

Сменить Token broker ↔ Legacy API key можно в любой момент в настройках. Текущая авторизация используется для всех операций (импорт, экспорт, синхронизация).

WP-CLI

Сбросить токен можно командой:

wp woo2iiko ajax_data reset-token

См. также

• Выбор организации и терминала
• Первый импорт номенклатуры
• Решение проблем подключения