简要描述:

轨迹查询接口


service名称:

getCargoTrackPdd


paramsJson示例:

{
    "codes": ["HHWDE9344000011YQ", "HHWDE9344000012YQ"]
}

paramsJson参数:

参数名 数据类型 是否必填 说明
codes Object/Array Require 服务商单号shipping_method_no(或者系统订单号order_code)数组,如{“codes”:[“TFL1”,” TFL2”]}

注: 1、此单号为创建订单时候我司返回的运单号或者追踪单号或者客户单号)


response XML示例:

成功返回示例:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Success","message":"Success","Data":[{"Code":"HHWQV2359000002YQ","Country_code":"US","New_date":"2022-12-25 14:26:15","Time_zone":"+08:00","New_Comment":"快件到达作业中心","Status":"AF","Error_code":"0000","Detail":[{"Occur_date":"2022-12-25 14:26:15","Occur_time_zone":"+08:00","Status":"AF","Comment":"Has entered the warehouse","track_area":"SHENZHEN"},{"Occur_date":"2022-12-25 14:07:43","Occur_time_zone":"+08:00","Status":"IR","Comment":"Shipment information received","track_area":"CHINA"}]}],"Error":[],"time_cost(s)":"0.032227039337158"}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
失败返回示例:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Success","message":"Success","Data":[{"Code":"Haaaaaaaa000002YQ","Country_code":"","New_date":"","New_Comment":"","Status":"","Error_code":"0001","Detail":[]}],"Error":[],"time_cost(s)":"0.030274868011475"}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>{"ask":"Failure","message":"","Data":[],"Error":{"cnMessage":"单号不能为空","enMessage":"Order Code. can not be empty"},"time_cost(s)":"0.063003063201904"}</response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

response参数:

参数名 数据类型 说明
ask string 参考公共请求参数中response参数
message string 参考公共请求参数中response参数
Data Object 数据内容(2维数组)
Error Object 参考公共请求参数中Error格式
Data参数:
参数名 数据类型 说明
Code string 单号
Country_code string 目的国家代码
New_date string 最新的轨迹时间+时区,格式为:YYYY-MM-DD HH:MM:SS
Time_zone string 时区,格式:+08:00
New_Comment string 最新的轨迹内容
Status string 轨迹状态码
Detail Object 轨迹明细内容(2维数组)
Detail参数:
参数名 数据类型 说明
Occur_date string 轨迹发生时间
Occur_time_zone string 时区,格式:+08:00
Status string 轨迹状态
Comment string 轨迹内容
track_area string 发生地点全称
轨迹状态代码对应表:

文档更新时间: 2023-01-31 14:02   作者:admin