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.

CampoTipoDescripción
successbooleanfalse cuando las líneas no pueden comprarse; revisa unavailable_lines
total.paymentMoneyTotal a pagar
total.shippingMoneyParte de envío nacional
sellers[]arrayAgrupado por vendedor con lines[] y tarifas
unavailable_lines[]arrayValidación o stock fallido
trade_types[]arraySolo 1688
promotionsobjectPromociones de 1688 cuando existan

StandardOrderCreateResult {#standard-order-create-result}

CampoTipoDescripción
order_idstringUsar para pago, detalle y trazabilidad
total.paymentMoneyImporte a pagar
order_list[]arraySubpedidos / divisiones por vendedor
failed_offers[]arrayCreación parcial posible con success: true
outer_purchase_idstringClave de idempotencia de Taobao
payment_urlstringURL de pago opcional de Taobao

StandardOrderPayResult {#standard-order-pay-result}

CampoDescripción
successPago aceptado
pay_channelMétodo de pago de 1688
error_code / error_messageCuando success: false

StandardOrderDetail {#standard-order-detail}

CampoDescripción
statusPor ejemplo wait_payment, wait_shipment, shipped
refund_statusSolo lectura; las API de reembolso no son públicas
amountstotal, product_total, shipping_fee, refund (fen)
line_items[]Filas de producto con sku_specs, status
timescreated_at, paid_at, shipped_at, …
domestic_parcels[]Modo almacén → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

Desde trazabilidad nacional.

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

StandardOrderCancelResult {#standard-order-cancel-result}

CampoDescripción
successCancelación aceptada (puede seguir procesándose)
pendingCancelación asíncrona de Taobao
sub_order_idsIds afectados por cancelación parcial