修改物流公司和运单号

修改物流公司和运单号

支持卖家发货后修改运单号;支持在线下单和自己联系两种发货方式;使用条件:
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