商品库存推送
1. 前言:
供应商调用来伊份接口将商品库存余量推送至来伊份
2. 交互时序图:
3. 请求场景:
供应商调用来伊份接口将商品库存余量推送至来伊份
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
描述 | 值 |
---|---|
服务名称 | cstore-route-app-api |
URL | 测试环境:https://openapi.laiyifen.com/cstore-route-app-api/stock/update 生产环境:https://openapi.laiyifen.com/cstore-route-app-api/stock/update |
认证方式 | 令牌 |
请求方式 | HTTP(POST) |
功能描述(适用场景) | 供应商调用来伊份接口将商品库存余量推送至来伊份 |
5.2 请求头公共参数 (Header)
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
X-Co-Sign | String | 是 | 签名 |
X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Body
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
appKey | String | 是 | 来伊份发货单号 |
updateTime | String | 是 | 三方发货单号 |
updateType | String | 否 | 取消原因 |
outWarehouseCode | String | 是 | 三方商品编码 |
stockList | List<SkuStockInfo> | 是 | 商品信息列表 |
SkuStockInfo
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
outSkuCode | String | 否 | 供应商商品编码(outSkuCode和skuCode二者必填其一) |
skuCode | String | 否 | 商品编码(outSkuCode和skuCode二者必填其一) |
availableQuantity | Bigdecimal | 是 | 库存数量 |
skuUnit | String | 是 | 库存单位 |
5.4 入参示例
{
"updateTime": 1631894400000,
"stockList": [
{
"outSkuCode": "A1212",
"availableQuantity": 100,
"skuUnit": "PAK"
},
{
"outSkuCode": "A1213",
"availableQuantity": 10,
"skuUnit": "KG"
}
]
}
5.5 返回统一参数
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
code | String | 是 | 返回请求业务代码 |
msg | String | 是 | 返回信息描述 |
data | Json | 是 | 返回参数 |
5.6 返回参数Data
5.7 返回示例
{
"code":"0",
"msg":"success"
}