Инструкция для администратора и разработчика внешнего сервиса. Это последовательная диагностика, а не обещание единственной причины по сообщению об ошибке. Рабочие доступы, платежи и кассовые документы не меняйте ради проверки. Сначала сохраните обезличенный пример и уточните используемую версию интеграции.
Как проявляется проблема
- После изменения заказа приёмник не видит события.
- Запрос есть в журнале сервера, но приложение его игнорирует.
Что проверить сначала
- Сохранён неверный адрес или организация.
- Событие исключено фильтром либо не соответствует сценарию.
- Сервер отклоняет запрос до прикладной обработки.
Быстрая диагностика
| Что наблюдаем | Что проверить | Как понять результат |
|---|---|---|
| Нет события | Сравнить сохранённую организацию, URL и фильтр. | Различие исправляет владелец подписки. |
| Прокси видит POST | Сверить маршрут до журнала приложения. | При отсутствии в приложении проверить маршрутизацию. |
| Приложение получило тело | Проверить отбор события и аутентификацию. | Причину отклонения фиксировать без секрета. |
Три точки наблюдения
Полная формулировка из статьи
Сравнить сохранённую организацию, URL и фильтр. Сверить маршрут до журнала приложения. Проверить отбор события и аутентификацию.
Маршрут диагностики
Маршрут проверок
Полная формулировка из статьи
Шаг 1. Согласуйте одно контрольное событие и ресторан. Запишите, что именно должно измениться и в какой момент. Не проверяйте уведомления доставки изменением заказа в зале: это разные сценарии. Убедитесь, что выбранный тест действительно порождает ожидаемый тип события для используемой версии и подписки. Шаг 2. Считайте сохранённые настройки штатной диагностикой поставщика. Сравните организацию, адрес и фильтр с ожидаемыми. Проверять нужно сохранённое состояние, а не незавершённую форму. До изменения выясните, кто ещё использует подписку: случайная перезапись адреса способна остановить другой сервис ресторана. Шаг 4. Сопоставьте журнал входа прокси с журналом приложения. Если обращения нет на первом участке, исследуйте подписку и внешний доступ. Если прокси запрос принял, а приложение нет, проверьте маршрутизацию и ограничения размера. Если приложение получило тело, выясните, на каком условии оно его отбрасывает. Шаг 6. Отдельно измерьте ответ приёмника и обработку после приёма. Сначала надёжно сохраните событие своим механизмом, затем подтверждайте приём и выполняйте долгую работу отдельно. Повторите контроль и сверьте ожидаемое изменение в приложении. Успешное получение HTTP-запроса ещё не подтверждает правильную бизнес-обработку.
Скриншоты и фрагменты документации
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Пошаговое решение
Отмечайте выполненные проверки. Отметки действуют до перезагрузки страницы.
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko. 
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko.
Развилка результата
Полная формулировка из статьи
Критерий результата: Для одного согласованного изменения видны путь запроса до обработчика, результат проверки и ожидаемое обновление приложения. Подписка относится к нужной организации; другой потребитель не потерял свои события после исправления. Передача специалисту: Передайте поставщику один воспроизводимый пример: время с часовым поясом, используемый метод, версии компонентов и обезличенные запрос с ответом. Добавьте результат каждого шага и ожидаемое поведение. Не передавайте секреты в обычном журнале; укажите correlationId, если он получен.
Как понять, что проблема решена
Для одного согласованного изменения видны путь запроса до обработчика, результат проверки и ожидаемое обновление приложения. Подписка относится к нужной организации; другой потребитель не потерял свои события после исправления.
Как снизить риск повторения
Назначьте владельца настроек подписки, контролируйте сертификат и доступность пути. Разделяйте журнал доставки события и журнал его обработки. При смене домена проверьте фактически сохранённый URL, прежде чем отключать старый приёмник.
Если проблема осталась
Передайте поставщику один воспроизводимый пример: время с часовым поясом, используемый метод, версии компонентов и обезличенные запрос с ответом. Добавьте результат каждого шага и ожидаемое поведение. Не передавайте секреты в обычном журнале; укажите correlationId, если он получен.
Что передать в поддержку
Скопируйте шаблон и заполните его без паролей, API-ключей, данных карт и сведений о гостях.
Проблема: Вебхук iiko не приходит: проверка адреса, фильтра и приёмника Версия и компонент iiko: Ресторан / рабочее место: Время сбоя и часовой пояс: Точный текст сообщения: Что ожидалось / что произошло: Какие проверки выполнены: Результат каждой проверки: Идентификатор операции (если допустимо):
Где помогает Menu 360
Menu 360 интегрируется с iiko и использует автоматические допродажи в цифровом меню. Актуальность состояния важна для предложения доступных дополнений, поэтому после восстановления уведомлений проверьте весь сценарий. Цены задаются в самом Menu 360; уведомление об изменении состояния не следует трактовать как команду переписать локальные цены.
Вопросы и ответы
Уведомление StopListUpdate содержит весь стоп-лист?
Не следует строить обработку на таком предположении. Официальное руководство описывает его как уведомление об изменении, после которого отдельно получают актуальное состояние. Проверяйте контракт именно выбранного события.
Можно заменить URL, если подключено несколько сервисов?
Сначала выясните владельца действующей подписки и поддерживаемую схему распределения событий. Самовольная замена может отключить другой потребитель. Организовать передачу нескольким сервисам должен ответственный за интеграции.
Источники и применимость
Официальная документация служит основой проверки возможностей iiko. Последовательность диагностики и контрольные примеры разработаны редакцией Menu 360; это не подтверждение ошибки именно в вашей конфигурации.