库存批量同步接口

一、请求参数

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

请求URL:

POST https://kf.fw199.com/gateway/dd/sku/syncstockbatch

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
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对该门店下的子品进行操作，即时零售单店版，无需使用

二、请求示例代码

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"
}

三、返回结果

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

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