2. 财务报表基础
在API采集与字段映射的实战中，很多同学一上来就急着写请求、解析JSON，结果发现字段对不上、口径不一致、数据入库后无法校验。根本原因往往不是技术问题，而是对财务报表本身的结构和勾稽关系理解不深。本节我们先打地基：把资产负债表、利润表、现金流量表、所有者权益变动表这四张表的结构、它们之间的内在联系，以及常见披露要求讲清楚。只有先建立“报表语义模型”，后续的字段映射才有依据。
一、核心原理：四表是一个整体，不是四张孤立的表
财务报表体系的核心逻辑可以用一句话概括：资产负债表是“时点快照”，利润表、现金流量表、所有者权益变动表是“期间录像”。四张表通过“期末余额=期初余额+本期变动”这一基本恒等式相互咬合。
资产负债表遵循“资产=负债+所有者权益”的会计恒等式，反映某一特定日期的财务状况。利润表反映一定期间的经营成果，其净利润最终会流入资产负债表的所有者权益（未分配利润）和现金流量表的经营活动。现金流量表解释现金及现金等价物在期间内的增减变动，其期末现金余额必须与资产负债表中的货币资金（扣除受限资金后）对应。所有者权益变动表则是连接利润表与资产负债表的桥梁，详细展示权益各项目的期初、本期增减、期末余额。
关键理解：API采集时，如果只抓资产负债表而忽略利润表，就无法验证“未分配利润期末-期初=净利润-分红”这条勾稽；如果只抓利润表而忽略现金流量表，就无法判断利润的“含金量”。四表联采、交叉校验，才是可靠的数据采集方案。
二、四表结构与关键字段清单
下面用一张表梳理四张报表的核心结构、主要项目及API采集时的常见字段命名差异。注意：不同数据源（如Wind、同花顺、交易所XBRL、企业ERP）对同一项目的字段名可能完全不同，这正是字段映射要解决的问题。
| 报表 | 性质 | 核心结构/项目 | 常见API字段名示例 |
|---|---|---|---|
| 资产负债表 | 时点表 | 流动资产、非流动资产、流动负债、非流动负债、所有者权益 | total_assets、total_liab、total_equity、cash_and_equiv |
| 利润表 | 期间表 | 营业收入、营业成本、期间费用、营业利润、利润总额、净利润 | revenue、oper_cost、net_profit、basic_eps |
| 现金流量表 | 期间表 | 经营活动、投资活动、筹资活动产生的现金流量净额 | ncf_oper、ncf_invest、ncf_finance、cash_end |
| 所有者权益变动表 | 期间表 | 实收资本、资本公积、盈余公积、未分配利润、综合收益总额 | paid_in_capital、surplus_reserve、retained_earnings |
采集时建议优先获取“报表期间”“报表类型”“币种”“单位”这四个元数据字段，否则后续合并多期数据时极易出错。例如，有的接口返回单位为“元”，有的为“万元”，若不统一，勾稽校验必然失败。
三、勾稽关系：字段映射的校验规则来源
勾稽关系是财务报表内部和报表之间的数量约束，也是我们做数据质量校验的天然规则库。以下是最常用、最应写入采集校验脚本的几条：
- 表内勾稽：资产总计=负债合计+所有者权益合计；流动资产+非流动资产=资产总计；营业利润+营业外收入-营业外支出=利润总额；利润总额-所得税费用=净利润。
- 表间勾稽：资产负债表未分配利润期末-期初=利润表净利润-本期分红-提取盈余公积；现金流量表期末现金及现金等价物余额=资产负债表货币资金-受限资金（近似）；所有者权益变动表综合收益总额=利润表净利润+其他综合收益。
- 跨期勾稽：本期资产负债表期初余额=上期期末余额；本期所有者权益变动表期初余额=上期期末余额。
实战技巧：在API采集流程中，把上述勾稽关系写成断言（assertion）。例如，采集完一期数据后立即计算“资产总计-负债合计-所有者权益合计”，若绝对值超过阈值（如1元或0.01%），则标记该条记录为“待复核”，而不是直接入库。这能拦截大量因字段映射错误导致的数据污染。
四、常见披露要求与采集场景
上市公司财报披露有明确的格式规范（如证监会《公开发行证券的公司信息披露编报规则》），但不同板块、不同行业的披露粒度差异很大。API采集时需重点关注：
- 合并报表与母公司报表：同一张表通常有两套数据，字段名可能只差一个前缀（如“合并”与“母公司”）。映射时必须区分，否则勾稽关系会混乱。
- 本期与上期对比：利润表、现金流量表通常披露“本期金额”和“上期金额”，采集时需同时保留，用于计算同比和跨期勾稽。
- 附注与明细：很多API只返回主表数据，但应收账款账龄、存货明细、费用明细等在附注中。若业务需要，需额外采集附注接口，并建立主表与附注的关联键。
- 币种与单位：跨国企业可能以美元、港币等列报，采集后需统一换算为人民币，并记录原始币种和汇率。
常见误区：直接把API返回的字段名当作数据库列名，不做语义映射。例如，某接口用“profit”表示净利润，另一接口用“net_profit”，还有的用“np”。若不建立统一的数据字典，后续多源数据合并时会出现“同义不同名”或“同名不同义”的严重问题。建议在采集层就定义标准字段（如net_profit），再为每个数据源编写映射配置。
五、案例：一次勾稽校验失败的复盘
某次采集某上市公司2023年年报数据，入库后发现“未分配利润期末-期初”与“净利润”差异巨大。排查过程如下：
# 采集到的原始数据（单位：万元）
期初未分配利润: 12000
期末未分配利润: 18500
本期净利润: 8000
本期分红: 1000
提取盈余公积: 500
# 勾稽公式预期：
期末 = 期初 + 净利润 - 分红 - 提取盈余公积
= 12000 + 8000 - 1000 - 500 = 18500 ✅ 理论正确
# 但实际采集到的期末未分配利润为 18500，看似正确。
# 进一步检查发现：API返回的“净利润”字段实际是“归母净利润”，
# 而“未分配利润”是合并报表全部权益，两者口径不一致。
# 修正：使用“净利润（含少数股东损益）”重新计算，差异消失。
这个案例说明：勾稽关系不仅是数学公式，更是口径一致性的检验。字段映射时，必须明确每个字段的会计口径（合并/母公司、归母/全部、本期/上期），否则公式再对，数据也是错的。