> ## 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 tool errand_pre_cancel — checks the cancellation penalty and expected refund before cancelling, without cancelling

## errand\_pre\_cancel

A pre-check before cancelling: looks up the penalty required to cancel this order and the expected refund amount. **This tool only queries — it does not cancel the order.**

<Note>
  **Recommended flow**: cancelling after a rider has accepted the order may incur a penalty. Call this tool first, show the penalty and expected refund to the user for confirmation, then call `errand_cancel` to actually cancel.
</Note>

<Note>
  **Unpaid orders carry no penalty**: this tool returns normally with `cancel_fee` 0 and `refund_amount` 0 (nothing has been paid, so there is nothing to refund). Just call `errand_cancel` directly.
</Note>

### Parameters

| Parameter          | Type   | Required | Default | Description                                                                                           |
| ------------------ | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `consent_grant_id` | string | Yes      | —       | User consent grant ID (`cg_` prefix, from `errand_verify_user_bind`), identifying the consenting user |
| `order_id`         | string | Yes      | —       | Order ID (`err_` prefix)                                                                              |

### Returns

<Warning>
  The amount fields (`cancel_fee` / `quote_fee` / `refund_amount`) are all in **cents (integer)**.
</Warning>

| Field           | Type    | Description                                                                                                                                    |
| --------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`      | string  | Order ID                                                                                                                                       |
| `cancel_fee`    | integer | Penalty required to cancel this order (cents)                                                                                                  |
| `quote_fee`     | integer | Amount paid for this order (cents)                                                                                                             |
| `refund_amount` | integer | Expected refund, in cents. For paid orders this is `quote_fee` − `cancel_fee`; for unpaid orders there is nothing to refund, so it is always 0 |

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

### Error Codes

| code                        | Description                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| `CONSENT_GRANT_REQUIRED`    | Missing consent grant (no `consent_grant_id`)                                             |
| `CONSENT_GRANT_INVALID`     | Consent grant is invalid                                                                  |
| `CONSENT_GRANT_EXPIRED`     | Consent grant has expired; re-authorization required                                      |
| `CAP_NOT_BOUND`             | The errand capability is not enabled for this agent                                       |
| `CONSENT_GRANT_WRONG_CAP`   | The consent grant belongs to another capability and cannot be used for this tool          |
| `ERRAND_ORDER_NOT_FOUND`    | Order not found, or not owned by the consenting user                                      |
| `ERRAND_CANCEL_NOT_ALLOWED` | Cancellation isn't allowed in the current state (completed / cancelled / delivery failed) |

### Example Call

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