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

taobao.wlb.order.jzpartner.query (查询家装服务商列表)

为支持家装类目的商家,对绑定家装物流服务的订单可以在商家的ERP中发货、批量发货,因此开发根据服务类型查询所有的服务商列表的接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
taobao_trade_id Number 可选 192528025698293 淘宝交易订单号,如果不填写Tid则必须填写serviceType。如果填写Tid,则表明只需要查询对应订单的服务商。
service_type Number 可选 16 serviceType表示查询所有的支持服务类型的服务商。 家装干线服务 11 家装干支服务 12 家装干支装服务 13 卫浴大件干线 14 卫浴大件干支 15 卫浴大件安装 16 地板干线 17 地板干支 18 地板安装 19 灯具安装 20 卫浴小件安装 21 (注:同一个服务商针对不同类型的serviceType是具有不同的tpCode的)

响应参数

名称 类型 示例值 描述
install_list Partner [] 安装服务商列表
  • └ is_virtual_tp
  • Boolean
  • false
  • 是否虚拟物流商
  • └ service_type
  • Number
  • 12
  • 服务类型
  • └ tp_name
  • String
  • 家装物流
  • 物流商名称
  • └ tp_code
  • String
  • trunkCode;jzwl
  • 物流商编码
server_list Partner [] 物流配送服务商对象列表
  • └ is_virtual_tp
  • Boolean
  • false
  • 是否虚拟物流商
  • └ service_type
  • Number
  • 12
  • 服务类型
  • └ tp_name
  • String
  • 家装物流
  • 物流商名称
  • └ tp_code
  • String
  • trunkCode;jzwl
  • 物流商编码
is_success Boolean true 接口查询成功或者失败
result_info String "参数不合法,查询服务商列表时userId为空!" 查询返回信息,如果失败,存储错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbOrderJzpartnerQueryRequest req = new WlbOrderJzpartnerQueryRequest();
req.setTaobaoTradeId(192528025698293L);
req.setServiceType(16L);
WlbOrderJzpartnerQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<wlb_order_jzpartner_query_response>
    <install_list>
        <partner>
            <is_virtual_tp>false</is_virtual_tp>
            <service_type>12</service_type>
            <tp_name>家装物流</tp_name>
            <tp_code>trunkCode;jzwl</tp_code>
        </partner>
    </install_list>
    <server_list>
        <partner>
            <is_virtual_tp>false</is_virtual_tp>
            <service_type>12</service_type>
            <tp_name>家装物流</tp_name>
            <tp_code>trunkCode;jzwl</tp_code>
        </partner>
    </server_list>
    <is_success>true</is_success>
    <result_info>&quot;参数不合法,查询服务商列表时userId为空!&quot;</result_info>
</wlb_order_jzpartner_query_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

返回
顶部