截至 API 版本 2026-04,在不指定 available 或 onHand 参数的情况下使用 inventoryActivate 变更操作将不再默认将这些值设为零。如果某商品此前在某个地点处于活跃状态,则该非活跃 InventoryLevel 现有的 active 和 onHand 数量将被保留。
我们做出此变更的原因
此前,inventoryActivate 会将现有库存数量重置为零,从而阻止商家独立追踪激活状态之外的库存情况。此行为会在激活时擦除数量历史记录。此次更新允许商家分别管理库存与激活状态,同时保留其数量历史记录。
对您应用的影响
- GraphQL:在 unstable 或 2026-04 及更高版本中,使用不带 available 或 onHand 参数的 inventoryActivate 变更操作将保留激活前的数量。
- REST:在 unstable 或 2026-04 及更高版本中,对 inventory_levels/connect.json 的 POST 请求将保留激活前的数量。
您需要执行的操作
- 请审查任何假设 inventoryActivate 会将指定库存项和地点的库存数量重置为零的业务逻辑。

