取消电子面单

用于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