cainiao.pickup.billing.list.get (菜鸟商家寄件获取路线计费规则(待下线))

与外部isv对接时,商家有在下单前查看价格的诉求,这个接口会根据寄件地址查出寄往全国所有城市的寄件首续重价格(待下线,用cainiao.pickup.tieredpricing.get替代)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mobile String 可选 13399990000 商家联系电话
sender_address String 必须 浙江省杭州市 快递始发地地址

响应参数

名称 类型 示例值 描述
result TdOpenServiceResult {} 接口返回model
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ retry
  • Boolean
  • false
  • 是否需要重试
  • └ status_message
  • String
  • 系统错误
  • 错误描述
  • └ status_code
  • String
  • SYSTEM_ERROR
  • 错误码
  • data_list
  • BillingTemplateDto []
  • {}
  • 返回模型
  • └ start_price
  • Number
  • 600
  • 首重价格
  • └ continued_heavy
  • Number
  • 1000
  • 续重重量
  • └ end_address_id
  • String
  • 110000
  • 目标地址编码
  • └ start_weight
  • Number
  • 1000
  • 首重重量
  • └ continued_heavy_price
  • Number
  • 400
  • 续重价格
  • └ start_address_id
  • String
  • 330100
  • 起始地址编码
  • └ end_address
  • String
  • 北京
  • 目标地址
  • └ start_address
  • String
  • 浙江省杭州市
  • 起始地址

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoPickupBillingListGetRequest req = new CainiaoPickupBillingListGetRequest();
req.setMobile("13399990000");
req.setSenderAddress("浙江省杭州市");
CainiaoPickupBillingListGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_pickup_billing_list_get_response>
    <result>
        <success>true</success>
        <retry>false</retry>
        <status_message>系统错误</status_message>
        <status_code>SYSTEM_ERROR</status_code>
        <data_list>
            <billing_template_dto>
                <start_price>600</start_price>
                <continued_heavy>1000</continued_heavy>
                <end_address_id>110000</end_address_id>
                <start_weight>1000</start_weight>
                <continued_heavy_price>400</continued_heavy_price>
                <start_address_id>330100</start_address_id>
                <end_address>北京</end_address>
                <start_address>浙江省杭州市</start_address>
            </billing_template_dto>
        </data_list>
    </result>
</cainiao_pickup_billing_list_get_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

返回
顶部