取消菜鸟电子面单
面单号有误需要取消的时候,调用该接口取消获取的电子面单。
一、请求参数
请求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 | 接口签名 | 如何计算生成见示例代码 |
二、请求示例代码
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会包含失败原因。