XBRL事实：选择数字前先匹配上下文

XBRL 概念名称不足以唯一确定研究所需数字。选取或汇总事实前，要匹配主体、期间、单位、维度与申报版本。一个技术上有效的财务标签，可以在多个合理上下文中出现，而每个上下文回答不同经济问题。

从目标观测开始

先用自然语言写清要找什么：某发行人某季度合并收入、采用指定币种、来自指定报告版本，再映射到机器事实。如果先拿接口返回的第一个数字，就把过程倒过来了，研究问题可能跟着记录排序走。

XBRL International 基础说明介绍事实、概念、上下文与维度。SEC API 文档也说明提取服务的覆盖范围。标准化、全主体聚合，不表示原始报告中每个自定义或分部事实都会出现在这些服务中。

假设虚构公司原始申报含几项收入事实，你要的是最新报告的一季度合并收入。表中使用简化描述，不声称是真实申报编号，也不是精确接口响应格式。

事实	期间与范围	数值	对当前问题的角色
A	一至三月、合并、原始报告	40	目标的较早版本
B	一至六月、合并	85	半年值，不是一季度
C	一至三月、单一分部	25	比合并范围窄
D	一至三月、合并、修订报告	42	若修订替代A，才成为候选

将这些数相加，会混合期间、范围与版本。即便选 D，也要检查修订究竟改了什么，不能认为文件日期更晚就替代了所有旧事实。如果研究问题是修订前当时可得信息，A 反而可能是合适的历史观测。

记录概念命名空间与名称、主体标识、起止日期或时点、单位、维度与成员组合，以及来源申报编号。context 标识只是文档内部引用；不同文件使用相同标签，不代表经济内容相同。应比较底层字段，不能只比较方便的名字。

收入等期间指标与期末余额等时点指标要分开。财年不同时，“某年”不能替代实际日期。即使当前只用合并值，也保留来源维度，使排除的分部可追溯，而不是无解释地从结果消失。

发行人可以对特定业务披露使用扩展概念。标签相似不保证与标准概念等价，标准化接口没有某值也不证明业务指标为零。需要的细节缺失或含糊时，回查分类定义和原始报告。

不要为了让同业表更整齐而发明映射。保存未映射概念，以及每个拟议关系的理由。适合某家公司某期间的映射，可能在重组或列报变化后不再适用，应将映射版本与派生数据一起保留。

这里的缺失也可能只是服务覆盖限制，不应与公司未披露混为一谈。先区分接口未返回、原文没有、概念尚未识别和字段不适用，再决定后续核查路径。

抽取部分已选机器事实，回到可见报表及附注核对正负号、单位、期间和会计范围。汇总时只纳入属于同一关系的组成部分，不能把名称中带“收入”的全部记录相加。提取语法可以正确，选择逻辑却依旧在经济上错误。

原值与派生值分别保存，包括每次单位换算。结构化来源减少抄录工作，但不替代判断哪项观测回答问题。最终研究记录要说明选择理由，以及为什么排除其他候选。

不是。先核对期间、版本与信息截止。接口排序不等于研究定义。

不等于。覆盖与分类范围都重要，应回查原始披露，或者保留不可得，不自动补零。