cainiao.data.logistics.delivery.aging.predict (配送物流时效预测)

时效和服务预期是商家发货时比较关注的信息,也是选择快递公司的一个重要参考(除去长期合作合同因素)。所以,在商家发货时给商家提供线路时效预估能帮助商家选择更好的快递公司,且对消费者来说也能整体提升体验。 日常,展示具体的预测时效数值 大促期间,展示预测的时效区间

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
send_city_name String 必须 杭州市 发货城市
send_county_name String 必须 西湖区 发货区
send_addr String 必须 西溪首座B1-2 发货详细地址
send_prov_name String 必须 浙江省 发货省
rec_city_name String 必须 杭州市 收货市
rec_addr String 必须 翡翠城12幢601 收货详细地址
rec_county_name String 必须 余杭区 收货区
rec_prov_name String 必须 浙江省 收货省
rec_town_name String 必须 五常街道 收货街道

响应参数

名称 类型 示例值 描述
datas Data [] {} 列表类型返回
  • └ company_id
  • String
  • 101
  • 快递公司id
  • └ delivery_period
  • String
  • 25小时到达。100~150小时到达
  • 配送时效。字符串,ISV拿到直接展示,不要做处理

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoDataLogisticsDeliveryAgingPredictRequest req = new CainiaoDataLogisticsDeliveryAgingPredictRequest();
req.setSendCityName("杭州市");
req.setSendCountyName("西湖区");
req.setSendAddr("西溪首座B1-2");
req.setSendProvName("浙江省");
req.setRecCityName("杭州市");
req.setRecAddr("翡翠城12幢601");
req.setRecCountyName("余杭区");
req.setRecProvName("浙江省");
req.setRecTownName("五常街道");
CainiaoDataLogisticsDeliveryAgingPredictResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_data_logistics_delivery_aging_predict_response>
    <datas>
        <data>
            <company_id>101</company_id>
            <delivery_period>25小时到达。100~150小时到达</delivery_period>
        </data>
    </datas>
</cainiao_data_logistics_delivery_aging_predict_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部