Order: Refresh Supplier Details
update_supplier_order[Order]
[What it does] Starts an asynchronous refresh of supplier order details for one store or all owned stores; does not return refreshed data immediately.
[When to use] Use when supplier order details (such as tracking or status) look stale or missing and must be refreshed before rereading the order; commonly the final write-back step in flows like Order Address Fix.
[When not to use] For reading existing data without a refresh, use get_order or list_orders; to change order content itself, use the order-update tool, not this one.
[How to use] Copy dsers_store_id from list_stores; omitting it covers all owned stores, so confirm scope first. A successful response returns task_type and task_id; use both with get_job_status until terminal=true. The response means only that the asynchronous job was created, not that supplier details are already refreshed. Dispatch once; if the outcome is unknown, poll the returned task instead of resubmitting.
[Side effects] Creates a synchronization job that may update stored supplier details.
[Confirmation] Requires non-skippable user confirmation; show the exact store scope first.
[Follow-up] After the task reaches a successful terminal state, verify updated supplier details with get_order or list_orders; if it fails, report the task status and message, then stop.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "update_supplier_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dsers_store_id | No | Copy from list_stores response. Optional — omit to refresh all owned stores. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | DSers sync job ID as a decimal string | |
| task_type | Yes | Fixed value supply_order_sync | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |