订单运单号修改

修改已发货订单的快递单号（仅支持普通现货 / 普通预售 / 品牌直发等订单类型）。

一、接口名称

• 接口名称：得物订单运单号修改
• 接口地址：https://kf.fw199.com/gateway/dewu/order/dispatchnummodify
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

业务参数

三、请求示例代码（Java）

@Test
public void dewuOrderDispatchNumModify() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dewu/order/dispatchnummodify";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", "your_dewu_seller_nick");
    data.put("sysid", "580");
    data.put("order_no", "110100207817221330");
    data.put("dispatch_num", "SF1234567890");
    data.put("carrier", "SF"); // 字符串，非数字
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、响应说明

HTTP 状态码始终为 200，业务成败看 JSON 中的 code 字段（0 表示成功）。

4.1 成功示例

{
  "code": 0,
  "message": "ok",
  "data": true,
  "trace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

4.2 data 说明

4.3 失败示例

参数错误：

{
  "code": 1,
  "message": "参数carrier不能为空"
}

订单类型不支持：

{
  "code": 1,
  "message": "得物运单号修改失败: 得物业务错误: code=100035 msg=仅支持普通现货/普通预售/品牌直发订单修改快递单号！"
}