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)

tools/call
{
  "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

NameTypeDescription
accountrequiredstringthe 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim.
linesrequiredobject[]the order (required) — [{sku, quantity}], the same lines as the alibaba1688_preview_order call the seller approved.
confirm_total_fenrequiredintegerrequired — 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_idstringan address_id from alibaba1688_list_addresses; omit for the account's default address.
messagestringa 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.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude