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

API类目汇总

申通订单下发接口基础需要授权

提供合作伙伴订单对接

  • 请求方式+

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

    参数名称 描述 必填
    systemCode 系统编号
    SiteCode 网点编码
    OrderSource 合作伙伴编码
    TradeNo 交易订单号
    OrderDate 订单日期
    ReceiverMobile 联系人手机
    ReceiverName 联系人姓名
    AppKey 接口账号(联系对接人申请、备案、开通)
    AppSecret 接口密钥(联系对接人申请、备案、开通)
  • 响应参数+

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

      
                                {
                                "siteCode": "10000",
                                "siteName": "湖南网点",
                                "tradeNo": "22227880099",
                                "waybillNo": "20140804048802",
                                "height": 50,
                                "length": 50,
                                "logisticId": "LBX1023892031",
                                "orderDate": "2016-12-07 12:12:12",
                                "orderSource": "KB",
                                "receiverProv": "四川",
                                "receiverProvCode": "110000",
                                "receiverCity": "成都",
                                "receiverCityCode": "",
                                "receiverArea": "高新",
                                "receiverAreaCode": "",
                                "receiverTown": "文一路",
                                "receiverTownCode": "67991",
                                "receiverAddress": "四川省成都市高新区新航路283号",
                                "receiverMobile": "15956874256",
                                "receiverName": "李某",
                                "receiverPhone": "024-84332654",
                                "receiverPostcode": "634569",
                                "senderAddress": "浙江省杭州市余杭区文一西路823号",
                                "senderProv": "浙江",
                                "senderProvCode": "",
                                "senderCity": "杭州",
                                "senderCityCode": "",
                                "senderArea": "余杭",
                                "senderAreaCode": "",
                                "senderTown": "街道",
                                "senderTownCode": "",
                                "senderMobile": "13989203824",
                                "senderName": "刘某",
                                "senderPhone": "0571-84292224",
                                "senderPostcode": "638293",
                                "volume": 2050.6,
                                "weight": 1000.5,
                                "width": 50,
                                "items": "{\"itemInfo\":{\"itemNum\":\"1\",\"itemName        \":\"毛衣\",
                                \"extendFields\":\"is_precious:1\",\"insuredAmount\":        \"199900\"}}"
                            }
                   
  • 响应示例+

                             {
                              "success":"true|false",
                              "tradeNo":"22227880099",
                              "waybillNo" : "20140804048802",
                              "errorMsg":"请求成功为空,失败为对应错误消息"
                              }                                
                             
  • 异常示例+

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