Order: Cancel Supplier Orders
cancel_supplier_order[Order]
[What it does] Requests asynchronous supplier-side cancellation for one DSers order that is in awaiting_payment or awaiting_shipment status; only one order per call.
[When to use] Use when the user explicitly wants to stop a specific Agent or 1688 Dropshipping order whose latest confirmed status is awaiting_payment or awaiting_shipment.
[When not to use] If status is unknown, check it with get_order first; do not call this for an order in any other status, or for any supplier other than Agent or 1688 Dropshipping.
[How to use] Supply exactly one dsers_order_id from list_orders, verified via get_order, the matching required supplier_platform_id for Agent or 1688 Dropshipping, and required status copied from that order (awaiting_payment or awaiting_shipment). Ownership and tab eligibility are checked through Order Core before dispatch. A successful response contains only message: it means DSers acknowledged the asynchronous request, not that cancellation completed. Completion is confirmed only by a later get_order showing the cancelled status. Dispatch once; never auto-retry — re-read order state if the outcome is unclear.
[Side effects] May cancel the order's supplier orders; destructive and critical-risk.
[Confirmation] Requires explicit, non-skippable user confirmation; show the exact order, supplier, and status first.
[Follow-up] After acknowledgement, verify cancellation with get_order; if rejected, report the reason and stop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dsers_order_id": "<dsers_order_id>",
"supplier_platform_id": "<supplier_platform_id>",
"status": "<status>"
},
"name": "cancel_supplier_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Required DSers order tab. Copy from list_orders or get_order. Only awaiting_payment and awaiting_shipment are accepted. | |
| dsers_order_id | Yes | Exactly one DSers order ID returned by list_orders. | |
| supplier_platform_id | Yes | Required Agent or 1688 Dropshipping supplier platform ID. Copy from list_orders or get_order. Other platforms are rejected. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Outcome and safe next step | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |