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