如何通过Shopware API高效统计已支付订单数量？

1. REST API 关联查询（一次请求搞定统计） #

Shopware的REST API支持通过associations参数直接关联加载订单的交易数据，无需逐个请求订单详情。你可以通过过滤条件筛选已支付订单，同时直接获取总数：

请求示例 #

GET /api/order?associations[transactions]=&filter[transactions.state]=eq:paid&limit=0&total-count-mode=1

参数说明 #

• associations[transactions]=：指定关联加载订单的交易（transactions）数据，让接口返回订单关联的支付状态
• filter[transactions.state]=eq:paid：过滤出支付状态为paid的订单
• limit=0：无需返回具体订单内容，只获取统计数
• total-count-mode=1：强制接口返回符合条件的订单总数量（默认可能不返回总数，需开启此参数）

这个请求会直接返回已支付订单的总数，不用遍历3万条订单ID再逐个查询。

2. GraphQL 查询（灵活精准获取数据） #

Shopware 6及以上版本支持GraphQL API，你可以用它精准查询订单的支付状态，或者直接统计已支付订单数量：

仅统计已支付订单数量的查询 #

query {
  orders(filter: {transactions: {state: {eq: "paid"}}}) {
    total
  }
}

获取订单基础信息+支付状态的查询 #

如果需要同时拿到订单数据和支付状态，可使用：

query {
  orders(filter: {transactions: {state: {eq: "paid"}}}) {
    total
    edges {
      node {
        id
        orderNumber
        transactions {
          state
        }
      }
    }
  }
}

GraphQL的优势是按需获取字段，避免冗余数据，一次请求即可完成统计或数据获取。

3. 聚合统计（一次性获取多状态订单数） #

如果需要同时统计多种支付状态（如paid、cancelled）的订单数量，可以用REST API的聚合功能：

请求示例 #

GET /api/order?aggregations[paymentState][type]=term&aggregations[paymentState][field]=transactions.state&filter[transactions.state]=in:paid,cancelled

这个请求会返回每个支付状态对应的订单数量，一次请求就能拿到多维度统计结果。

4. 高阶优化：自定义API端点（超大数据量场景） #

如果店铺订单量极大（如10万+），直接调用内置API可能存在性能瓶颈，你可以自定义一个API端点：

• 直接通过Shopware的数据库查询构造统计逻辑，比如从order_transaction表聚合state字段的数量
• 自定义端点可以跳过API层的冗余逻辑，大幅提升统计速度

注意事项 #

• 版本兼容性：上述方法适用于Shopware 6，Shopware 5的REST API参数略有差异，但同样支持associations关联加载
• 权限配置：确保API用户拥有order:read和order_transaction:read的权限
• 分页处理：如果需要获取具体订单数据，记得搭配page和limit参数分页请求，避免超时

内容的提问来源于stack exchange，提问作者O'Niel