iikoCloud API: POST /api/menu/v3/by_id — Внешнее меню по ID

Параметр	Где	Тип	Обяз.	Описание
externalMenuId	body	string	да	ID внешнего меню из /api/2/menu
organizationId	body	string	да	ID организации (uuid)
priceCategoryId	body	string	нет	Ценовая категория из /api/2/menu

Базовые URL

• Боевой: https://api-ru.iiko.services

Авторизация

Тип: Bearer-токен

• Зарегистрируйтесь на портале разработчика https://public-api.iikoweb.ru/portal и создайте приложение — получите appId и одноразово показываемый clientSecret.
• В iikoWeb → «Интеграции» → «API-ключи» сгенерируйте apiKey.
• Получите токен методом POST /api/v2/access_token и передавайте его во всех запросах: Authorization: Bearer {token}.

Токен (JWT) действует 1 час; refresh-токена нет — запрашивайте новый до истечения срока. Старый метод POST /api/1/access_token с apiLogin устарел.

Нюансы

• Все запросы, кроме получения токена, требуют заголовок Authorization; в каждом можно передать заголовок Timeout (секунды).
• Методы-команды (создание, отмена, изменение заказов) выполняются асинхронно: в ответе correlationId, итог — через /api/1/commands/status.
• Форматы: uuid — строка UUID; дата-время — yyyy-MM-dd HH:mm:ss.fff без часового пояса, локальное время терминала.
• Методы сгруппированы по группам ограничений (Data: dictionaries, Data: menu, Orders: creating и др.) — права API-ключа настраиваются по этим группам.
• Часть полей доступна только с определённой версии iikoRMS (в документации — пометки «Allowed from version»).
• Устаревшие методы: /api/1/access_token, /api/1/nomenclature, /api/2/menu/by_id — используйте /api/v2/access_token и /api/menu/v3/by_id.

Сценарии с этим методом

• Выгрузить меню на сайт с учётом стоп-листа

---

Если этого недостаточно — официальная документация: https://api-ru.iiko.services/docs Вся интеграция одним документом: https://mcp-everything.ru/integrations/iiko.md