Skip to content

请求方式

POST 接入方提供请求地址

v2请求业务参数

参数名类型是否必须说明
orderNostring子订单号
topOrderNostring原订单子订单号
topThirdOrderNostring原订单三方订单号
orderTypeint订单类型 1-原始订单 2-补发订单
orderStatusint订单状态
orderExpressobject订单物流信息
orderExpress.expressNumberstring物流单号
orderExpress.expressCompanyNamestring物流公司名称
orderExpress.expressCompanystring物流
orderExpress.shippingStatusint物流状态
orderExpress.packageCountint
orderExpress.tracesobject[]物流轨迹列表
orderExpress.traces{j}.timestring时间
orderExpress.traces{j}.contextstring说明
orderExpress.traces{j}.statusstring状态
orderExpress.traces{j}.citystring

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请求业务参数

参数名类型是否必须说明
orderNostring子订单号
orderStatusint订单状态
orderExpressobject订单物流信息
orderExpress.expressNumberstring物流单号
orderExpress.expressCompanyNamestring物流公司名称
orderExpress.expressCompanystring物流
orderExpress.shippingStatusint物流状态
orderExpress.tracesobject[]物流轨迹列表
orderExpress.traces{j}.timestring时间
orderExpress.traces{j}.contextstring说明
orderExpress.traces{j}.statusstring状态

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已补发