r_keeper Delivery API: POST /orders/api/v1/orders — Создание заказа

Ответ 201: {"result": {"orderId": "..."}}.

Параметр	Где	Тип	Обяз.	Описание
restaurantId	body	string	да	GUID заведения
expeditionType	body	string	да	delivery или pickup
dishList	body	array	да	Состав заказа
dishList[].id	body	string	нет	GUID блюда из меню; обязателен, если нет externalId
dishList[].quantity	body	number	да	Количество
dishList[].ingredients	body	array	нет	Ингредиенты и модификаторы: id, quantity (больше 0)
paymentTypeId	body	string	да	cash, card или online
paymentStatus	body	string	нет	prepaid — только при paymentTypeId: online
expectedAt	body	string	нет	Время получения с часовым поясом; обязателен, если нет soonest
soonest	body	boolean	нет	«Как можно скорее»
guest.phone	body	string	да	Телефон гостя
guest.firstName	body	string	нет	Имя
guest.lastName	body	string	нет	Фамилия
guest.email	body	string	нет	Email
address.cityName	body	string	нет	Город (обязателен для доставки)
address.street	body	string	нет	Улица (для доставки, кроме адресов без улиц)
address.houseNumber	body	string	нет	Дом, до 200 символов (обязателен для доставки)
address.fullAddress	body	string	нет	Полный адрес, до 150 символов (обязателен для доставки)
address.apartmentNumber	body	string	нет	Квартира, до 20 символов
address.lat	body	number	нет	Широта
address.lon	body	number	нет	Долгота
persons	body	integer	нет	Число персон
changeFrom	body	number	нет	Сдача с суммы
comment	body	string	нет	Комментарий к заказу

Базовые URL

• Боевой: https://delivery.ucs.ru
• Авторизация: https://auth-delivery.ucs.ru

Авторизация

Тип: OAuth 2.0

В админке: «Интеграции» → «Подключение по API» → добавить подключение (заведения, представление меню, GUID валют для онлайн-оплаты). В карточке появятся Client ID (16 символов) и Client Secret (128 символов).

Токен получают запросом POST https://auth-delivery.ucs.ru/connect/token (application/x-www-form-urlencoded) с параметрами client_Id, client_secret, grant_type=client_credentials, scopes=orders. Токен (JWT) действует 3600 секунд и передаётся во всех запросах:

Authorization: Bearer eyJhbGciOiJSUzI....aXHgrHV-I

Нюансы

• expectedAt передаётся обязательно с часовым поясом, например 2021-06-16T14:03:42.504+03:00.
• Позиции заказа ссылаются на ID блюд и ингредиентов из представления меню, назначенного подключению; блюдо в стоп-листе или неверная цена дают ошибку order_validation.
• Push-уведомления о статусах настраиваются в админке: внешний API (URL и токен в заголовке) + шаблон в разделе «Коммуникации» с каналом API и условием (например, статус «Передан на кухню»). При ошибке доставки — повтор, неотправленные события хранятся в очереди.
• Есть также методы изменения заказа, оплаты и завершения, предоплаты, справочники стран, городов, валют и курьеров.

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

• Передать заказ с сайта в ресторан

---

Если этого недостаточно — официальная документация: https://docs.rkeeper.ru/delivery/vozmoyonosti-api-4041552.html Вся интеграция одним документом: https://mcp-everything.ru/integrations/r-keeper-delivery.md