# alibaba1688_create_order (https://sellersheetai.com/docs/mcp-api/tools/alibaba1688_create_order)

> Create an UNPAID order on 1688 for local SKUs; 1688 closes it if it is not paid within 5 days.

Access: **WRITE** · toolset alibaba1688 · family null

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

MCP tool call:

```json
{
  "name": "alibaba1688_create_order",
  "arguments": {
    "account": "<account>",
    "lines": [],
    "confirm_total_fen": 1
  }
}
```

Tool API (early access — contact us):

```bash
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}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
| `lines` | object[] | yes | the order (required) — [{sku, quantity}], the same lines as the alibaba1688_preview_order call the seller approved. |
| `confirm_total_fen` | integer | yes | 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

- `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.