履约 API 响应模型
履约相关接口的金额均为 人民币分(CNY fen)。
运费预估 — quotes[] {#freight-estimate-quotes}
| 字段 | 说明 |
|---|---|
shipping_channel_code | 传给预览/创建 |
shipping_channel_name / description | 本地化文案(请求体中的 language) |
freight / total | 参考价 — 预览后以预览结果为准 |
estimated_days_min / max | 在提供时的运输天数区间 |
预览 / 创建 — pricing {#preview-create-pricing}
| 字段 | 说明 |
|---|---|
freight | 国际干线运费 |
services | 增值服务合计 |
discount | 促销扣减 |
total / total.payment | freight + services − discount |
shipment_id | 仅创建响应 |
status | wait_payment、paid、shipped、cancelled |
余额 {#balance}
| 字段 | 说明 |
|---|---|
balance.available | 可用于支付 |
balance.frozen | 待处理运单占用 |
balance.total | 可用 + 冻结 |
国际轨迹 — events[] {#international-trace-events}
| 字段 | 说明 |
|---|---|
status | pending、in_transit、customs、delivered、exception |
events[].description | 承运商扫描文案 |
international_tracking_no | 干线 / 末端单号 |