Вебхуки iiko

iiko может присылать события на сайт Woo2iiko для real-time обновлений.

Endpoint

POST https://ваш-сайт/wp-json/woo2iiko/v1/callback

Авторизация

Вебхук защищён ключом iiko_auth_key (автогенерируется, см. API connection):

• В заголовке authorization передаётся значение iiko_auth_key.
• Или в параметре $_REQUEST['authorization'].
• Плагин сверяет значение перед обработкой.

Получить auth_key

В WooCommerce → iiko → API connection → iiko_auth_key. Или через WP-CLI / debug info.

URL для iiko

Настройка iiko_order_endpoint (автогенерируется из get_site_url()):

• По умолчанию: https://ваш-сайт/wp-json/woo2iiko/v1/callback.
• После переезда — используйте Sync endpoint URL в Settings Manager.

Обрабатываемые события

Событие iiko	Что делает плагин
StopListUpdate	Обновляет стоп-лист товаров → iiko_stoplist_webhook_update.
DeliveryOrderUpdate	Обновляет статус/meta заказа → OrderTracking.
DeliveryOrderError	Логирует ошибку заказа.

Расширение типов событий

Фильтр iiko_stoplist_webhook_event_types позволяет добавить свои типы событий стоп-листа. По умолчанию ['StopListUpdate'].

Настройка в iiko

В личном кабинете iiko Cloud (или через менеджера iiko):

1. Укажите webhook URL: https://ваш-сайт/wp-json/woo2iiko/v1/callback.
2. Укажите ключ авторизации: значение iiko_auth_key из настроек плагина.
3. Выберите события (StopList, OrderUpdate, OrderError).

Проверка работы вебхука

1. Включите iiko_api_log (Основные настройки).
2. Инициируйте событие в iiko (измените стоп-лист).
3. Проверьте логи — должен прийти запрос на /callback.

Сайт должен быть доступен

iiko должен дойти до вашего сайта по HTTPS. Проверьте:

• HTTPS работает.
• Нет блокировки IP iiko на хостинге.
• iiko_auth_key совпадает.

Что даёт вебхук

• StopList real-time: клиент не закажет товар, которого уже нет (без ожидания cron).
• Order status real-time: статус заказа обновляется сразу при изменении в iiko.

Без вебхука эти данные обновляются по cron (медленнее).

См. также

• API connection
• Стоп-листы
• Отслеживание заказа
• REST API