取消电子面单
用于ISV/商家ERP系统 端发起取消已获取的电子面单号
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/gateway/dd/order/logistics/cancel
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | oms38173182 | 抖店的账号,对应蜂巢授权返回doudianseller字段 |
sign | String | 是 |
业务参数
参数名 | 类型 | 是否必须 | 示例值 | 说明 |
---|---|---|---|---|
logistics_code | String | 是 | zhongtong | 物流公司 |
track_no | String | 是 | 1232143214 | 运单号 |
user_id | int64 | 否 | 1 | 实际使用取号服务店铺user_id |
2. 请求示例代码(Java)
@Test
public void cancelOrder() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.DDSellerNick);
data.put("logistics_code","zhongtong");
data.put("track_no","755449563871502");
// data.put("user_id","1");
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDLogisticsCancelOrderUrl, data);
System.out.println(resp);
}
3. 返回结果如下:
3.1 成功返回
{"code":0,"message":"ok","data":{"cancel_result":{"success":true}}}
业务层面取消是否成功以cancel_result中的success为准.
3.2 失败返回
{"code":1,"message":"非法的参数,电子面单号不存在"}
说明: code为0表示成功,非0为失败,message会包含失败原因。
文档更新时间: 2023-03-14 16:53 作者:admin