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