物流轨迹查询接口

注意：该接口请尽量用来查询物流轨迹，不要用来频繁查询更新运单状态，否则可能会被限流，更新运单状态请用1.2 实操回传接口
默认返回定义的全部实操状态（status），且后续可能会新增状态，需商家自行过滤自己需要的状态

基本信息

接口名称 TMS_PRACTICE_TRACE_INFO
请求方式 post application/x-www-form-urlencoded
功能描述 商家调用菜鸟速递EDI查询运单轨迹
编码 UTF-8

入参

项目 名称 类型 必填 描述
对接码 logistic_provider_id String 是 菜鸟侧提供
签名 data_digest String 是 Base64(Md5(logistics_interface+双方约定的secretKey)) ,0.2 签名方法
业务报文 logistics_interface String 是 JSON
logistics_interface内容
项目 名称 类型 必填 描述
运单号 mailNo String 是

出参

项目 名称 类型 必填 备注
成功标识 success boolean 是
错误码 errorCode String 否
错误说明 errorMsg String 否
操作详情 operationDetails List<OperationDetail> 是
OperationDetail内容
项目 名称 类型 必填 描述 备注
操作时间 operateTime String 是 yyyy-MM-dd HH:mm:ss
操作机构名 orgName String 是
操作描述 operateDescription String 是 包裹由【新街口站】的【张三】配送中，联系电话【13000000000】
状态编码 status String 是
00 揽收，
01 分拨收货，
02 分拨发货，
03 站点到货，
04 小件员领件（派件中），
05滞留，
06 拒收，
07 签收，
08 退货出站，
09 退货入库，
10 退商家出库，
11 退商家成功，
12 退商家失败，
13 中转出站，
14 配载确认(b2b)，
15 已发车(b2b)，
16 已进站(b2b)，
17 已运达(b2b)，
18 部分签收(b2b)，
19 揽收小件员接单，
20 揽收小件员转派，
21 揽收到站，
22 代收，
23 承诺拦截成功
24 实物拦截退回
25 取消
26 发货出站

示例报文

URL：
http://edi-daily.xpm.cainiao.com/ext/gateway/ediPracticeTrace/ediStandardPracticeTrace/api
请求：

仅供参考，实际测试账号需联系菜鸟速递开发提供

logistic_provider_id: edi_test_json

data_digest: LsVizYWy4BXp2uxtLicP4g==

logistics_interface: {"mailNo":"test123456"}

返回：
{
    "errorCode": "00",
    "errorMsg": "成功",
    "operationDetails": [{
            "operateDescription": "包裹在[全链路分拨002-CP]分拨收货",
            "operateTime": "2018-07-13 11:36:34",
            "orgName": "全链路分拨002-CP",
            "status": "01"
        },
        {
            "operateDescription": "包裹在[全链路分拨002-CP]发货",
            "operateTime": "2018-07-13 11:47:45",
            "orgName": "全链路分拨002-CP",
            "status": "02"
        },
        {
            "operateDescription": "包裹在[全链路分拨002-CP]发货",
            "operateTime": "2018-07-13 11:54:37",
            "orgName": "全链路分拨002-CP",
            "status": "02"
        },
        {
            "operateDescription": "包裹在[全链路分拨002-CP]发货",
            "operateTime": "2018-07-13 14:06:52",
            "orgName": "全链路分拨002-CP",
            "status": "02"
        },
        {
            "operateDescription": "包裹在[全链路分拨002-CP]发货",
            "operateTime": "2018-07-13 14:06:57",
            "orgName": "全链路分拨002-CP",
            "status": "02"
        },
        {
            "operateDescription": "包裹在[HR修改后站点名称]到站扫描",
            "operateTime": "2018-07-13 16:11:29",
            "orgName": "HR修改后站点名称",
            "status": "03"
        },
        {
            "operateDescription": "包裹在[HR修改后站点名称]由[王三哈]小件员领件,联系电话：[13111111111]",
            "operateTime": "2018-07-13 16:16:33",
            "orgName": "HR修改后站点名称",
            "status": "04"
        },
        {
            "operateDescription": "包裹在[HR修改后站点名称]拒收反馈审核通过,联系电话：[13111111111],备注[反馈端:APP]",
            "operateTime": "2018-07-13 16:18:40",
            "orgName": "HR修改后站点名称",
            "status": "06"
        }
    ],
    "success": true
}