文档中心 > API类目 > 淘宝物流API

taobao.logistics.partners.get (查询支持起始地到目的地范围的物流公司)

查询物流公司信息(可以查询目的地可不可达情况)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
source_id String 可选 110000
  • 默认值:0
  • 物流公司揽货地地区码(必须是区、县一级的).参考:http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html或者调用 taobao.areas.get 获取
    target_id String 可选 110000
  • 默认值:0
  • 物流公司派送地地区码(必须是区、县一级的).参考:http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html或者调用 taobao.areas.get 获取
    service_type String 可选 cod 服务类型,根据此参数可查出提供相应服务类型的物流公司信息(物流公司状态正常),可选值:cod(货到付款)、online(在线下单)、 offline(自己联系)、limit(限时物流)。然后再根据source_id,target_id,goods_value这三个条件来过滤物流公司. 目前输入自己联系服务类型将会返回空,因为自己联系并没有具体的服务信息,所以不会有记录。
    goods_value String 可选 30
  • 默认值:0
  • 货物价格.只有当选择货到付款此参数才会有效
    is_need_carriage Boolean 可选 false
  • 默认值:false
  • 是否需要揽收资费信息,默认false。在此值为false时,返回内容中将无carriage。在未设置source_id或target_id的情况下,无法查询揽收资费信息。自己联系无揽收资费记录。

    响应参数

    名称 类型 示例值 描述
    logistics_partners LogisticsPartner [] 查询揽送范围之内的物流公司信息
    • carriage
    • CarriageDetail
    • 物流公司揽收和资费详细信息
    • └ add_fee
    • Number
    • 15
    • 续费(单位:元)
    • └ add_weight
    • Number
    • 1
    • 续重(单位:千克)
    • └ damage_payment
    • String
    • 25
    • 破损赔付
    • └ got_time
    • String
    • 11:00~18:00
    • 物流公司揽收时间段
    • └ initial_fee
    • Number
    • 12
    • 首费(单位:元)
    • └ initial_weight
    • Number
    • 1
    • 首重(单位:千克)
    • └ lost_payment
    • String
    • 20
    • 丢单赔付
    • └ way_day
    • String
    • 3-4
    • 快件送达所需的时间(单位:天)
    • └ cover_remark
    • String
    • 全境揽收
    • 揽收说明信息
    • partner
    • PartnerDetail
    • 物流公司详细信息
    • └ account_no
    • String
    • 2088001497872884015
    • 物流公司支付宝账号
    • └ company_code
    • String
    • STO
    • 物流公司代码
    • └ company_id
    • Number
    • 100
    • 物流公司id
    • └ full_name
    • String
    • 申通快递有限公司
    • 物流公司全名
    • └ reg_mail_no
    • String
    • ^[0-9]{12}$
    • 运单号验证正则表达式
    • └ wangwang_id
    • String
    • 申通在线客服
    • 旺旺id
    • └ company_name
    • String
    • 申通E物流
    • 物流公司简称
    • └ uncover_remark
    • String
    • 乡村不派送
    • 不可送达的说明信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LogisticsPartnersGetRequest req = new LogisticsPartnersGetRequest();
    req.setSourceId("110000");
    req.setTargetId("110000");
    req.setServiceType("cod");
    req.setGoodsValue("30");
    req.setIsNeedCarriage(false);
    LogisticsPartnersGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <logistics_partners_get_response>
        <logistics_partners>
            <logistics_partner>
                <carriage>
                    <add_fee>15</add_fee>
                    <add_weight>1</add_weight>
                    <damage_payment>25</damage_payment>
                    <got_time>11:00~18:00</got_time>
                    <initial_fee>12</initial_fee>
                    <initial_weight>1</initial_weight>
                    <lost_payment>20</lost_payment>
                    <way_day>3-4</way_day>
                </carriage>
                <cover_remark>全境揽收</cover_remark>
                <partner>
                    <account_no>2088001497872884015</account_no>
                    <company_code>STO</company_code>
                    <company_id>100</company_id>
                    <full_name>申通快递有限公司</full_name>
                    <reg_mail_no>^[0-9]{12}$</reg_mail_no>
                    <wangwang_id>申通在线客服</wangwang_id>
                    <company_name>申通E物流</company_name>
                </partner>
                <uncover_remark>乡村不派送</uncover_remark>
            </logistics_partner>
        </logistics_partners>
    </logistics_partners_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

    返回
    顶部