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	支払総額、販売者グループ、要求明細、可用性、適用される取引方式がすべて検証済みの場合のみ `true`
`total.merchandise`	Money \| null	商品小計。本当に不明な場合のみ `null`
`total.payment`	Money	支払い総額
`total.shipping`	Money \| null	国内送料。既知の送料無料は `amount: 0` の Money
`sellers[]`	array	販売者ごとに `lines[]` と手数料をグループ化
`unavailable_lines[]`	array	検証失敗または在庫不足
`trade_types[]`	array	1688 のみ
`promotions`	object	存在する場合の 1688 プロモーション
`code` / `message`	string	`LINE_UNAVAILABLE`、`UNSUPPORTED_TRADE_MODE`、`PREVIEW_INCOMPLETE` などの任意の業務状態
`monetary_unit`	string	standard preview では常に `CNY_minor`
`request_id`	string	リクエスト相関 ID

解釈可能でも不完全な standard preview は HTTP 200 と success:false を返します。既存互換性のため、1688 の明示的な SKU、在庫、MOQ、市場制限エラーは HTTP 502 CHANNEL_UPSTREAM_ERROR のままです。response_format:"upstream" では HTTP 200 に上流の業務失敗が含まれることがあるため、元の upstream.success、code、message とネスト項目を確認してください。

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}

Taobao self 標準モードは注文照会で確認した場合のみ success: true を返します。code: "0" や旧成功結果は引き落としの証拠ではありません。pending は Gateway の未確認状態で、公式キュー状態ではありません。

フィールド	説明
`success`	Taobao self 標準モードでは注文照会で支払い確認後のみ true
`pending` / `payment_status`	`success` / `pending` / `failed` / `unknown`
`payment_submission_status`	追加の任意フィールド: `submitted` / `rejected` / `unknown`
`payment_recovery`	追加の任意フィールド: `action`, `reason`, `elapsed_seconds`. API
`order_status` / `order_status_raw`	Taobao self
`upstream_request_id`	Taobao self
`pay_channel`	1688
`error_code` / `error_message`	明確な拒否理由。pending/unknown では理由がない場合があります

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

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support