跳转到内容
返回官网

取消菜鸟电子面单

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

一、请求参数

请求URL:

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

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号,非店铺名称kingdo
cp_codeString快递公司codePOSTB
waybill_codeString电子面单号
sysidString100可空, 代表不同的应用,具体请咨询客服
signString接口签名如何计算生成见示例代码

二、请求示例代码

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);
}

三、返回结果

部分数据

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

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