Tổng quan đơn hàng mua hộ
/v1/orders/* bao phủ mua hộ nội địa — đơn hàng với người bán 1688/Taobao để giao đến địa chỉ nhập kho tại Trung Quốc. Đây không phải vận chuyển quốc tế; dùng Fulfillment sau khi nhập kho.
Số tiền tính bằng CNY fen (分). Đặt response_format theo Response format.
Map product ids từ Products: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id.
Vòng đời {#lifecycle}
- Preview — validate dòng hàng, giá, freight
- Create — đặt đơn mua hộ
- Pay — thanh toán bằng ví marketplace
- Detail / list — theo dõi trạng thái
- Domestic trace — người bán → kho
- Cancel — khi được phép
Hướng dẫn endpoint
| Bước | Path | Tài liệu |
|---|---|---|
| Preview | POST /v1/orders/preview | Order preview |
| Create | POST /v1/orders/create | Create order |
| Pay | POST /v1/orders/pay | Pay order |
| Detail | POST /v1/orders/detail | Order detail |
| List | POST /v1/orders/list | Order detail |
| Cancel | POST /v1/orders/cancel | Cancel order |
| Domestic trace | POST /v1/orders/logistics/trace | Domestic logistics trace |
| Taobao purchases | POST /v1/orders/purchase/query | Order detail |
| Schema phản hồi | — | Order response models |
Shortcut theo kênh: /v1/orders/1688/*, /v1/orders/taobao/* (body có thể bỏ channel).
Logistics nội địa so với quốc tế {#domestic-vs-international}
| Chặng | API |
|---|---|
| Người bán → kho Trung Quốc | Domestic trace |
| Kho → người mua nước ngoài | International tracking |