修改物流公司和运单号
支持卖家发货后修改运单号;支持在线下单和自己联系两种发货方式;使用条件: 1、必须是已发货订单,自己联系发货的必须50天内才可修改;在线下单的,必须下单后物流公司未揽收成功前才可修改; 2、自己联系只能切换为自己联系的公司,在线下单也只能切换为在线下单的物流公司
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/logistices/consign/resend
| 参数名 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
| timestamp | String | true | 1633618722 | 当前时间戳 |
| tb_seller_nick | String | true | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
| sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
| tid | Number | true | 123456 | 淘宝交易ID |
| sub_tids | String | false | 1,2,3 | 拆单子订单列表,对应的数据是:子订单号列表。可以不传,但是如果传了则必须符合传递的规则。子订单必须是操作的物流订单的子订单的真子集! |
| out_sid | String | true | 123456789 | 运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入; |
| company_code | String | true | POST | 物流公司代码.如”POST”代表中国邮政,”ZJS”代表宅急送。调用 taobao.logistics.companies.get 获取。 如果是货到付款订单,选择的物流公司必须支持货到付款发货方式 |
二、请求示例代码
Java
@Test public void TaoBaologisticesConsignResend() 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", "2130415454315565830"); data.put("company_code", "SF"); data.put("out_sid", "SF1303262056675"); data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaologisticesConsignResendUrl ,data);
}三、返回结果
返回结果如下
{ "code": 0, "message": "ok", "data": { "request_id": "14fb0dm2ozu22", "shipping": { "is_success": true } }, "trace_id": ""}说明: code为0表示成功,非0为失败,message会包含失败原因, 业务结果以is_success为准。
四、常用问题
四(一)、无法确定待操作订单
一般是以下原因:1、订单已拆单发货,修改的时候没有传对应的子交易单号;解决:需要把对应的子交易单号传进来,不然找不到对应的订单。2、订单拆单发货了,修改的时候把不同运单号发货的子交易单号放在一起入参了;解决:不是同一个运单号发货的,不能放在一起修改。