alibaba1688_preview_order

Price an order of local SKUs on 1688 without ordering anything: goods, freight and total in fen; show it to the seller, then call alibaba1688_create_order with the same lines and c

readalibaba1688

onfirm_total_fen = data.total_fen.

Call it

In an AI client (MCP)

tools/call
{
  "name": "alibaba1688_preview_order",
  "arguments": {
    "account": "<account>",
    "lines": []
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_preview_order \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"<account>","lines":[]}'
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), up to 50 — [{sku, quantity}]: sku a local SKU code, quantity a whole number of the LOCAL SKU (1688 units = quantity × the pairing's units_per_sku).
address_idstringan address_id from alibaba1688_list_addresses; omit for the account's default address.

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.supplier — the one supplier of this order (its 1688 login name).
  • data.address_id — the address priced for.
  • data.lines[] — sku, quantity, units_per_sku, units_1688, item_id, offer_id, spec_id, subject, variant, unit, unit_price_fen, amount_fen.
  • data.goods_fen / data.freight_fen — integers, in fen (1 yuan = 100).
  • data.discount_fen — what the account's 1688 red envelopes and coupons take off.
  • data.total_fen — what 1688 charges after them; the amount to confirm.
  • data.trade_modes — the payment protections 1688 offers for it.

Gotchas

  • Every SKU must be paired first (alibaba1688_pair_sku); an unknown, unpaired or gone SKU is refused by name.
  • One order is one supplier: SKUs of two suppliers are refused naming them; preview and order each supplier separately.
  • SKUs paired with the same 1688 variant go to 1688 as ONE line, their units added (lines[].shares_1688_line true, amount_fen split by units); create tells the supplier the split per SKU in its note.
  • 1688's price and freight change: a preview is only good for the create that follows.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude