版权所有©，上海海鼎信息工程股份有限公司，2016-2025，保留所有权利。

接口

1. 接口定义

1.1. 门店商品服务

1.1.1. 批量更新门店商品货架位

POST /{tenant_id}/invc/storeskuservice/store/{store_id}/skus/shelfPositionCode
1.1.1.1. 说明

批量更新门店商品货架位，覆盖更新，空数组则清空。

1.1.1.2. 参数
类型 名称 说明 类型

Path

store_id
必填

门店id

string

Path

tenant_id
必填

租户ID

string

Query

operator
必填

操作人

string

Body

storeSkuShelfPositionCodeList
必填

门店商品货架位列表，每次更新不超过100条

StoreSkuShelfPositionCodeList
1.1.1.3. 响应
HTTP代码 说明 类型

200

successful operation

StoreSkuUpdateResponse
1.1.1.4. HTTP请求示例
请求 path
/string/invc/storeskuservice/store/string/skus/shelfPositionCode?operator=string
请求 body
{
  "store_sku_shelf_position_codes" : [ {
    "sku_id" : "12002",
    "shelf_position_codes" : [ "string" ]
  } ]
}
1.1.1.5. HTTP响应示例
响应 200
{
  "success" : true,
  "code" : "string",
  "message" : "string",
  "errors" : [ {
    "code" : "string",
    "message" : "string",
    "store_id" : "string",
    "sku_id" : "string"
  } ]
}

1.1.2. 批量更新门店商品

POST /{tenant_id}/invc/storeskuservice/store/{store_id}/skus/updates
1.1.2.1. 说明

批量更新门店商品，不存在则创建，存在则修改。

1.1.2.2. 参数
类型 名称 说明 类型

Path

store_id
必填

门店id

string

Path

tenant_id
必填

租户ID

string

Query

operator
必填

操作人

string

Body

storeSkus
必填

门店商品列表，每次更新不超过100条

StoreSkuList
1.1.2.3. 响应
HTTP代码 说明 类型

200

successful operation

StoreSkuUpdateResponse
1.1.2.4. HTTP请求示例
请求 path
/string/invc/storeskuservice/store/string/skus/updates?operator=string
请求 body
{
  "store_skus" : [ {
    "state" : "待售:forSale,可售:sale,禁售: notForSale",
    "modified" : "2016-03-02 12:00:02",
    "store_id" : "001",
    "store_name" : "测试店",
    "sku_id" : "12002",
    "business_type" : "string",
    "erp_state" : "string",
    "is_active_sales" : true,
    "sku_shelf_position_code" : "string",
    "use_state" : "string"
  } ]
}
1.1.2.5. HTTP响应示例
响应 200
{
  "success" : true,
  "code" : "string",
  "message" : "string",
  "errors" : [ {
    "code" : "string",
    "message" : "string",
    "store_id" : "string",
    "sku_id" : "string"
  } ]
}

2. 定义

2.1. StoreSku

门店商品对象

名称 说明 类型

business_type
可选

经营方式：经销、联营、代销
样例 : "string"

string

erp_state
可选

erp商品状态
样例 : "string"

string

is_active_sales
可选

是否动销
默认值 : false
样例 : true

boolean

modified
可选

修改时间,格式为：yyyy-MM-dd HH:mm:ss
样例 : "2016-03-02 12:00:02"

string (date-time)

sku_id
必填

货号
样例 : "12002"

string

sku_shelf_position_code
可选

货位代码
样例 : "string"

string

state
可选

门店商品售卖状态
样例 : "待售:forSale,可售:sale,禁售: notForSale"

string

store_id
必填

门店代码
样例 : "001"

string

store_name
可选

门店名称
样例 : "测试店"

string

use_state
可选

启用状态:启用、不启用
样例 : "string"

string

2.2. StoreSkuError

门店商品对象

名称 说明 类型

code
可选

样例 : "string"

string

message
可选

样例 : "string"

string

sku_id
可选

样例 : "string"

string

store_id
可选

样例 : "string"

string

2.3. StoreSkuList

门店商品列表

名称 说明 类型

store_skus
可选

门店商品列表
样例 : [ "StoreSku" ]

< StoreSku > array

2.4. StoreSkuShelfPositionCode

门店商品货架位对象

名称 说明 类型

shelf_position_codes
可选

货架位列表
样例 : [ "string" ]

< string > array

sku_id
必填

货号
样例 : "12002"

string

2.5. StoreSkuShelfPositionCodeList

门店商品货架位列表

名称 说明 类型

store_sku_shelf_position_codes
可选

门店商品货架位列表
样例 : [ "StoreSkuShelfPositionCode" ]

< StoreSkuShelfPositionCode > array

2.6. StoreSkuUpdateResponse

门店商品对象

名称 说明 类型

code
可选

样例 : "string"

string

errors
可选

样例 : [ "StoreSkuError" ]

< StoreSkuError > array

message
可选

样例 : "string"

string

success
可选

默认值 : false
样例 : true

boolean