订单 API 响应模型

类型定义位于 packages/shared/src/（order-preview-result.ts、order-create-result.ts、trade.ts、logistics-trace.ts）。所有金额单位为分。

StandardOrderPreviewResult {#standard-order-preview-result}

来自订单预览。

字段	类型	说明
success	boolean	行项无法购买时为 false；请检查 unavailable_lines
total.payment	Money	应付总额
total.shipping	Money	国内运费部分
sellers[]	array	按卖家分组，含 lines[] 与费用
unavailable_lines[]	array	校验失败或库存不足的行
trade_types[]	array	仅 1688
promotions	object	存在时的 1688 促销信息

StandardOrderCreateResult {#standard-order-create-result}

字段	类型	说明
order_id	string	用于支付、详情、轨迹查询
total.payment	Money	待支付金额
order_list[]	array	子订单 / 按卖家拆分
failed_offers[]	array	可能 success: true 但部分创建失败
outer_purchase_id	string	淘宝幂等键
payment_url	string	淘宝可选支付 URL

StandardOrderPayResult {#standard-order-pay-result}

字段	说明
success	支付已受理
pay_channel	1688 支付方式
error_code / error_message	当 success: false 时

StandardOrderDetail {#standard-order-detail}

字段	说明
status	例如 wait_payment、wait_shipment、shipped
refund_status	只读；退款 API 未公开
amounts	total、product_total、shipping_fee、refund（分）
line_items[]	商品行，含 sku_specs、status
times	created_at、paid_at、shipped_at 等
domestic_parcels[]	仓库模式 → 履约

UnifiedLogisticsTrace {#unified-logistics-trace}

来自国内轨迹。

字段	说明
packages[]	tracking_number、carrier、steps[]
cross_border_packages[]	1688 跨境节点——非国际履约

StandardOrderCancelResult {#standard-order-cancel-result}

字段	说明
success	取消已受理（可能仍在处理中）
pending	淘宝异步取消
sub_order_ids	部分取消影响的子订单 ID