Order: Get Detail
get_order[Order]
[What it does] Reads the details of one DSers order: line items, costs and income, supplier rows, tracking numbers, and the currently saved shipping address and recipient details.
[When to use] Use it when the user asks for full order detail, when inspecting Failed or cancelled orders, or when row-level detail is required to repair a blocker, edit an order, or fulfill it. Ordinary Awaiting Order placement uses list_orders summaries and diagnose_order_issue without routine per-order detail reads. Trigger words: this order's detail, its supplier order, what happened with this order.
[When not to use] To find orders or see pending volume, use list_orders. To place orders, use place_orders_to_suppliers. For package movement, use get_package_details. It changes nothing.
[How to use]
dsers_order_idis required and must be the DSers internal order ID fromlist_orders; a storefront or supplier order number cannot be passed directly.The supplied supplier and tab identify the order to read. The returned
itemscan include items under other suppliers or tabs. If the order details cannot be retrieved, the call returns an error such asNOT_FOUND. Treat omitted optional fields as unavailable, not as zero.supplier_platform_idandtab_statusstay required. Copy them from the samelist_ordersrequest when that call included them. Whenlist_ordersomittedsupplier_platform_idorstatus, copy the omitted field from the sameline_items[]row being inspected. Mixedtab_statuses: pick the tab matching the user intent, else the first known value. Do not invent pairs. Iftab_statusesis empty, do not call this Tool; re-list with an explicitstatus.items[].tab_statuseslists only the known memberships for that item.items[].mixed_tab_status=truemeans more than one known tab; false does not prove completeness.Money uses different bases: income is authoritative in the seller-platform currency, the setting-currency figure may appear only as a labeled conversion, and item prices and supplier costs use the DSers default currency, so never mix them.
order.addressreturns the currently saved shipping address and recipient details, including street address lines, name, phone, email, tax ID, passport numbers, company, and birthday when populated.sales_order_recipient_birthdayis returned exactly as stored; AliExpress Brazil rules use DDMMYYYY. Values are returned as stored, without masking; empty fields are omitted. An omitted component does not prove the address is complete or placeable; usediagnose_order_issuebefore placement. Product titles must be shown verbatim, never translated or truncated. [Side effects] None; read-only. [Confirmation] Not required.
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>",
"tab_status": "<tab_status>"
},
"name": "get_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab_status | Yes | Required DSers order-tab partition for this lookup. Copy from the same list_orders request status when that call included status; when list_orders omitted status, copy one value from that item's line_items[].tab_statuses. all is rejected. | |
| dsers_order_id | Yes | Copy from orders[].dsers_order_id in list_orders results. Required. | |
| supplier_platform_id | Yes | Required supplier platform scope for this lookup. Copy from the same list_orders request when that call included supplier_platform_id; when list_orders omitted it, copy line_items[].supplier_platform_id from the item being inspected. Use 0 only for Unmapped. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | Yes | Normalized order detail with the currently saved shipping address and recipient details | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |