修改物流公司和运单号
修改物流公司和运单号
支持卖家发货后修改运单号;支持在线下单和自己联系两种发货方式;使用条件:
1、必须是已发货订单,自己联系发货的必须50天内才可修改;在线下单的,必须下单后物流公司未揽收成功前才可修改;
2、自己联系只能切换为自己联系的公司,在线下单也只能切换为在线下单的物流公司
1.请求参数:
请求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 获取。 如果是货到付款订单,选择的物流公司必须支持货到付款发货方式 |
2. 请求示例代码(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);
}
3. 返回结果
返回结果如下
{
"code": 0,
"message": "ok",
"data": {
"request_id": "14fb0dm2ozu22",
"shipping": {
"is_success": true
}
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因, 业务结果以is_success为准。
4. 常用问题
4.1 无法确定待操作订单
一般是以下原因:
1、订单已拆单发货,修改的时候没有传对应的子交易单号;
解决:需要把对应的子交易单号传进来,不然找不到对应的订单。
2、订单拆单发货了,修改的时候把不同运单号发货的子交易单号放在一起入参了;
解决:不是同一个运单号发货的,不能放在一起修改。
文档更新时间: 2023-05-18 19:14 作者:admin