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

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

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

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

```bash
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://mcp-everything.ru/integrations/r-keeper-delivery/scenarios/podklyuchit-sayt-i-zagruzit-menyu.md)
- [Передать заказ с сайта в ресторан](https://mcp-everything.ru/integrations/r-keeper-delivery/scenarios/peredat-zakaz-s-sayta-v-restoran.md)
- [Отслеживать статусы заказов](https://mcp-everything.ru/integrations/r-keeper-delivery/scenarios/otslezhivat-statusy-zakazov.md)

---

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