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: search/detail id → lines[].id (compatible: offer_id, Taobao mi_id), variants[].sku_id → lines[].spec_id.

El id / mi_id de Taobao cambia periódicamente. No lo almacene en caché a largo plazo. Un id caducado falla en detail, similar y pedidos. Vuelva a consultarlo antes del checkout.

Ciclo de vida {#lifecycle}

  1. Preview: valida líneas, precios y flete
  2. Create: coloca el pedido de compra
  3. Pay: liquida con la billetera del marketplace
  4. Detail / list: rastrea el estado
  5. Domestic trace: vendedor → almacén
  6. Cancel: cuando esté permitido

Guía de endpoints

PasoRutaDoc
PreviewPOST /v1/orders/previewOrder preview
CreatePOST /v1/orders/createCrear pedido
PayPOST /v1/orders/payPagar pedido
DetailPOST /v1/orders/detailDetalle de pedido
ListPOST /v1/orders/listDetalle de pedido
CancelPOST /v1/orders/cancelCancelar pedido
Domestic tracePOST /v1/orders/logistics/traceTrazabilidad logística nacional
Compras TaobaoPOST /v1/orders/purchase/queryDetalle 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}

TramoAPI
Vendedor → almacén de ChinaDomestic trace
Almacén → comprador en el extranjeroTracking internacional

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support