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