家装发货
家装类订单使用该接口发货. 此接口已经下线, 已合并到 自己联系物流(线下物流)批量发货 。
1.请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/logistices/wlb/order/jz/consign
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
appid | String | 是 | uwkahf@jfs92 | 合作伙伴AppId |
timestamp | String | 是 | 1633618722 | 当前时间戳 |
tb_seller_nick | String | 是 | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
sign | String | 是 | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例 |
tid | Number | true | 123456789 | 交易号 |
sender_id | Number | false | 12313254452 | 卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认取货地址 |
+ jz_receiver_to | JzReceiverTo | false | 家装收货人信息,如果为空,则取默认收货信息 | |
— tele_phone | String | false | 0571-88888888 | 座机号 |
— mobile_phone | String | false | 1234567890123 | 手机号 |
— address | String | false | 18号 | 详细地址 |
— contact_name | String | false | 张三 | 收货人名称 |
— street | String | false | 万塘路 | 街道 |
— zip_code | String | false | 310013 | 邮编 |
— province | String | false | 浙江省 | 省 |
— district | String | false | 西湖区 | 区 |
— city | String | false | 杭州 | 市 |
— country | String | false | 中国 | 国家 |
+ jz_top_args | JzTopArgs | false | 发货参数 | |
— mail_no | String | false | 12321323 | 运单号 |
— package_weight | String | false | 2 | 包裹重量 |
— zy_consign_time | String | false | 2015-08-02 17:25:16 | 自有物流发货时间 |
— package_volume | String | false | 12 | 包裹体积 |
— zy_company | String | false | 新华物流 | 自有物流公司名称 |
— package_remark | String | false | 易碎物品 | 包裹备注 |
— zy_phone_number | String | false | 1236547890123 | 自有物流公司电话 |
— package_number | String | false | 2 | 包裹数量 |
+ lg_tp_dto | Tpdto | true | 物流公司信息 | |
— name | String | false | 新华物流 | 公司名称 |
— code | String | false | XBWL | 公司编码 |
+ ins_tp_dto | Tpdto | false | 安装公司信息,需要安装时,才填写 | |
— name | String | false | 新华物流 | 公司名称 |
— code | String | false | XBWL | 公司编码 |
+ins_receiver_to | JzReceiverTo | false | 安装收货人信息,如果为空,则取默认收货人信息 | |
— tele_phone | String | false | 0571-88888888 | 座机号 |
— mobile_phone | String | false | 1234567890123 | 手机号 |
— address | String | false | 18号 | 详细地址 |
— contact_name | String | false | 张三 | 收货人名称 |
— street | String | false | 万塘路 | 街道 |
— zip_code | String | false | 310013 | 邮编 |
— province | String | false | 浙江省 | 省 |
— district | String | false | 西湖区 | 区 |
— city | String | false | 杭州 | 市 |
— country | String | false | 中国 | 国家 |
说明:上述表格参数中, +表示父元素,—表示其下面的子元素。
2. 请求示例代码(Java)
@Test
public void WlbOrderJzConsignRequest() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", tb_seller_nick);
data.put("tid", "2532549276407343839");
String lgTPDtoJson = "{\"name\":\"圆通速递\", \"code\" : \"YTO\"}";
data.put("lg_tp_dto", lgTPDtoJson);
String jz_top_argsJson = "{\"mail_no\":\"YT6383161721380\"}";
data.put("jz_top_args", jz_top_argsJson);
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.WlbOrderJzConsignRequestUrl ,data);
System.out.println(resp);
}
3. 返回结果如下:
{"code":0,"message":"ok","data":{"request_id":"8dh2faghvihi","result_success":true},"trace_id":""}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 常见问题
4.1 什么订单才被判断为家装订单
通过订单详情接口获取订单上service_orders节点下的 tmser_spu_code 为下面这些type,就认为是家装订单
(家装干线服务”);
(“家装干支服务”);
(“家装干支装服务”);
(“卫浴大件干线”);
(“卫浴大件干支”);
(“卫浴大件安装”);
(“地板干线”);
(“地板干支”);
(“地板安装”);
(“灯具安装”);
(“卫浴小件安装”);
//618新增8类16种
(“集成吊顶大件干线”)
(“集成吊顶大件干支”)
(“集成吊顶大件安装”)
(“涂料干线”)
(“瓷砖干线”)
(“油漆干线”)
(“涂料干支”)
(“瓷砖干支”)
(“油漆干支”)
(“涂料安装”)
(“瓷砖安装”)
(“油漆安装”)
(“浴霸安装”)
(“墙纸安装”)
(“电子门锁安装”)
(“集成吊顶小件安装”)
文档更新时间: 2023-03-14 16:34 作者:admin