r_keeper Delivery API: Отменить заказ

Сценарий из mcp-everything. Актуально на 2026-10-24.

Гость отменил заказ в приложении — отмена уходит в ресторан с понятной причиной.

Загрузи справочник причин: GET /orders/api/v1/rejectionReasons — в result[] id и reason.
Отмени заказ: PUT /orders/api/v1/orders/{orderId}/reject с restaurantId в строке запроса и rejectionReasonId или rejectionReasonText в теле. Если причины отмены в ресторане выключены, передай оба поля пустыми.
Ошибки status_change_forbidden и err_unprocessable_entity значат, что заказ уже завершён: отменить его через API нельзя, нужен звонок в ресторан.

curl -s "https://delivery.ucs.ru/orders/api/v1/rejectionReasons" -H "Authorization: Bearer $TOKEN"

curl -s -X PUT "https://delivery.ucs.ru/orders/api/v1/orders/<orderId>/reject?restaurantId=<restaurant_guid>" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"rejectionReasonId": "<reason_id>", "rejectionReasonText": ""}'

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

Методы сценария

PUT /orders/api/v1/orders/{orderId}/reject — Отмена заказа

Ответ 200 OK. Если причины отмены выключены, передайте оба поля пустыми.

Параметр	Где	Тип	Обяз.	Описание
`orderId`	path	string	да	Номер заказа
`restaurantId`	query	string	нет	ID заведения
`rejectionReasonId`	body	string	нет	ID причины отмены
`rejectionReasonText`	body	string	нет	Текст причины отмены

GET /orders/api/v1/rejectionReasons — Причины отмены

В ответе result[]: id, reason, type, isPossibleDelete.

Нюансы

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