库存批量同步接口

1、只支持批量同步归属于同一个商品的sku库存;
2、接口规则全部成功或全部失败,例:批量更新10个skuid库存,其中一个skuid信息不正确,这样整个请求都会失败,10个skuid都未更新成功。

请求URL:

POST https://kf.fw199.com/gateway/dd/sku/sync/stock/batch

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 抖店的账号,对应蜂巢授权返回doudianseller字段
sign String

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
product_id - 3337589750809921129 商品ID,整型格式
idempotent_id String 2 幂等ID,仅incremental=true时有用
incremental Bool true true表示增量库存,false表示全量库存,默认为false
+ sku_sync_list List - 需要批量提交的skuid及对应的库存和仓库信息;接口规则全部成功或全部失败,例:批量更新10个skuid库存,其中一个skuid信息不正确,这样整个请求都会失败,10个skuid都未更新成功。
- outer_sku_id String 232331 外部sku编码,需要结合outer_product_id进行使用
-sku_id Number 99758050 skuid
- sku_type Number 1 库存类型:0普通库存,1区域库存,10阶梯库存
- stock_num Number 10 普通库存数量
- step_stock_num Number 10 阶梯库存数量
-+ stock_map List - 区域库存配置
- -out_warehouse_id String 123 仓id,超市小时达子品传storeId
- - stock_num Number 10 库存数量
- supplier_id String 1 供应商ID
outer_product_id String 232334 推荐使用,外部商家编码,支持字符串
store_id - 12345 即时零售连锁版,通过传入主品id+门店id对该门店下的子品进行操作,即时零售单店版,无需使用

2. 请求示例代码(Java)

请求示例代码

    @Test
    public void  DDSkuSyncstockBatch() throws Exception {
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
        data.put("product_id",3668963015870513459L );
//        data.put("idempotent_id", "2");
        data.put("incremental", false);
//        data.put("outer_product_id", "123");
//        data.put("store_id", 123);
        data.put("sku_sync_list","[\n" +
                "    {\n" +
//                "      \"outer_sku_id\": \"232331\",\n" +
                "      \"sku_id\": \"3398076948315650\",\n" +
                "      \"sku_type\": \"0\",\n" +
                "      \"stock_num\": \"1000\",\n" +
                "      \"step_stock_num\": \"500\",\n" +
                "      \"stock_map\": [\n" +
                "        {\n" +
                "          \"out_warehouse_id\": \"123\",\n" +
                "          \"stock_num\": \"10\"\n" +
                "        }\n" +
                "      ],\n" +
                "      \"supplier_id\": \"1\"\n" +
                "    }\n" +
                "  ]");//sku_sync_list是一个对象
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDSkuSyncStockBatch, data);
        System.out.println(resp);
    }

sku_sync_list参数对象:

{
  "sku_id": "3398076948315650",
  "sku_type": "0",
  "stock_num": "1000",
  "step_stock_num": "500",
  "stock_map": [
    {
      "out_warehouse_id": "123",
      "stock_num": "10"
    }
  ],
  "supplier_id": "1"
}

3. 返回结果如下:


{"code":0,"message":"ok","data":null}

说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明见文档
https://op.jinritemai.com/docs/api-docs/34/298

文档更新时间: 2024-05-22 13:49   作者:JSL