能否通过App Store Connect API获取沙盒账户的内购及财务报告、发票？

沙盒环境仅用于测试内购、订阅的交易流程，不会产生真实财务流水，因此苹果不提供沙盒交易的财务报告和发票，也没有对应的API支持获取这类数据。如果要测试报表模块的展示逻辑，建议自行模拟沙盒交易数据生成测试报表。

苹果提供App Store Connect API来获取正式财务数据，相关接口如下：

财务报告API #

用于获取销售、订阅等财务数据报告，支持按时间、类型筛选：

• 请求方式：GET
• 端点：/v1/financeReports
• 核心参数：
  • filter[reportDate]：必填，指定报告日期范围，格式为YYYY-MM-DD..YYYY-MM-DD，例如2024-01-01..2024-01-31
  • filter[reportType]：必填，指定报告类型，可选值包括FINANCIAL_SUMMARY（财务汇总）、SALES（销售明细）、SUBSCRIPTION_EVENT（订阅事件明细）等
  • filter[regionCode]：可选，指定地区代码（如US、CN），筛选特定地区交易数据
  • filter[vendorNumber]：必填，开发者账号对应的供应商编号，可在App Store Connect「付款与财务」页面找到

发票API #

用于获取正式税务发票：

• 请求方式：GET
• 端点：/v1/invoices
• 核心参数：
  • filter[periodStartDate]：必填，发票所属周期的开始日期，格式YYYY-MM-DD
  • filter[periodEndDate]：必填，发票所属周期的结束日期，格式YYYY-MM-DD
  • filter[status]：可选，筛选发票状态，例如PAID（已支付）、DUE（待支付）

额外注意事项 #

• 使用这些API前，需在App Store Connect创建API密钥，并开启「财务」相关权限
• 请求需携带JWT令牌做身份验证，令牌需用你的API密钥生成
• 可通过Accept请求头指定返回格式，如application/json或text/csv

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