跳到主要内容

修改虚拟库存

系统相关界面​

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

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即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组