Order: Place Orders with Supplier
place_orders_to_suppliers[Order]
[What it does] For AliExpress (supplier_platform_id=159831080), returns only a DSers Orders page url for the selected orders or filters so the user can continue there; no orders are placed by this call. For every other supplier, submits matching orders as an asynchronous task that may create real supplier orders and incur cost.
[When to use] Use it when the user explicitly asks to place or process orders, and only after the agent has confirmed the target orders have no blockers and the user has approved. Trigger words: place these orders, send to the supplier, process pending orders.
[When not to use] To check eligibility only, use the order diagnostic tool. For payment after placement, use create_order_payment_link. To read current status, use list_orders or get_order.
[How to use]
supplier_platform_id,sales_channel_id,status, andselection_modeare required.selection_modeisselectedorfilteredwith no default; never infer it from whetherdsers_order_idsis empty.supplier_account_id: Optional supplier account used to place. Only AliExpress and Alibaba.com support account selection: pass the exact supplier_account_id from current injected account context or list_stores supplier_apps[].accounts[] only when multiple usable accounts exist and the user selected one. Omit it for a single usable account and every other supplier platform. Never substitute the binding-row id, DSers user ID, email, login, alias, or name. Allowed in selected and filtered modes; it is not a search filter. AliExpress URL hand-off rejects this field.selecteduses exactdsers_order_idsand only the requiredstatus,supplier_platform_id, andsales_channel_id. Empty,search_by=default, andcancel_source=anycount as omitted; any other search filter is rejected. IDs must be unique positive decimals; duplicates are not silently dropped.Do not pass
supplier_account_idfor AliExpress; that path only returns a URL and rejects the field.For AliExpress,
selectedaccepts 1–20 IDs and checks ownership, sales_channel_id, supplier, and the requested status tab before returning the link.filteredchecks that the selected stores belong to the account. Both modes return only a DSers Orders pageurlfor the selected orders or filters; no order is placed.For every other supplier,
selectedaccepts 1–20 IDs and writes them as exactorder_ids. One ID is checked for ownership, supplier, requested status tab, and store scope, and that order's store is pinned undersales_channel_id. The call fails if the order is not on that supplier and tab. With two or more IDs, missing or unowned IDs are skipped when collecting stores, every owned order must belong tosales_channel_id, the original unique IDs are passed through, and the call fails if none are owned. An accepted request does not guarantee successful placement; check the task result.filteredomitsdsers_order_idsand matches bydsers_store_ids,query,search_by, time, countries, flags,agency_ids, andcancel_source. Never approximate a few user-named orders with filters: a filter usually matches far more orders than intended and can place unwanted ones. A non-defaultsearch_byrequiresquery; the AliExpress URL path does not support email.A non-AliExpress response returns
task_typeandtask_id; these identify the polling scope and do not mean every order was placed successfully. Pollget_job_statusuntilterminal=true, then confirm the real outcome order by order withlist_orders. If a status is unchanged or unknown, never send the placement request again, or orders may be placed twice. [Side effects] The AliExpress URL hand-off saves the order selection for continuing in DSers but does not place orders. Other suppliers may create real supplier orders and spend money. [Confirmation] Mandatory and not skippable; show each order and amount.
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": {
"selection_mode": "<selection_mode>",
"supplier_platform_id": "<supplier_platform_id>",
"sales_channel_id": "<sales_channel_id>",
"status": "<status>"
},
"name": "place_orders_to_suppliers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flags | No | Optional DSers order color flags for filtered mode. Paste JSON example: ["red"]. | |
| query | No | Optional order-table search value for filtered mode. Required when search_by is not default. | |
| status | Yes | Required order-tab filter used in both selected and filtered modes. AliExpress validates it before saving the selected IDs or filters; filtered mode also saves the selected tab. | |
| end_time | No | Optional seller-order creation end time as a Unix timestamp for filtered mode. | |
| countries | No | Optional destination country codes for filtered mode. Paste JSON example: ["US"]. | |
| search_by | No | How query is interpreted in filtered mode. Exact DSers order IDs use selection_mode=selected, not this field. For AliExpress, email is not supported. | default |
| agency_ids | No | Optional agency IDs as decimal strings for filtered mode. Paste JSON example: ["100071"]. | |
| start_time | No | Optional seller-order creation start time as a Unix timestamp for filtered mode. | |
| cancel_source | No | Optional cancellation-source filter for filtered mode. Exclusive of selected mode. any is treated as omitted. | any |
| selection_mode | Yes | Required. selected uses dsers_order_ids; filtered uses search filters. No default; do not infer from an empty ID list. | |
| dsers_order_ids | No | Exact DSers order IDs for selected mode; omit in filtered mode. Non-AliExpress placement accepts 1–20 IDs. One ID is checked for ownership, supplier, requested status tab, and store scope; with two or more IDs, missing or unowned orders are skipped when stores are collected, every owned order must belong to sales_channel_id, and the original unique IDs are dispatched. AliExpress accepts 1–20 IDs, checks ownership, sales_channel_id, supplier, and status tab, then returns a DSers Orders page URL for those orders without placing them. Copy from list_orders or get_order. Paste JSON example: ["2088507008557908224"]. | |
| dsers_store_ids | No | Optional DSers store IDs for filtered mode. Every ID must belong to sales_channel_id. An omitted list resolves to every owned store under that sales_channel_id. Exclusive of selected mode. Paste JSON example: ["1999323491106619392"]. | |
| sales_channel_id | Yes | Required seller sales channel. Copy from list_stores stores[].sales_channel_id. Scopes dsers_store_ids in filtered mode. Selected place with one ID pins that order's store under this channel. | |
| supplier_account_id | No | Optional supplier account used to place. Only AliExpress and Alibaba.com support account selection: pass the exact supplier_account_id from current injected account context or list_stores supplier_apps[].accounts[] only when multiple usable accounts exist and the user selected one. Omit it for a single usable account and every other supplier platform. Never substitute the binding-row id, DSers user ID, email, login, alias, or name. Allowed in selected and filtered modes; it is not a search filter. AliExpress URL hand-off rejects this field. | |
| supplier_platform_id | Yes | Copy from list_stores supplier_apps[].supplier_platform_id or list_orders results. Required on both modes. AliExpress is 159831080. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | DSers Orders page URL for continuing with the selected orders or filters. Open it unchanged. Present only for mcp callers on AliExpress (159831080); a URL means no order was placed | |
| task_id | No | Place-order task ID returned by DSers; copy it to get_job_status. Omitted when returning a navigation URL | |
| task_type | No | Fixed value order_process when an async place-order task was dispatched; omitted when returning a navigation URL | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |