# alibaba1688_cancel_order (https://sellersheetai.com/docs/mcp-api/tools/alibaba1688_cancel_order)

> Cancel a 1688 order that is not paid yet; it cannot be reopened.

Access: **DESTRUCTIVE** · toolset alibaba1688 · family null

Confirm with data.order.status, or re-read with alibaba1688_get_order. Gate: commit — interactive: restate exactly what will happen, wait for a typed CONFIRM; autopilot: only within the seller's instruction and stated limits; otherwise ask.

## Call it

MCP tool call:

```json
{
  "name": "alibaba1688_cancel_order",
  "arguments": {
    "account": "<account>",
    "order_id": "<order_id>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_cancel_order \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"<account>","order_id":"<order_id>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
| `order_id` | string | yes | 1688's order number (digits), from alibaba1688_create_order or alibaba1688_list_orders. |
| `reason` | string |  | buyerCancel (the buyer no longer wants it), sellerGoodsLack (the supplier is out of stock) or other. Allowed: buyerCancel \| sellerGoodsLack \| other. |
| `remark` | string |  | a note to the supplier, up to 200 characters. |

## Result

- `data.order` — the order as 1688 has it now — order_id, status, total_fen, lines[].

## Gotchas

- 1688 cancels only an unpaid order here; a paid one needs a refund on 1688 itself.