---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
vcsPath: >-
  motorway/magacg/support/docs/src/ru-x-ai/catalog/customer/customer-cancel-revoke.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: >-
      https://yamagistrali.ru/docs/ru-x-ai/catalog/customer/customer-cancel-revoke.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---
<!-- Сгенерировано командой api-docs export-site. -->

# Отменить или отозвать заказ заказчика

Стенд по умолчанию — `test`. Сценарий изменяет данные. [Порядок работы для агента](https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md).

Нужны идентификатор заказа и доступ к нему от имени заказчика. Перед записью на рабочем стенде получите подтверждение пользователя. По возможности согласуйте отзыв исполняемого заказа с исполнителем.

Получите карточку через [`POST /api/orders/v0/transferOrder/getFlatForCustomer`](https://yamagistrali.ru/docs/ru-x-ai/methods/orders.transfer-order.get-flat-for-customer.v0.md) с идентификатором в `data.exactOrderIds`. Выберите нужный заказ в `data.orders` и проверьте его `status`. Если карточки нет, остановитесь и уточните заказ или организацию.

## Отменить черновик

Если заказ находится в `draft`, получите причины через [`GET /api/dicts/order/v0/reasonOrderCancel`](https://yamagistrali.ru/docs/ru-x-ai/methods/get-api-dicts-order-v0-reasonordercancel.md). Согласуйте причину с пользователем и возьмите её `reasonKey` из `data.reasons`. Вызовите [`POST /api/orders/draft/cancel/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-draft-cancel-v0.md) с идентификатором в `data.id` и обязательным кодом в `data.cancelReasonKey`. Комментарий можно передать в `data.cancelComment`. Если причина не определена, остановитесь.

## Отозвать заказ в исполнении

Если исполнитель назначен и заказ находится в `onExecute`, получите и согласуйте причину из [`GET /api/dicts/order/v0/reasonOrderRevokeFwd`](https://yamagistrali.ru/docs/ru-x-ai/methods/get-api-dicts-order-v0-reasonorderrevokefwd.md). Если причина не определена, остановитесь. При вызове [`POST /api/orders/onExecute/revokeByForwarder/v0`](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-orders-onexecute-revokebyforwarder-v0.md) передайте `data.id` и обязательный `data.cancelReasonKey`.

`data.cancelActiveTasks` управляет отменой активных задач АРУ. Задачи рейса могут быть отозваны отдельно, если первая погрузка ещё не завершена, даже при `cancelActiveTasks: false`. Перед отзывом согласуйте с пользователем оба последствия.

## Проверить результат

Перечитайте карточку. После отмены черновика ожидается статус `cancel`, после отзыва исполнения — `revoke`. Если исходный статус не подходит или API отклонил действие, сообщите текущий статус и остановитесь.