修改虚拟库存

websocket测试

POST

请求地址/router

接口描述

更新虚拟库存

系统相关界面

"界面路径：【库存】----【虚拟仓管理】----【编辑】"

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境（推荐）| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key，统一使用V2正式环境的请求地址：**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有： | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式，可选值：json | | version | string | 是 | API协议版本可选值：1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息（即access_token，由系统分配） |

请求头

参数名

类型

描述

必填

Content-Type

string

application/x-www-form-urlencoded;charset=UTF-8

必填

API接口地址

参数名

类型

描述

必填

method

string

erp.item.virtual.stock.update

必填

请求参数

参数名

类型

描述

必填

itemIds

array

商品信息，纯商品sysSkuId传0，(同平台规格商家编码二选一) 格式[{"sysItemId":295711729489408,"sysSkuId":123},{"sysItemId":282263597731328,"sysSkuId":0}]

可选

sysSkuId

long

系统商品skuID

可选

sysItemId

long

系统主商品ID

可选

warehouseId

long

仓库ID

必填

stockNum

long

虚拟库存数量

必填

skuOuterIds

string

平台规格商家编码，多个逗号隔开(同商品信息二选一，最多只能传20个)

可选

outerIds

string

平台商家编码，多个逗号隔开(最多只能传20个)

可选

请求示例

示例一： ----------------- ```` { "itemIds":[ { "sysItemId":long, "sysSkuId":long }, { "sysItemId":long, "sysSkuId":long } ], "stockNum":long, "warehouseId":long } ```` 示例二： ----------------- ```` { "skuOuterIds":"001,002", "stockNum":long, "warehouseId":long } ````

响应参数

参数名

类型

描述

msg

string

返回信息

traceId

string

流水id 示例：3553483395407017

code

string

返回码

success

boolean

true-成功，false-失败

响应示例

``` { "msg": "zhangsan", "traceId": "zhangsan", "code": "zhangsan", "solution": "zhangsan", "subCode": "zhangsan", "subMsg": "zhangsan", "body": "zhangsan", "forbiddenField": "zhangsan" } ```

异常示例

```` { "code": "25", "msg": "服务方法(erp.item.virtual.stock.update)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |20305|仓库ID不能为空或小于0|请检查该参数的值是否为空或小于0| |20308|商品信息不能为空|请检查商品信息字段是否为空| |20309|平台规格商家编码最多支持20组!|请检查平台规格商家编码是否超过20组| |20310|虚拟库存数量不能为空或小于0|请检查该参数的值是否为空或小于0| |20311|平台商品信息最多支持20组！|请检查平台商品信息是否超过20组| |20112|平台商家编码最多支持20组！|请检查平台商家编码是否超过20组|