alibaba1688_cancel_order
Cancel a 1688 order that is not paid yet; it cannot be reopened.
destructivealibaba1688
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
In an AI client (MCP)
{
"name": "alibaba1688_cancel_order",
"arguments": {
"account": "<account>",
"order_id": "<order_id>"
}
}From code (Tool API)
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>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
accountrequired | string | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
order_idrequired | string | 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.buyerCancelsellerGoodsLackotherDefault: "buyerCancel" |
remark | string | a note to the supplier, up to 200 characters. |
Result
Every tool answers {notification, data, human_action}; data carries:
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.