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)
{
"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
| 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), 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_id | string | an 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.