1. 课程导入
假设你是一家上市公司的财务报告工程师，需要在同一天向交易所、税务局和三家不同的银行提交财务数据。如果每家机构都要求不同的Excel模板、不同的字段命名、不同的币种精度，你大概率会陷入反复复制粘贴、人工核对、口径不一致的泥潭。XBRL（eXtensible Business Reporting Language，可扩展商业报告语言）正是为解决这类问题而诞生的：它用一套基于XML的标准，把财务报告中的每一个数字都变成"带标签、带语境、可被机器直接理解"的结构化数据。
本课程不是泛泛介绍XBRL概念，而是聚焦工程落地：如何设计分类标准（Taxonomy），如何生成合规的实例文档（Instance），以及如何用工具链完成校验、转换与交付。第1章作为导入，先帮你建立全局认知地图，后续29章将逐层展开技术细节。
一、核心原理：XBRL到底"标"了什么
传统财务报告是"给人看的"：PDF里的"营业收入 1,234,567元"对人类可读，但机器无法判断这个数字属于哪家公司、哪个期间、哪个会计准则、单位是元还是万元。XBRL的做法是给每个事实（Fact）附加四类信息：
- 概念（Concept）：这个数字是什么，如
ifrs-full:Revenue或cn-gaap:营业收入，由分类标准定义。 - 语境（Context）：谁、什么时候、什么维度，包括实体标识、期间、场景（如合并/母公司、分部）。
- 单位（Unit）：货币单位、纯数字、每股收益等，如
iso4217:CNY。 - 精度与数值：数值本身及
decimals或precision属性，决定舍入规则。
这四者组合成一个"事实"，机器就能自动完成跨公司、跨期间、跨准则的比对与计算。XBRL不是一种编程语言，而是一种数据建模规范；Taxonomy是"字典+语法"，Instance是"用字典写出来的一篇具体报告"。
关键区分：Taxonomy定义"可以报什么"，Instance记录"实际报了什么"。前者是Schema与Linkbase的集合，后者是XHTML或XML中嵌入的Fact集合。工程中80%的报错，根源都在二者版本不匹配或语境定义冲突。
二、发展背景与全球应用现状
XBRL起源于1998年美国注册会计师Charles Hoffman的构想，2001年成立XBRL国际组织（XII）。此后发展出三条主线：
- 监管驱动：美国SEC于2009年强制上市公司用XBRL报送财报；中国证监会、财政部、银保监会陆续发布企业会计准则通用分类标准及扩展分类标准。
- 准则适配：IFRS基金会发布IFRS Taxonomy，中国发布CAS Taxonomy，各国在通用框架上做本地化扩展。
- 技术演进：从XBRL 2.1到Inline XBRL（iXBRL），使HTML报告与结构化数据合一，降低披露成本。
当前全球主要应用场景包括：证券监管报送（SEC EDGAR、沪深交易所）、税务申报、银行监管数据（如欧洲EBA）、企业内部管理报告。中国上市公司年报XBRL实例文档已实现常态化报送，且逐步向iXBRL过渡。
三、方法流程：一个典型XBRL工程的生命周期
无论你使用何种工具（如Arelle、UBMatrix、国内报送软件），工程流程大体一致：
- 需求分析：明确报送主体、准则、期间、维度（如分部、产品线）。
- 分类标准选型与扩展：优先复用CAS/IFRS通用分类标准，仅对特有科目做扩展，并记录扩展理由。
- 实例文档生成：从ERP或报表系统抽取数据，映射到概念，构造Context与Unit，写入Fact。
- 校验：运行计算链接库校验、公式校验、Schema校验，修复错误。
- 交付与归档：生成最终XML或iXBRL，提交监管平台，保留版本快照。
工程建议：把Taxonomy版本号写入Instance的schemaRef，并在CI流水线中固定校验工具版本。分类标准一旦升级，旧实例可能因概念废弃而校验失败，版本管理是长期运维的关键。
四、案例与误区复盘
某上市公司首次报送时，财务人员直接把Excel中的"营业收入"填入了ifrs-full:Revenue，但未区分"合并"与"母公司"语境，导致同一概念出现两个值却共用同一Context，校验报出"重复事实"错误。复盘发现：问题不在数值，而在语境维度设计。正确做法是为合并报表和母公司报表分别建立Context，并在Scenario中声明ConsolidatedMember或ParentMember。
| 常见误区 | 表现 | 纠正方法 |
|---|---|---|
| 概念混用 | 用自定义概念替代通用概念 | 优先复用通用分类标准，扩展需备案 |
| 语境缺失 | 所有事实共用一个Context | 按实体、期间、维度组合拆分Context |
| 单位错误 | 元与万元混报 | 统一Unit并检查decimals |
| 版本漂移 | Instance引用旧版Taxonomy | 锁定schemaRef版本，纳入配置管理 |
注意：XBRL校验通过不等于披露合规。计算关系正确、标签完整，仍需人工复核会计口径与附注一致性。工具是放大器，不是替代品。
五、课程学习目标与知识框架
完成本课程后，你应能独立完成：设计或扩展一套分类标准；从业务数据生成合规实例文档；使用Arelle等工具完成校验与排错；理解iXBRL与Formula链接库的高级用法。整体知识框架分为四层：
- 基础层：XML、XLink、命名空间、Schema基础。
- 标准层：XBRL 2.1规范、Taxonomy结构、Linkbase类型。
- 工程层：实例生成、校验、版本管理、自动化流水线。
- 应用层：监管报送、iXBRL、数据分析与跨准则比对。
接下来的章节将按此框架逐层深入。请先在自己的环境中准备好Python、Arelle和一份样例分类标准，后续实操将直接基于它们展开。