订单 API 响应模型
类型定义位于 packages/shared/src/（order-preview-result.ts、order-create-result.ts、trade.ts、logistics-trace.ts）。所有金额单位为分。
StandardOrderPreviewResult {#standard-order-preview-result}
来自订单预览。
| 字段 | 类型 | 说明 |
|---|---|---|
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 | 用于支付、详情、轨迹查询 |
total.payment | Money | 待支付金额 |
order_list[] | array | 子订单 / 按卖家拆分 |
failed_offers[] | array | 可能 success: true 但部分创建失败 |
outer_purchase_id | string | 淘宝幂等键 |
payment_url | string | 淘宝可选支付 URL |
StandardOrderPayResult {#standard-order-pay-result}
淘宝 self 标准模式只有订单查询确认付款后才返回 success: true；code: "0" 或旧成功结果不是扣款证明。pending 是网关未确认，不是官方处理队列状态。
| 字段 | 说明 |
|---|---|
success | 淘宝 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（分） |
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 |
获取支持
需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复