商家订单发货

对待发货订单填写运单号并通知得物发货。

一、接口名称

  • 接口名称:得物商家订单发货
  • 接口地址:https://kf.fw199.com/gateway/dewu/order/delivery
  • 请求方式:POST
  • Content-Type:application/x-www-form-urlencoded

二、请求参数

公共参数

参数名 类型 是否必需 说明
appid string 必需 开发者 appid
timestamp string 必需 时间戳(秒)
sign string 必需 参数签名

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
order_no string 必需 得物订单号
dispatch_num string 必需 运单号 / 快递单号
carrier number 否 物流承运商编码,默认 0
sysid string 否 应用标识

三、请求示例代码(Java)

@Test
public void dewuOrderDelivery() throws Exception {

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

    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", "0");
    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": null,
  "trace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

4.2 data 说明

参数名 类型 说明
data object / null 上游返回的业务结果;本接口成功时常见为 null

4.3 失败示例

参数错误:

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

订单不存在:

{
  "code": 1,
  "message": "得物订单发货失败: 得物业务错误: code=20301003 msg=暂未找到您的订单信息,请稍后重试"
}

文档更新时间: 2026-09-30 16:39   作者:admin