Order API レスポンスモデル

型は packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts) にあります。すべての金額は fen です。

StandardOrderPreviewResult {#standard-order-preview-result}

order preview から返されます。

フィールド	型	説明
`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	pay、detail、trace に使用します
`total.payment`	Money	支払う金額
`order_list[]`	array	サブ注文 / 販売者分割
`failed_offers[]`	array	`success: true` でも部分作成の可能性があります
`outer_purchase_id`	string	Taobao の冪等性キー
`payment_url`	string	Taobao の任意の支払い 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` (fen)
`line_items[]`	`sku_specs`, `status` を含む商品行
`times`	`created_at`, `paid_at`, `shipped_at`, …
`domestic_parcels[]`	倉庫モード → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

domestic trace から返されます。

フィールド	説明
`packages[]`	`tracking_number`, `carrier`, `steps[]`
`cross_border_packages[]`	1688 の越境ノード。国際フルフィルメントではありません

StandardOrderCancelResult {#standard-order-cancel-result}

フィールド	説明
`success`	キャンセルが受け付けられたか (処理中の場合があります)
`pending`	Taobao の非同期キャンセル
`sub_order_ids`	部分キャンセルの対象 ID