Tracking: Update Numbers to Store
update_tracking_numbers_to_store[Tracking Number / Fulfillment]
[What it does] Adds or updates tracking numbers for selected sales-side order items. Each item supports one or more tracking numbers, which are sent directly to the sales channel. If an item already has tracking numbers, the complete list submitted in this request replaces the existing list. Appending is not supported.
[When to use] Use when you need to set new tracking numbers for selected sales-side items in one DSers order or replace their existing tracking numbers.
[When not to use] To synchronize tracking numbers already stored on the DSers order, use sync_existing_tracking_numbers_to_store. This Tool cannot append new tracking numbers to the existing list. Use get_package_details to inspect tracking events. Before calling this Tool, use get_order to review the order, sales-side items, and existing tracking numbers.
[How to use]
Copy
dsers_order_idfromget_order.Copy each
dsers_order_item_idfrom the order'sitems[].dsers_order_item_id. Do not usesupplier_order_item_id.tracking_updatesmust be a non-empty array. Each update may target only one sales-side item.Each update's
tracking_numbersmust be a non-empty array containing one or more tracking numbers.The complete
tracking_numberslist in each update replaces the existing tracking numbers of the corresponding item.The same
dsers_order_item_idmust not appear more than once intracking_updates.Tracking numbers are trimmed and deduplicated. Empty tracking numbers are rejected.
Order ownership and item membership are validated before the update is sent.
A successful response means only that the sales channel accepted the update request. It does not confirm that the final state has been updated.
This operation is not idempotent. If the outcome is unclear, refresh
get_orderand the sales-channel order instead of retrying automatically. [Side effects] Replaces the existing tracking numbers of the selected sales-side items and may change their shipment or fulfillment status. [Confirmation] Always required. Before calling this Tool, show and confirm the exact store, order, sales-side items, new tracking numbers for each item, existing tracking numbers that will be replaced, and any possible shipment or fulfillment-status changes.
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>",
"tracking_updates": "<tracking_updates>"
},
"name": "update_tracking_numbers_to_store"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dsers_order_id | Yes | Exactly one DSers order ID. Copy from get_order. Required. | |
| tracking_updates | Yes | Non-empty list of sales-side item tracking replacements. Each update targets exactly one items[].dsers_order_item_id. The complete tracking_numbers list replaces that item's existing numbers. Paste JSON example: [{"dsers_order_item_id":"2088507008557908225","tracking_numbers":["1Z999AA10123456784"]}]. |
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. |