Appearance
请求方式
POST 接入方提供请求地址v2请求业务参数
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| orderNo | string | 是 | 子订单号 |
| topOrderNo | string | 是 | 原订单子订单号 |
| topThirdOrderNo | string | 是 | 原订单三方订单号 |
| orderType | int | 是 | 订单类型 1-原始订单 2-补发订单 |
| orderStatus | int | 是 | 订单状态 |
| orderExpress | object | 是 | 订单物流信息 |
| orderExpress.expressNumber | string | 是 | 物流单号 |
| orderExpress.expressCompanyName | string | 是 | 物流公司名称 |
| orderExpress.expressCompany | string | 是 | 物流 |
| orderExpress.shippingStatus | int | 是 | 物流状态 |
| orderExpress.packageCount | int | 是 | |
| orderExpress.traces | object[] | 是 | 物流轨迹列表 |
| orderExpress.traces{j}.time | string | 是 | 时间 |
| orderExpress.traces{j}.context | string | 是 | 说明 |
| orderExpress.traces{j}.status | string | 是 | 状态 |
| orderExpress.traces{j}.city | string | 是 |
v2请求示例
{
"bizContent": {
"orderExpress": {
"expressCompany": "postb",
"expressCompanyName": "EMS小件",
"expressNumber": "9874452784424",
"packageCount": 1,
"shippingStatus": 15,
"traces": [
{
"context": "快件离开【金华市华东包件车间】,正在发往下一站",
"status": "TRANSPORT",
"time": "2024-03-20 21:37:32"
},
{
"context": "快件到达【金华市华东包件车间】",
"status": "TRANSPORT",
"time": "2024-03-20 19:46:40"
},
{
"context": "快件离开【金华市岭下朱第九揽投部】,正在发往下一站",
"status": "TRANSPORT",
"time": "2024-03-20 18:06:42"
},
{
"context": "快件到达【金华市岭下朱第九揽投部】",
"status": "TRANSPORT",
"time": "2024-03-20 16:43:44"
},
{
"context": "快件离开【金华市天鸽第二揽投部】,正在发往【金华市岭下朱第九揽投部】",
"status": "TRANSPORT",
"time": "2024-03-20 16:35:28"
},
{
"context": "快件已在【金华市天鸽第二揽投部】完成分拣,准备发出",
"status": "TRANSPORT",
"time": "2024-03-20 16:35:27"
},
{
"context": "中国邮政 已收取快件",
"status": "ACCEPT",
"time": "2024-03-20 16:35:23"
}
]
},
"orderNo": "1729847301613334",
"orderStatus": 60,
"topOrderNo": "1729847055177413",
"topThirdOrderNo": "20241025_002",
"orderType": 2
},
"resellerId": 10000,
"sign": "74c2104d1643d3ff3aeffcbaf8489781",
"timestamp": 1716366727,
"version": 2
}v1请求业务参数
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| orderNo | string | 是 | 子订单号 |
| orderStatus | int | 是 | 订单状态 |
| orderExpress | object | 是 | 订单物流信息 |
| orderExpress.expressNumber | string | 是 | 物流单号 |
| orderExpress.expressCompanyName | string | 是 | 物流公司名称 |
| orderExpress.expressCompany | string | 是 | 物流 |
| orderExpress.shippingStatus | int | 是 | 物流状态 |
| orderExpress.traces | object[] | 是 | 物流轨迹列表 |
| orderExpress.traces{j}.time | string | 是 | 时间 |
| orderExpress.traces{j}.context | string | 是 | 说明 |
| orderExpress.traces{j}.status | string | 是 | 状态 |
v1请求示例
{
"bizContent": {
"orderExpress": {
"expressCompany": "postb",
"expressCompanyName": "EMS小件",
"expressNumber": "9874452784424",
"packageCount": 1,
"shippingStatus": 15,
"traces": [
{
"context": "快件离开【金华市华东包件车间】,正在发往下一站",
"status": "TRANSPORT",
"time": "2024-03-20 21:37:32"
},
{
"context": "快件到达【金华市华东包件车间】",
"status": "TRANSPORT",
"time": "2024-03-20 19:46:40"
},
{
"context": "快件离开【金华市岭下朱第九揽投部】,正在发往下一站",
"status": "TRANSPORT",
"time": "2024-03-20 18:06:42"
},
{
"context": "快件到达【金华市岭下朱第九揽投部】",
"status": "TRANSPORT",
"time": "2024-03-20 16:43:44"
},
{
"context": "快件离开【金华市天鸽第二揽投部】,正在发往【金华市岭下朱第九揽投部】",
"status": "TRANSPORT",
"time": "2024-03-20 16:35:28"
},
{
"context": "快件已在【金华市天鸽第二揽投部】完成分拣,准备发出",
"status": "TRANSPORT",
"time": "2024-03-20 16:35:27"
},
{
"context": "中国邮政 已收取快件",
"status": "ACCEPT",
"time": "2024-03-20 16:35:23"
}
]
},
"orderNo": "1716176659985930",
"orderStatus": 30
},
"resellerId": 10000,
"sign": "74c2104d1643d3ff3aeffcbaf8489781",
"timestamp": 1716366727,
"version": 1
}响应示例
{
"code": 0,
"data": null,
"message": "成功"
}物流状态
| 状态值 | 说明 |
|---|---|
| 1 | 待揽件 |
| 2 | 停发 |
| 10 | 已揽件 |
| 15 | 运输中 |
| 20 | 派件中 |
| 25 | 已签收 |
| 30 | 已退回 |
| 35 | 丢件 |
| 40 | 无法配送 |
| 45 | 拒收 |
| 50 | 退回 |
子订单状态
| 状态值 | 说明 |
|---|---|
| 0 | 已取消 |
| 10 | 待支付 |
| 20 | 待发货 |
| 30 | 待收货 |
| 40 | 已完成 |
| 50 | 已退款 |
| 60 | 待生产 |
| 70 | 无法生产 |
| 80 | 生产中 |
| 90 | 已补发 |