alibaba1688_create_order
Create an UNPAID order on 1688 for local SKUs; 1688 closes it if it is not paid within 5 days.
writealibaba1688
Then pass human_action (the pay link) to the seller, or call alibaba1688_pay_order when password-free payment is on. Gate: commit — interactive: restate exactly what will happen, wait for a typed CONFIRM; autopilot: only within the seller's instruction and stated limits; otherwise ask.
Call it
In an AI client (MCP)
{
"name": "alibaba1688_create_order",
"arguments": {
"account": "<account>",
"lines": [],
"confirm_total_fen": 1
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_create_order \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":"<account>","lines":[],"confirm_total_fen":1}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
accountrequired | string | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
linesrequired | object[] | the order (required) — [{sku, quantity}], the same lines as the alibaba1688_preview_order call the seller approved. |
confirm_total_fenrequired | integer | required — data.total_fen of a FRESH alibaba1688_preview_order of these lines, an integer in fen. The order is re-priced here and refused, with both numbers, when the total is no longer this one: preview again and ask again. |
address_id | string | an address_id from alibaba1688_list_addresses; omit for the account's default address. |
message | string | a note to the supplier, in the supplier's language. When SKUs share a 1688 variant, the per-SKU split is added after it (500 characters in all). |
Result
Every tool answers {notification, data, human_action}; data carries:
data.order_id— 1688's order number, for every later call.data.status— waitbuyerpay — created, not paid.data.total_fen / data.freight_fen— integers, in fen.data.supplier / data.lines[]— as previewed.data.pay_url— 1688's pay page for this order (also in human_action).
Gotchas
- NEVER retry a create that timed out or failed in transit: the order may exist. Look it up with alibaba1688_list_orders first, and create again only when it is not there.
- Every SKU must be paired (alibaba1688_pair_sku) and of ONE supplier.
- Nothing is paid here: an unpaid order holds no stock and 1688 closes it after 5 days.