# 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://mcp-everything.ru/integrations/iiko/scenarios/peredat-zakaz-dostavki-s-sayta-na-kassu.md)

---

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