Modelos de respuesta de la API de pedidos

Tipos en packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Todos los importes: fen.

StandardOrderPreviewResult {#standard-order-preview-result}

Desde order preview.

Campo	Tipo	Descripción
`success`	boolean	`true` solo después de validar el total pagadero, los grupos de vendedores, las líneas solicitadas, la disponibilidad y el modo de operación aplicable
`total.merchandise`	Money \| null	Subtotal de mercancía; `null` solo cuando se desconoce realmente
`total.payment`	Money	Total a pagar
`total.shipping`	Money \| null	Envío nacional; el envío gratuito conocido es Money con `amount: 0`
`sellers[]`	array	Agrupado por vendedor con `lines[]` y tarifas
`unavailable_lines[]`	array	Validación o stock fallido
`trade_types[]`	array	Solo 1688
`promotions`	object	Promociones de 1688 cuando existan
`code` / `message`	string	Estado de negocio opcional, incluidos `LINE_UNAVAILABLE`, `UNSUPPORTED_TRADE_MODE`, `PREVIEW_INCOMPLETE`
`monetary_unit`	string	Siempre `CNY_minor` en standard preview
`request_id`	string	ID de correlación de la solicitud

Un standard preview interpretable pero incompleto devuelve HTTP 200 con success:false. Por compatibilidad, los errores explícitos de 1688 sobre SKU, stock, MOQ y restricciones del marketplace mantienen HTTP 502 CHANNEL_UPSTREAM_ERROR. Con response_format:"upstream", HTTP 200 puede contener un fallo de negocio upstream; inspecciona los campos originales upstream.success, code, message y sus equivalentes anidados.

StandardOrderCreateResult {#standard-order-create-result}

Campo	Tipo	Descripción
`order_id`	string	Usar para pago, detalle y trazabilidad
`total.payment`	Money	Importe a pagar
`order_list[]`	array	Subpedidos / divisiones por vendedor
`failed_offers[]`	array	Creación parcial posible con `success: true`
`outer_purchase_id`	string	Clave de idempotencia de Taobao
`payment_url`	string	URL de pago opcional de Taobao

StandardOrderPayResult {#standard-order-pay-result}

Taobao self estándar devuelve success: true solo tras confirmar el pago consultando el pedido. code: "0" o un éxito antiguo no prueban un cargo. pending significa no confirmado por el Gateway, no una cola oficial.

Campo	Descripción
`success`	Taobao self estándar: true solo tras confirmar el pago consultando el pedido
`pending` / `payment_status`	`success` / `pending` / `failed` / `unknown`
`payment_submission_status`	Campos nuevos opcionales: `submitted` / `rejected` / `unknown`
`payment_recovery`	Campos nuevos opcionales: `action`, `reason`, `elapsed_seconds`. API
`order_status` / `order_status_raw`	Taobao self
`upstream_request_id`	Taobao self
`pay_channel`	1688
`error_code` / `error_message`	Motivo de rechazo explícito; puede faltar para pending/unknown

StandardOrderDetail {#standard-order-detail}

Campo	Descripción
`status`	Por ejemplo `wait_payment`, `wait_shipment`, `shipped`
`refund_status`	Solo lectura; las API de reembolso no son públicas
`amounts`	`total`, `product_total`, `shipping_fee`, `refund` (fen)
`line_items[]`	Filas de producto con `sku_specs`, `status`
`times`	`created_at`, `paid_at`, `shipped_at`, …
`domestic_parcels[]`	Modo almacén → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

Desde trazabilidad nacional.

Campo	Descripción
`packages[]`	`tracking_number`, `carrier`, `steps[]`
`cross_border_packages[]`	Nodos transfronterizos de 1688; no es fulfillment internacional

StandardOrderCancelResult {#standard-order-cancel-result}

Campo	Descripción
`success`	Cancelación aceptada (puede seguir procesándose)
`pending`	Cancelación asíncrona de Taobao
`sub_order_ids`	Ids afectados por cancelación parcial

Get Support

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

Email support