出库单 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