库存批量同步接口
1、只支持批量同步归属于同一个商品的sku库存;
2、接口规则全部成功或全部失败,例:批量更新10个skuid库存,其中一个skuid信息不正确,这样整个请求都会失败,10个skuid都未更新成功。
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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-12-11 19:41 作者:JSL