微盟云 - 文档中心

文档中心

商城 > 库存管理 > 库存管理 > weimob_shop/stock/update

覆盖/增量更新库存

weimob_shop/stock/update

v2.0

最近修改时间：2024-02-21 17:39:27

接口描述

用于根据商品 ID 与商品 SKU ID，覆盖或增量更新对应商品 SKU 的可用库存。

注意事项

调用逻辑

▪ 本接口与后台界面关系，请参见更新库存 API 与商家后台逻辑。

▪ 本接口更新的是商品的可用库存。

▪ 本接口不支持修改门店自建商品的库存。

▪ 本接口不支持更新虚拟商品的库存。

▪ 本接口支持更新下架状态的商品库存。

▪ 本接口支持一次最多更新 50 个 SKU（可为不同商品的 SKU，SKU 总数不超过 50 即可）。

▪ 本接口不支持直接更新组合商品的库存，组合商品库存以基础商品库存为准，即如果需要更新组合商品的库存，传入组合品关联的基础商品即可。

▪ 入参 warehouseId、warehouseCode、vid 的优先级：

▫ 如果 warehouseId、warehouseCode 都不传，默认更新 vid 对应的门店独立仓的库存。

▫ 如果三个参数都传入，则更新库存的优先级是：warehouseId＞warehouseCode＞vid。

▪ 库存同步能力包中包含了更新商品库存需调用的全部 API 接口，您可以通过对接该能力包完成库存更新。

▪ 该接口调用的常见问题，请参见库存对接问题。

调用权限

▪ 调用前，请确保您已在微盟云控制台申请了该 API。申请步骤请参见申请能力。

▪ ACCESS_TOKEN 是调用 API 的授权令牌。获取方法请参见获取 token（自有型）或获取 token（工具型）。

接口信息

协议	请求方式	请求地址
https	POST	https://dopen.weimob.com/apigw/weimob_shop/v2.0/stock/update?accesstoken=ACCESS_TOKEN

请求参数

参数	是否必填	类型	示例	描述
暂无数据

响应参数

参数	类型	示例	描述
暂无数据

接口示例

请求示例

json

点击复制

{
  "warehouseId": 205898,
  "basicInfo": {
    "vid": 6000287446212
  },
  "goodsList": [
    {
      "skuList": [
        {
          "stockNum": 100,
          "skuId": 100025479149212
        }
      ],
      "goodsId": 100020930149212
    }
  ],
  "quantityEditType": 0,
  "warehouseCode": "独立仓"
}

响应示例

json

点击复制

{
  "code": {
    "errcode": "0",
    "errmsg": "success"
  },
  "data": {
    "failList": [
      {
        "goodsId": 100025479149212,
        "skuIdSet": [
          149234,
          149212
        ],
        "message": "sku库存不能为负数"
      }
    ]
  }
}