Shopify按日期筛选退款列表（非订单）的技术问题

当前现状 #

我们用以下API获取退款相关数据：

GET /admin/api/2022-10/orders.json?financial_status=refunded,partially_refunded&fields=refunds&created_at_min=2022-10-05T00:00:00-05:00&created_at_max=2022-11-17T24:00:00-05:00&limit=250&since_id=0&status=any

但Shopify没有提供直接按退款发生日期筛选的Listing API，当前API是基于订单创建时间过滤的。这就导致一个问题：如果退款在订单创建很久之后发起（比如12月创建的订单，次年2月才退款），这个退款只会出现在12月的订单查询结果里，在2月的订单列表中根本找不到。

可行的解决办法 #

• 拉取全量退款订单后本地筛选
  先通过订单API分批拉取所有financial_status为refunded或partially_refunded的订单（用since_id分页控制单次请求量），然后遍历每个订单的refunds数组，提取退款的created_at字段，筛选出符合目标日期范围的记录。注意要遵守Shopify的API速率限制，避免触发限流。

• 用Webhook实时同步退款数据
  配置Shopify的refunds/create Webhook，每当有新退款生成时，实时将数据推送到自己的服务并存储到数据库。之后需要按日期查询退款时，直接从自建数据库检索，完全绕开订单API的时间限制问题。

• 扩大订单筛选的时间范围（权宜之计）
  如果业务场景允许，查询目标时间段的退款时，把订单创建时间的筛选范围扩大到过去N个月（比如6个月），确保覆盖可能发起退款的订单。但这种方式会拉取大量无关订单，增加数据处理的成本。

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