新增 changeFromQuantity 字段以管理库存

本更新日志涉及 并发保护功能。

以下突变现在支持可选的 changeFromQuantity 字段：

• inventoryAdjustQuantities：在 InventoryChangeInput 输入类型上可用
• inventoryMoveQuantities：在 InventoryMoveQuantityTerminalInput 输入类型上可用
• inventorySetOnHandQuantities：在 InventorySetQuantityInput 输入类型上可用
• productVariantsBulkUpdate：在 InventoryAdjustmentInput 类型上可用，该类型可在 ProductVariantsBulkInput 类型的 quantityAdjustments 字段上使用

注意：productVariantsBulkUpdate 突变的 quantityAdjustments 字段仅在版本 2026-01 中公开。

如何使用该字段

changeFromQuantity 字段有助于保持库存数据的准确性，即使同时发生多个更新也是如此。如果实际数量与您提供的值不匹配，突变将因 CHANGE_FROM_QUANTITY_STALE 错误而失败，从而防止意外的覆盖。

在以下示例中，仅当当前可用数量为 50 时调整才会成功。如果在此期间其他进程修改了数量，您将收到错误提示，并可以使用更新后的值重试。若要禁用比较检查，您可以向 changeFromQuantity 字段显式传递 null。

mutation { inventoryAdjustQuantities( input: { reason: "correction" name: "available" changes: [{ delta: 10 changeFromQuantity: 50 inventoryItemId: "gid://shopify/InventoryItem/123" locationId: "gid://shopify/Location/456" }] } ) { inventoryAdjustmentGroup { id } userErrors { code message } } }

有关比较和交换以及何时应选择不进行比对检查的更多信息，请参阅 我们的文档。我们鼓励用户避免选择不进行比对检查，除非其用例有正当理由。