iikoCloud API: POST /api/1/deliveries/create — Создание заказа на доставку

Команда: статус выполнения проверяется через /api/1/commands/status.

Параметр	Где	Тип	Обяз.	Описание
organizationId	body	string	да	ID организации (uuid)
terminalGroupId	body	string	нет	ID терминальной группы, куда отправить заказ
createOrderSettings.transportToFrontTimeout	body	integer	нет	Сколько секунд даётся на доставку заказа в iikoFront
createOrderSettings.checkStopList	body	boolean	нет	Проверять позиции по стоп-листу
order	body	object	да	Заказ
order.id	body	string	нет	ID заказа (уникальный uuid); если не передан — генерируется
order.externalNumber	body	string	нет	Внешний номер заказа
order.completeBefore	body	string	нет	Время выполнения yyyy-MM-dd HH:mm:ss.fff, локальное для терминала
order.phone	body	string	да	Телефон: начинается с +, не меньше 8 цифр
order.orderTypeId	body	string	нет	Тип заказа; указывается он или orderServiceType
order.orderServiceType	body	string	нет	Тип обслуживания; указывается он или orderTypeId
order.deliveryPoint.address	body	object	нет	Адрес доставки (не нужен для самовывоза)
order.deliveryPoint.coordinates	body	object	нет	Координаты адреса
order.deliveryPoint.comment	body	string	нет	Доп. информация
order.comment	body	string	нет	Комментарий к заказу
order.customer.type	body	string	да	Тип клиента (если передаётся customer)
order.guests.count	body	integer	да	Число персон — определяет число приборов (если передаётся guests)
order.items	body	array	да	Позиции заказа
order.items[].type	body	string	да	Тип позиции
order.items[].amount	body	number	да	Количество
order.items[].productSizeId	body	string	нет	Размер; обязателен, если у позиции есть шкала размеров
order.items[].comment	body	string	нет	Комментарий
order.combos	body	array	нет	Комбо: id, name, amount, price, sourceId
order.payments	body	array	нет	Оплаты заказа
order.marketingSourceId	body	string	нет	Рекламный источник
order.priceCategoryId	body	string	нет	Ценовая категория

Базовые 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