Shopify API返回refunds为空与后台不匹配，如何准确计算日净销售额

问题原因说明 #

你当前无法获取到退款数据主要存在两个核心问题：

1. 调用Orders API时未指定返回字段，Shopify默认不会返回完整的refunds嵌套数据，导致字段为空
2. 你按订单创建日期拉取当日订单，而后台的退款统计口径为退款发生日期，当日统计的退款很可能属于之前日期创建的订单，不会出现在你拉取的当日订单列表中

后台Refunds/Returns字段定义 #

后台显示的退款/退货金额为统计周期内所有发生的退款总和，包含全额退款、部分退款、退货退款、税费/运费退款等所有原路退回给消费者的金额，与原订单的创建时间无关，仅按退款实际发生时间统计。

正确获取数据的方法 #

方案1：按订单维度核算单订单净销售额 #

调用Orders API时追加include=refunds参数，即可获取订单关联的所有退款数据，示例接口如下：
/admin/api/2021-07/orders.json?status=any&created_at_min=2021-08-17T00:00:00-04:00&created_at_max=2021-08-18T00:00:00-04:00&limit=250&include=refunds
单订单的净销售额计算公式为：订单total_price - 该订单下所有退款的金额总和（可根据自身统计口径选择是否扣除运费、税费退款）

方案2：与后台统计口径对齐，按日期统计退款总额 #

直接调用Refunds API按退款发生时间拉取，即可得到和后台完全一致的当日退款总额，示例接口如下：
/admin/api/2021-07/refunds.json?processed_at_min=2021-08-17T00:00:00-04:00&processed_at_max=2021-08-18T00:00:00-04:00&limit=250
当日净销售额计算公式为：当日创建的所有订单总金额 - 当日发生的所有退款总金额

注意事项 #

• 先确认你的API应用已经开启了Orders分类下的Read refunds和Read returns权限，未开启权限时无法获取退款数据
• 如果需要和后台销售报表100%对齐，建议直接使用ShopifyQL查询预计算的统计数据，无需自行累加规避误差，示例查询语句：
  SELECT total_sales, refunds, net_sales FROM sales WHERE date = '2021-08-17'

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