家装发货

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

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