出库单 sku 可预约出库数列表【入仓】
按园区和 SPU 分页查询可预约出库的 SKU。
一、接口名称
- 接口名称:得物入仓可预约出库 SKU 列表
- 接口地址:
https://kf.fw199.com/gateway/dewu/storage/stock/out/retrievable/skulist - 请求方式:
POST - Content-Type:
application/x-www-form-urlencoded
二、请求参数
公共参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| appid | string | 必需 | 开发者 appid |
| timestamp | string | 必需 | 时间戳(秒) |
| sign | string | 必需 | 参数签名 |
业务参数
| 参数名 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
| seller_nick | string | 必需 | 得物店铺标识(授权回调中的 seller_nick) |
| campus_code | string | 必需 | 园区编码 |
| spu_id | number | 必需 | 得物 SPU ID |
| page_no | number | 否 | 页码,默认 1 |
| page_size | number | 否 | 每页条数,默认 20 |
| sysid | string | 否 | 应用标识,可联系客服获取) |
三、请求示例代码(Java)
@Test
public void dewuStorageRetrievableSkuList() throws Exception {
String apiUrl = "https://kf.fw199.com/gateway/dewu/storage/stock/out/retrievable/skulist";
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("campus_code", "WN10146864939");
data.put("spu_id", "43556055");
data.put("page_no", "1");
data.put("page_size", "20");
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": {
"total_results": 0,
"page_no": 1,
"page_size": 20,
"pages": 0,
"list": []
},
"trace_id": "04c70bdd-b9d4-4e87-9325-959f27cd68bb"
}4.2 data 主要字段
| 参数名 | 类型 | 说明 |
|---|---|---|
| total_results | number | 总条数 |
| page_no | number | 当前页 |
| page_size | number | 每页条数 |
| pages | number | 总页数 |
| list | array | 可预约出库 SKU 列表,见下方 |
list 元素字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| sku_id | number | 得物 SKU ID |
| title | string | 商品标题 |
| article_number | string | 货号 |
| other_numbers | string | 其他货号 |
| props | string | 规格 |
| logo | string | 商品主图 |
| remain_qty | number | 可预约出库数量 |
| disable_sale | boolean | 是否禁止出售 |
| disable_sale_desc | string | 禁止出售说明 |
4.3 失败示例
参数错误:
{
"code": 1,
"message": "参数campus_code不能为空"
}文档更新时间: 2026-09-30 17:49 作者:admin