如何高效获取Shopify中商品/变体的committed库存值？

问题背景 #

Shopify后台「商品>库存」板块中的committed库存，是预留为待处理订单或已创建但未完成订单的库存数量，该数值对库存更新逻辑至关重要，但直接获取难度较高。

核心问题 #

如何高效获取该「committed」库存值？

现有调研局限 #

• 无法通过2022-07版本的Shopify REST/GraphQL API直接获取该字段
• 遍历所有未完成订单并按变体汇总未履行数量的方式，耗时且会消耗大量API配额

优化实现方案 #

1. 缩小订单查询范围，减少无效数据拉取 #

无需遍历所有未完成订单，通过API参数精准过滤目标订单：

• REST API：使用status=open+fulfillment_status=unfulfilled参数筛选出未履行的未完成订单，再结合updated_at_min限定时间范围（比如仅查询近30天的订单，超期未处理的订单可单独标记后批量处理）
• GraphQL API：查询orders时添加status: OPEN和fulfillmentStatus: UNFULFILLED条件，同时指定updatedAt范围，仅拉取lineItems.variant.id和lineItems.quantity等必要字段，降低数据传输量

2. 基于Webhook维护本地缓存，实现实时查询 #

通过订阅Shopify的orders/create、orders/update、orders/cancel Webhook，实时同步未完成订单的商品变体数据到本地数据库：

• 新订单创建时，将未履行的变体数量累加至对应变体的committed计数
• 订单完成履行、部分履行或取消时，同步调整对应变体的committed计数
  后续获取committed库存时，直接从本地数据库按变体汇总，无需调用Shopify API

3. 批量GraphQL查询压缩API请求次数 #

利用GraphQL的批量查询能力，单次请求拉取更多订单数据，减少API调用频次：

query GetUnfulfilledOpenOrders {
  orders(first: 100, status: OPEN, fulfillmentStatus: UNFULFILLED) {
    edges {
      node {
        lineItems(first: 50) {
          edges {
            node {
              variant {
                id
              }
              quantity
            }
          }
        }
      }
    }
  }
}

该查询单次可获取100个订单，每个订单最多返回50个商品行，能大幅降低API配额消耗，提升查询效率

内容的提问来源于stack exchange，提问作者mbesson