商家取消获取的电子面单号

面单号有误需要取消的时候,调用该接口取消获取的电子面单。

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/cainiao/waybill/cancel

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
cp_code String 快递公司code POSTB
waybill_code String 电子面单号
sysid String 100 可空, 代表不同的应用,具体请咨询客服
sign String 接口签名 如何计算生成见示例代码

2. 请求示例代码(Java)

    @Test
    public void getCaiNiaoWayBillCancel() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("sysid", "100"); // 此值很重要,代表不同的应用, 具体请咨询客服。
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("cp_code", "YUNDA"); //  物流公司code  比如,YUNDA
        data.put("waybill_code", "4311812281743"); // 电子面单号
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoCaiNiaoWayBillCancelUrl ,data);

    }

3. 返回结果如下(部分数据):

 {
    "code": 0,
    "message": "ok",
    "data": {
         "cancel_result":true
    }
}

说明: code为0表示成功,这是系统层面的成功或失败,非0为失败,对于业务层面, cancel_result表示真正取消是否成功, 如果接口失败 ,msg会包含失败原因。

文档更新时间: 2023-10-11 14:18   作者:admin