出价列表【入仓】-V2

分页查询入仓出价列表。

一、接口名称

  • 接口名称:得物入仓出价列表 V2
  • 接口地址:https://kf.fw199.com/gateway/dewu/storage/bidding/list
  • 请求方式:POST
  • Content-Type:application/x-www-form-urlencoded

二、请求参数

公共参数

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

业务参数

参数名 类型 是否必需 说明
seller_nick string 必需 得物店铺标识(授权回调中的 seller_nick)
spu_id number 否 得物 SPU ID
sku_ids string 否 得物 SKU ID 列表,英文逗号分隔,如 123,456
bid_min_qty number 否 已出价数量下限
bid_max_qty number 否 已出价数量上限
no_bid_min_qty number 否 未出价数量下限
no_bid_max_qty number 否 未出价数量上限
start_modified string 否 修改时间起
end_modified string 否 修改时间止
page_no number 否 页码,默认 1
page_size number 否 每页条数,默认 20
sysid string 否 应用标识,可联系客服获取)

三、请求示例代码(Java)

@Test
public void dewuStorageBiddingList() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dewu/storage/bidding/list";

    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("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": 5,
    "page_no": 1,
    "page_size": 20,
    "pages": 0,
    "list": [
      {
        "spu_name": "Converse All Star 百搭舒适 高帮 帆布鞋 男女同款 紫色",
        "sku_id": 1090792786,
        "spu_id": 43556055,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260320/b43396adcd6d45f59b87af3de192ab0b.jpg",
        "article_number": "A16811C",
        "other_numbers": "",
        "brand_name": "Converse",
        "not_bid_qty": 1,
        "bid_qty": 0,
        "props": [
          {
            "name": "尺码",
            "value": "37.5",
            "level": 2
          },
          {
            "name": "颜色",
            "value": "紫色",
            "level": 1
          }
        ],
        "stock_no": "WN10146864939",
        "spot_min_price": 0,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 58900,
        "campus_list": [
          {
            "wh_inv_no": "WN10146864939",
            "campus_name": "贵阳园区",
            "qty": 1
          }
        ]
      },
      {
        "spu_name": "Vans Authentic 棋盘格樱桃刺绣系带轻盈个性 轻便 低帮 帆布鞋 男女同款",
        "sku_id": 1192157329,
        "spu_id": 70366482,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260627/2c72b4fd3f6e481a8a23ccfafce2ec39.jpg",
        "article_number": "VN000Z1BKVG",
        "other_numbers": "",
        "brand_name": "Vans",
        "not_bid_qty": 1,
        "bid_qty": 0,
        "props": [
          {
            "name": "尺码",
            "value": "40",
            "level": 2
          },
          {
            "name": "颜色",
            "value": "棋盘格纹灰鸽白/棉花糖白",
            "level": 1
          }
        ],
        "stock_no": "WN10147370084",
        "spot_min_price": 54900,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 0,
        "campus_list": [
          {
            "wh_inv_no": "WN10147370084",
            "campus_name": "清远龙地园区",
            "qty": 1
          }
        ]
      },
      {
        "spu_name": "中国李宁 户外系列 休闲运动梭织长裤 男女同款 黑色",
        "sku_id": 1165786553,
        "spu_id": 63259891,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260602/fa5044676f7d4aa794c121788e3ac6d6.jpg",
        "article_number": "AYKWC63-1",
        "other_numbers": "",
        "brand_name": "中国李宁",
        "not_bid_qty": 1,
        "bid_qty": 0,
        "props": [
          {
            "name": "颜色",
            "value": "黑色",
            "level": 1
          },
          {
            "name": "尺码",
            "value": "L",
            "level": 2
          }
        ],
        "stock_no": "WN10147824886",
        "spot_min_price": 43000,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 0,
        "campus_list": [
          {
            "wh_inv_no": "WN10147824886",
            "campus_name": "武汉园区",
            "qty": 1
          }
        ]
      },
      {
        "spu_name": "Vans Skate Era 经典百搭 板鞋 男女同款 黑色",
        "sku_id": 1172292410,
        "spu_id": 64848549,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260607/8def948c55ea42eab77e630061e7af50.jpg",
        "article_number": "VN000ECRBZW",
        "other_numbers": "",
        "brand_name": "Vans",
        "not_bid_qty": 1,
        "bid_qty": 0,
        "props": [
          {
            "name": "尺码",
            "value": "42",
            "level": 2
          },
          {
            "name": "颜色",
            "value": "黑色",
            "level": 1
          }
        ],
        "stock_no": "WN10147969557",
        "spot_min_price": 44900,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 0,
        "campus_list": [
          {
            "wh_inv_no": "WN10147969557",
            "campus_name": "武汉园区",
            "qty": 1
          }
        ]
      },
      {
        "spu_name": "Converse Throwback 舒适百搭 高帮 帆布鞋 男女同款 酒红色",
        "sku_id": 1207259731,
        "spu_id": 74579305,
        "logo_url": "https://cdn.poizon.com/pro-img/origin-img/20260714/8b2a5d6ba52c436da5f720a9e16aba1b.jpg",
        "article_number": "A20071C",
        "other_numbers": "",
        "brand_name": "Converse",
        "not_bid_qty": 1,
        "bid_qty": 0,
        "props": [
          {
            "name": "尺码",
            "value": "37",
            "level": 2
          },
          {
            "name": "颜色",
            "value": "酒红色",
            "level": 1
          }
        ],
        "stock_no": "WN10148368477",
        "spot_min_price": 0,
        "current_channel_min_price": 0,
        "my_min_price": 0,
        "flash_min_price": 0,
        "campus_list": [
          {
            "wh_inv_no": "WN10148368477",
            "campus_name": "贵阳园区",
            "qty": 1
          }
        ]
      }
    ]
  },
  "trace_id": "e81368fa-7ae4-4c78-b83f-c043aaef1674"
}

4.2 data 主要字段

参数名 类型 说明
total_results number 总条数
page_no number 当前页
page_size number 每页条数
pages number 总页数
list array 出价列表,见下方

list 元素字段:

参数名 类型 说明
spu_name string 商品名称
sku_id number 得物 SKU ID
spu_id number 得物 SPU ID
logo_url string 商品主图
article_number string 货号
other_numbers string 其他货号
brand_name string 品牌名称
not_bid_qty number 未出价数量
bid_qty number 已出价数量
props array 规格,见下方
stock_no string 库存编号
spot_min_price number 现货最低价,单位:分
current_channel_min_price number 当前渠道最低价,单位:分
my_min_price number 我的最低价,单位:分
flash_min_price number 闪电最低价,单位:分
campus_list array 园区库存,见下方

props 元素字段:

参数名 类型 说明
name string 规格名,如尺码、颜色
value string 规格值
level number 规格层级

campus_list 元素字段:

参数名 类型 说明
wh_inv_no string 仓存单号
campus_name string 园区名称
qty number 数量

4.3 失败示例

参数错误:

{
  "code": 1,
  "message": "参数sku_ids无效"
}

文档更新时间: 2026-09-30 17:24   作者:admin