商家订单发货
对待发货订单填写运单号并通知得物发货。
一、接口名称
- 接口名称:得物商家订单发货
- 接口地址:
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