Resumen de pedidos de compra
/v1/orders/* cubre la compra nacional: pedidos con vendedores de 1688/Taobao para entrega a una dirección de entrada en China. No es envío internacional; usa Fulfillment después de la entrada.
Los importes están en fen CNY (分). Configura response_format según Formato de respuesta.
Mapea ids de producto desde Productos: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id.
Ciclo de vida {#lifecycle}
- Preview: valida líneas, precios y flete
- Create: coloca el pedido de compra
- Pay: liquida con la billetera del marketplace
- Detail / list: rastrea el estado
- Domestic trace: vendedor → almacén
- Cancel: cuando esté permitido
Guía de endpoints
| Paso | Ruta | Doc |
|---|---|---|
| Preview | POST /v1/orders/preview | Order preview |
| Create | POST /v1/orders/create | Crear pedido |
| Pay | POST /v1/orders/pay | Pagar pedido |
| Detail | POST /v1/orders/detail | Detalle de pedido |
| List | POST /v1/orders/list | Detalle de pedido |
| Cancel | POST /v1/orders/cancel | Cancelar pedido |
| Domestic trace | POST /v1/orders/logistics/trace | Trazabilidad logística nacional |
| Compras Taobao | POST /v1/orders/purchase/query | Detalle de pedido |
| Esquemas de respuesta | — | Modelos de respuesta de pedido |
Atajos de canal: /v1/orders/1688/*, /v1/orders/taobao/* (el cuerpo puede omitir channel).
Logística nacional frente a internacional {#domestic-vs-international}
| Tramo | API |
|---|---|
| Vendedor → almacén de China | Domestic trace |
| Almacén → comprador en el extranjero | Tracking internacional |