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 | false cuando las líneas no pueden comprarse; revisa unavailable_lines |
total.payment | Money | Total a pagar |
total.shipping | Money | Parte de envío nacional |
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 |
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}
| Campo | Descripción |
|---|---|
success | Pago aceptado |
pay_channel | Método de pago de 1688 |
error_code / error_message | Cuando success: false |
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 |