关于通过Exact Online API获取数据生成季度报表的技术咨询

核心结论 #

完全可以通过Exact API获取你需要的季度销售额、未结销售/成本、盈亏相关数据，用于生成报表图表。

数据获取的具体端点与方法 #

• 季度销售额：使用SalesInvoices端点，通过$filter筛选当前季度的已确认发票，汇总NetAmount（不含税）或TotalAmount（含税）字段即可。
• 未结销售：从SalesOrders端点筛选状态为未完成的订单，汇总订单金额；同时结合SalesInvoices里未付款的发票（通过PaymentStatus字段判断），这两部分共同构成未结销售数据。
• 未结成本：对应PurchaseOrders（未完成采购订单）和PurchaseInvoices（未付款采购发票），同样通过状态字段筛选后汇总金额。
• 同比盈亏：Exact API没有直接返回同比盈亏的端点，但可以通过GeneralLedgerEntries端点分别拉取当前季度和去年同期的收入类、成本类科目明细，自行计算两者的差值和同比比例。

数据准确性与计算说明 #

• API返回的基础数据（如发票的NetAmount、VATAmount、TotalAmount，订单的金额字段）都是Exact系统内已计算好的，和后台界面显示的数值完全一致，不需要手动重新计算VAT或发票金额。
• 汇总类指标（季度总销售额、盈亏总额）需要你自行聚合：比如筛选指定时间范围的销售发票后求和，或者将收入类科目总和减去成本类科目总和得到盈亏。
• 注意区分不同状态的单据：比如未结销售要排除已完成的订单和已全额付款的发票，务必利用API提供的状态字段做精准筛选。

实操建议 #

• 先针对单个实体（比如SalesInvoices）做小范围测试，拉取几条数据和Exact后台的对应发票对比，确认数据一致性。
• 利用API的$filter、$select参数减少拉取的数据量：比如只选择需要的金额字段，按日期范围过滤，提升Lambda任务的执行效率。
• 对于多公司数据拉取，确保在API请求中切换对应的公司上下文（Exact API支持通过指定公司ID切换数据范围）。

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