Order API response models

Types in packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). All amounts: fen.

StandardOrderPreviewResult {#standard-order-preview-result}

From order preview.

Field	Type	Description
success	boolean	false when lines cannot be purchased; check unavailable_lines
total.payment	Money	Total payable
total.shipping	Money	Domestic shipping portion
sellers[]	array	Grouped by seller with lines[], fees
unavailable_lines[]	array	Failed validation or stock
trade_types[]	array	1688 only
promotions	object	1688 promotions when present

StandardOrderCreateResult {#standard-order-create-result}

Field	Type	Description
order_id	string	Use for pay, detail, trace
total.payment	Money	Amount to pay
order_list[]	array	Sub-orders / seller splits
failed_offers[]	array	Partial create possible with success: true
outer_purchase_id	string	Taobao idempotency key
payment_url	string	Taobao optional payment URL

StandardOrderPayResult {#standard-order-pay-result}

Field	Description
success	Payment accepted
pay_channel	1688 payment method
error_code / error_message	When success: false

StandardOrderDetail {#standard-order-detail}

Field	Description
status	e.g. wait_payment, wait_shipment, shipped
refund_status	Read-only; refund APIs not public
amounts	total, product_total, shipping_fee, refund (fen)
line_items[]	Product rows with sku_specs, status
times	created_at, paid_at, shipped_at, …
domestic_parcels[]	Warehouse mode → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

From domestic trace.

Field	Description
packages[]	tracking_number, carrier, steps[]
cross_border_packages[]	1688 cross-border nodes — not international fulfillment

StandardOrderCancelResult {#standard-order-cancel-result}

Field	Description
success	Cancel accepted (may still process)
pending	Taobao async cancel
sub_order_ids	Partial cancel affected ids