从 XBRL 文档中获取特定值

我一直在使用Gepsio https://github.com/JeffFerguson/gepsio尝试通过他们的 EDGAR 系统翻阅标准 SEC XBRL 文件，尽管我多次尝试解决这一问题，但似乎我还是不知所措。

当您从任何文档中提取事实，并且您有兴趣检索“收入”时，根据特定的 US-GAAP 标准，可能有多达 200 个事实及其关联的收入标签。虽然每个 ID 都是唯一的，但弄清楚哪个 ID 相当于您想要的特定收入类型似乎并不是很简单。我感兴趣的收入与合并运营报表中显示的收入相同，即净收入，而不是文件中一些模糊的其他类型的收入。然而，XBRL 观众喜欢Arelle http://arelle.org/download/每次都正确，尽管浏览了 Arelle 的源代码，我也无法弄清楚他们使用的逻辑。

任何能够引导我理解这一点的正确方向的人将不胜感激。

你需要找到具有正确概念、时期和实体的事实。

• 找到这个概念并不像听起来那么简单。虽然理论上应该是us-gaap:Revenues，许多申报者不使用该概念，而是“滥用”另一个美国公认会计原则概念，或者（在最坏的情况下）在自己的命名空间中创建自己的概念。查尔斯·霍夫曼 (Charles Hoffman) 花费了大量时间对此进行投资并设计报告框架 http://www.xbrlsite.com/2015/fro/us-gaap/html/ReportFrames/解决此问题并允许跨文件管理器进行比较。报告框架包括映射，例如this one http://www.xbrlsite.com/2015/fro/us-gaap/html/ReportFrames/COMID-BSC-CF1-IS3-IEMIB-OILN/mapping-definition.html你可以看到有不少于 77 个不同的概念（us-gaap:Revenues, us-gaap:SalesRevenueNet, ...) 用于报告收入。查理的方法是选择列表中第一个被报告的。对于某些概念（我认为收入不会发生这种情况），事实甚至可能没有得到明确报告，因此需要计算。一些 XBRL 供应商已与 Charlie 合作，并将此报告框架功能集成到他们的产品中。

• 实体是最简单的，因为在绝大多数情况下（甚至可能是强制性的，但我找不到这方面的说明），文件中的所有事实都共享同一个实体。对于 SEC 备案，它是公司的 CIK（具有 CIK 计划）。话虽如此，在 SEC 的文件中，还有一个额外的维度（dei:LegalEntityAxis），您必须检查该选项是否不存在或设置为其默认值以过滤掉任何子公司。

• 时期比较复杂一些。为此，您需要找到报道的另一个事实dei:DocumentPeriodEndDate这为您提供了报告结束的期间，即资产负债表日期。使用此日期，您可以筛选候选事实并选择在该日期结束且持续时间为一年、一个或几个季度的事实。

• 还可以报告特定场景或分支机构的收入。在这种情况下，只需过滤掉具有任何进一步维度的事实即可。

通常，如果您根据上述所有内容（概念、实体、时期、额外维度）过滤事实，您应该只留下一项，因为冲突非常罕见，而且常常是错误。

寻找概念的另一种不同方法是查看每个文件中的网络 https://stackoverflow.com/questions/43543151/arelle-webserver-how-to-extract-the-income-statement-from-an-xbrl-filing以编程方式查找您提到的合并操作的语句，但这也不是微不足道的，因为标签可能会有所不同。然后，您也许能够推断出收入概念，并且（缺乏）定义网络将确保维度（如果有）正确。这可能就是阿雷尔找到它的方式。