跳转到内容
返回官网

家装发货

家装类订单使用该接口发货. 此接口已经下线, 已合并到 自己联系物流(线下物流)批量发货

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/logistices/wlb/order/jz/consign

请求参数

名称类型必须示例值描述
appidStringuwkahf@jfs92合作伙伴AppId
timestampString1633618722当前时间戳
tb_seller_nickStringkingdo淘宝卖家店铺登录账号,非店铺名称
signString999de41d862efaa6f1084ead3b3ba480如何计算生成见示例
tidNumbertrue123456789交易号
sender_idNumberfalse12313254452卖家联系人地址库ID,可以通过taobao.logistics.address.search接口查询到地址库ID。如果为空,取的卖家的默认取货地址
+ jz_receiver_toJzReceiverTofalse家装收货人信息,如果为空,则取默认收货信息
— tele_phoneStringfalse0571-88888888座机号
— mobile_phoneStringfalse1234567890123手机号
— addressStringfalse18号详细地址
— contact_nameStringfalse张三收货人名称
— streetStringfalse万塘路街道
— zip_codeStringfalse310013邮编
— provinceStringfalse浙江省
— districtStringfalse西湖区
— cityStringfalse杭州
— countryStringfalse中国国家
+ jz_top_argsJzTopArgsfalse发货参数
— mail_noStringfalse12321323运单号
— package_weightStringfalse2包裹重量
— zy_consign_timeStringfalse2015-08-02 17:25:16自有物流发货时间
— package_volumeStringfalse12包裹体积
— zy_companyStringfalse新华物流自有物流公司名称
— package_remarkStringfalse易碎物品包裹备注
— zy_phone_numberStringfalse1236547890123自有物流公司电话
— package_numberStringfalse2包裹数量
+ lg_tp_dtoTpdtotrue物流公司信息
— nameStringfalse新华物流公司名称
— codeStringfalseXBWL公司编码
+ ins_tp_dtoTpdtofalse安装公司信息,需要安装时,才填写
— nameStringfalse新华物流公司名称
— codeStringfalseXBWL公司编码
+ins_receiver_toJzReceiverTofalse安装收货人信息,如果为空,则取默认收货人信息
— tele_phoneStringfalse0571-88888888座机号
— mobile_phoneStringfalse1234567890123手机号
— addressStringfalse18号详细地址
— contact_nameStringfalse张三收货人名称
— streetStringfalse万塘路街道
— zip_codeStringfalse310013邮编
— provinceStringfalse浙江省
— districtStringfalse西湖区
— cityStringfalse杭州
— countryStringfalse中国国家

说明:上述表格参数中, +表示父元素,—表示其下面的子元素。

二、请求示例代码

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);
}

三、返回结果

{"code":0,"message":"ok","data":{"request_id":"8dh2faghvihi","result_success":true},"trace_id":""}

说明: code为0表示成功,非0为失败,message会包含失败原因。

四、常见问题

四(一)、什么订单才被判断为家装订单

通过订单详情接口获取订单上service_orders节点下的 tmser_spu_code 为下面这些type,就认为是家装订单

(家装干线服务”);

(“家装干支服务”);

(“家装干支装服务”);

(“卫浴大件干线”);

(“卫浴大件干支”);

(“卫浴大件安装”);

(“地板干线”);

(“地板干支”);

(“地板安装”);

(“灯具安装”);

(“卫浴小件安装”);

//618新增8类16种

(“集成吊顶大件干线”)

(“集成吊顶大件干支”)

(“集成吊顶大件安装”)

(“涂料干线”)

(“瓷砖干线”)

(“油漆干线”)

(“涂料干支”)

(“瓷砖干支”)

(“油漆干支”)

(“涂料安装”)

(“瓷砖安装”)

(“油漆安装”)

(“浴霸安装”)

(“墙纸安装”)

(“电子门锁安装”)

(“集成吊顶小件安装”)