> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawdot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# errand_pre_cancel

> MCP 工具 errand_pre_cancel —— 取消前查询违约金与预计可退金额，不执行取消

## errand\_pre\_cancel

取消订单前的预检：查询取消这笔订单需要支付的违约金、以及预计可退金额。**本工具只查询，不执行取消。**

<Note>
  **建议流程**：骑手已接单后取消可能产生违约金。建议先调用本工具，把违约金与可退金额展示给用户确认，再调用 `errand_cancel` 真正执行取消。
</Note>

<Note>
  **未支付的单不收违约金**：本工具正常返回 `cancel_fee` 为 0、`refund_amount` 为 0（这单还没付过钱，没有款可退），直接调用 `errand_cancel` 取消即可。
</Note>

### 参数

| 参数                 | 类型     | 必填 | 默认 | 说明                                                     |
| ------------------ | ------ | -- | -- | ------------------------------------------------------ |
| `consent_grant_id` | string | 是  | —  | 用户授权 ID（`cg_` 前缀，来自 `errand_verify_user_bind`），标识已授权用户 |
| `order_id`         | string | 是  | —  | 订单 ID（`err_` 前缀）                                       |

### 返回

<Warning>
  金额字段（`cancel_fee` / `quote_fee` / `refund_amount`）单位均为**分（整数）**。
</Warning>

| 字段              | 类型      | 说明                                                           |
| --------------- | ------- | ------------------------------------------------------------ |
| `order_id`      | string  | 订单 ID                                                        |
| `cancel_fee`    | integer | 取消该单需要支付的违约金（分）                                              |
| `quote_fee`     | integer | 该单的实付金额（分）                                                   |
| `refund_amount` | integer | 预计可退金额（分）。已支付的单为 `quote_fee` − `cancel_fee`；未支付的单没有款可退，固定为 0 |

```json theme={null}
{ "order_id": "err_1f5108ee7dc54730aee29d20db789d64", "cancel_fee": 0, "quote_fee": 200, "refund_amount": 200 }
```

### 错误码

| code                        | 说明                            |
| --------------------------- | ----------------------------- |
| `CONSENT_GRANT_REQUIRED`    | 缺少用户授权（未传 `consent_grant_id`） |
| `CONSENT_GRANT_INVALID`     | 用户授权无效                        |
| `CONSENT_GRANT_EXPIRED`     | 用户授权已过期，需重新授权                 |
| `CAP_NOT_BOUND`             | 该 Agent 未开通跑腿能力               |
| `CONSENT_GRANT_WRONG_CAP`   | 授权属于其它能力，不可用于本工具              |
| `ERRAND_ORDER_NOT_FOUND`    | 订单不存在或不属于当前授权用户               |
| `ERRAND_CANCEL_NOT_ALLOWED` | 当前状态不允许取消（已完成/已取消/配送失败）       |

### 调用示例

```json theme={null}
{
  "name": "errand_pre_cancel",
  "arguments": {
    "consent_grant_id": "cg_your_consent_grant",
    "order_id": "<来自 errand_create / errand_list_orders>"
  }
}
```