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

API类目汇总

快件跟踪查询接口基础需要授权

提供第三方合作商对申通快件跟踪记录查询的服务接口

  • 请求方式+

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

    参数名称 描述 必填
    billcode 申通快递运单号码(多个单号使用英文逗号分隔,一次性最多查询20个单号)
    format 返回数据格式(json或者xml)
    sort 排序方向(desc或asc),建议使用desc
    AppKey 接口账号(联系对接人申请、备案、开通)
    AppSecret 接口密钥(联系对接人申请、备案、开通)
  • 响应参数+

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

    1        public static string GetTrackByBillCode(string billCode)
    2       {
    3           string url = "";
    4           using (WebClient webClient = new WebClient())
    5           {
    6               NameValueCollection postValues = new NameValueCollection();
    7               postValues.Add("billcode", "单号");
    8               // json或者xml
    9               postValues.Add("format", "json");
    10             postValues.Add("sort", "desc");
    11             postValues.Add("appKey", "接口账号");
    12             postValues.Add("appSecret", "接口密钥");
    13             // 向服务器发送POST数据
    14             byte[] responseArray = webClient.UploadValues(url, postValues);
    15             string response = Encoding.UTF8.GetString(responseArray);
    16             return response;
    17          }
    18       }
    
  • 响应示例+

                                                               {
      "Status": true,
      "ResultValue": "",
      "StatusCode": "OK",
      "StatusMessage": "运行成功",
      "RecordCount": 0,
      "Data": [
        {
          "Id": "402191254000",
          "SignMan": "本人",
          "SendMan": null,
          "UploadSiteName": null,
          "SendSiteName": null,
          "SendSiteMobile": null,
          "TargetSiteName": null,
          "TargetSiteMobile": null,
          "CurrentSiteName": null,
          "CurrentSiteMobile": null,
          "CurrentType": null,
          "SignTime": null,
          "UploadTime": null,
          "ScanList": [
            {
              "Id": "636185259191831970",
              "ScanType": "签收",
              "PreOrNext": null,
              "EmployeeId": "2526007018",
              "EmployeeMobile": null,
              "PickerName": "张秋华",
              "PickerMobile": null,
              "PickerId": "2526007018",
              "EmployeeName": "张秋华",
              "UploadSiteId": "252600",
              "UploadSiteName": "山东临清公司",
              "UploadSiteMobile": null,
              "ScanDate": "2016-12-01 18:06:16",
              "UploadDate": "2016-12-01 18:19:51",
              "Memo": "本人-已签收",
              "PdaSn": "141200130110695",
              "Weight": null,
              "BanCi": null,
              "Pieces": null,
              "Remark": null,
              "GoodsCategory": null,
              "ImageUrl": "",
              "PackageNo": null
            },
            {
              "Id": "636185259191831970",
              "ScanType": "派件",
              "PreOrNext": "",
              "EmployeeId": "857287",
              "EmployeeMobile": null,
              "PickerName": "张秋华",
              "PickerMobile": null,
              "PickerId": "2526007018",
              "EmployeeName": "张秋华",
              "UploadSiteId": "252600",
              "UploadSiteName": "山东临清公司",
              "UploadSiteMobile": null,
              "ScanDate": "2016-12-01 09:23:45",
              "UploadDate": "2016-12-01 09:28:57",
              "Memo": "山东临清公司-派件员:张秋华-派件中",
              "PdaSn": "130700265320493",
              "Weight": "0",
              "BanCi": "",
              "Pieces": "1",
              "Remark": null,
              "GoodsCategory": "",
              "ImageUrl": null,
              "PackageNo": null
            },
            {
              "Id": "636185259191831970",
              "ScanType": "到件",
              "PreOrNext": "",
              "EmployeeId": "2526000006",
              "EmployeeMobile": null,
              "PickerName": null,
              "PickerMobile": null,
              "PickerId": null,
              "EmployeeName": "山东临清申通",
              "UploadSiteId": "252600",
              "UploadSiteName": "山东临清公司",
              "UploadSiteMobile": null,
              "ScanDate": "2016-12-01 08:12:40",
              "UploadDate": "2016-12-01 08:15:00",
              "Memo": "已到达-山东临清公司",
              "PdaSn": "141000366340120",
              "Weight": "0",
              "BanCi": "",
              "Pieces": "1",
              "Remark": null,
              "GoodsCategory": "",
              "ImageUrl": null,
              "PackageNo": null
            },
            {
              "Id": "636185259191831970",
              "ScanType": "发件",
              "PreOrNext": "山东临清公司",
              "EmployeeId": "2500021082",
              "EmployeeMobile": null,
              "PickerName": null,
              "PickerMobile": null,
              "PickerId": null,
              "EmployeeName": "曹丽娜",
              "UploadSiteId": "250002",
              "UploadSiteName": "山东济南航空部",
              "UploadSiteMobile": null,
              "ScanDate": "2016-11-30 22:11:32",
              "UploadDate": "2016-11-30 22:24:18",
              "Memo": "山东济南航空部-已发往-山东临清公司",
              "PdaSn": "150100130110659",
              "Weight": "0",
              "BanCi": "",
              "Pieces": "1",
              "Remark": null,
              "GoodsCategory": "0001",
              "ImageUrl": null,
              "PackageNo": null
            },
            {
              "Id": "636185259191831970",
              "ScanType": "发件",
              "PreOrNext": "山东济南航空部",
              "EmployeeId": "3511010062",
              "EmployeeMobile": null,
              "PickerName": null,
              "PickerMobile": null,
              "PickerId": null,
              "EmployeeName": "航空2号",
              "UploadSiteId": "351101",
              "UploadSiteName": "上海八部公司",
              "UploadSiteMobile": null,
              "ScanDate": "2016-11-29 05:21:05",
              "UploadDate": "2016-11-29 05:24:58",
              "Memo": "上海八部公司-已发往-山东济南航空部",
              "PdaSn": "150800140101950",
              "Weight": "0",
              "BanCi": null,
              "Pieces": "1",
              "Remark": null,
              "GoodsCategory": "",
              "ImageUrl": null,
              "PackageNo": "900472459561"
            },
            {
              "Id": "636185259191831970",
              "ScanType": "收件",
              "PreOrNext": "",
              "EmployeeId": "3511000079",
              "EmployeeMobile": null,
              "PickerName": "谢灵芝",
              "PickerMobile": null,
              "PickerId": "3511009996",
              "EmployeeName": "谢灵芝",
              "UploadSiteId": "351100",
              "UploadSiteName": "福建莆田公司",
              "UploadSiteMobile": null,
              "ScanDate": "2016-11-28 04:07:15",
              "UploadDate": "2016-11-28 04:10:01",
              "Memo": "福建莆田公司-谢灵芝-已收件",
              "PdaSn": "160400140111650",
              "Weight": "0",
              "BanCi": "",
              "Pieces": "1",
              "Remark": null,
              "GoodsCategory": "0001",
              "ImageUrl": null,
              "PackageNo": null
            }
          ]
        }
      ]
    }           
                             
  • 异常示例+

           {
              "Status": false,
              "ResultValue": "",
              "StatusCode": "AccessDeny",
              "StatusMessage": "不合法签名、访问被拒绝",
              "RecordCount": 0
           }