首页 接口文档 接口申请 联调 常见问题 申通官网 关注我们
登录 | 注册

API类目汇总

快件跟踪推送接口基础需要授权

提供快件跟踪推送接口,联调时需合作伙伴提供接口地址

  • 请求方式+

    本文档内描述的接口均采用HTTP传输协议。客户方采用POST或者GET方式发送至本接口。
  • 请求参数+

    参数名称 描述 必填
    systemCode 系统编号
    PartnerCode 合作伙伴Code
    WayBillNo 运单号
    Traces 物流信息集合
    Action 时间/操作
    Contacter 张三
    ContactPhone 联系人电话
    Desc 物流轨迹描述
    AppKey 接口账号(联系对接人申请、备案、开通)
    AppSecret 接口密钥(联系对接人申请、备案、开通)
  • 响应参数+

    参数名称 描述
    Status 接口请求状态,true或false
    StatusCode 接口请求状态码
    StatusMessage 接口请求返回状态消息
    RecordCount 接口返回记录总数
    ResultValue 返回值
    Data 快件跟踪业务数据
  • 请求示例+

      
                               {
                                "tracesList": [{
                                "partnerCode": "test",
                                "waybillNo": "66802716079",
                                "traces": [{
                                "action": "揽收",
                                "city": "沧州市",
                                "contactPhone": "0000000000",
                                "contacter": "散件",
                                "desc": "河北沧州公司 业务员 散件 已收件",
                                "facilityName": "河北沧州公司",
                                "facilityNo": "160010",
                                "facilityType": "1",
                                "nextNodeCode": "",
                                "nextNodeName": "",
                                "remark": "",
                                "time": "2016-06-13 03:41:05",
                                "weight": "0"
                                       }
                                     ]
                                 }, {
                                "partnerCode": "test",
                                "waybillNo": "888189572335",
                                "traces": [{
                                "action": "揽收",
                                "city": "北京市",
                                "contactPhone": "0000000000",
                                "contacter": "散件",
                                "desc": "北京王府井公司 业务员 散件 已收件",
                                "facilityName": "北京王府井公司",
                                "facilityNo": "100076",
                                "facilityType": "1",
                                "nextNodeCode": "",
                                "nextNodeName": "",
                                "remark": "",
                                "time": "2016-06-13 04:41:05",
                                "weight": "0"
                                            }
                                         ]
                                      }
                                   ]
                                 }
                            
  • 响应示例+

                               {
                               "response":{
                               "partnerCode":"test",
                               "responseItems":[
                               {
                               "response":{
                               "success":"true",
                               "waybillNo":"888189572335",
                               "reason":"接收成功"
                                     }
                                   }
                                 ]
                               }
                              }                                
                             
  • 异常示例+

                             {
                             "Status": false, 
                             "ResultValue": "", 
                             "StatusCode": "xxxx", 
                             "StatusMessage": "xxxx", 
                             "RecordCount": 0, 
                             "Data": null; 
                             }