Filings と Compare

EDINET surface は 3 段階で使います。

• company filings: filing 一覧を取る
• filing show: 1 filing の facts と sections を読む
• filing compare: 前期比較や比較対象指定を行う

company filings

ここでは次を確認します。

• filing_id
• doc_id
• document_type
• submitted_at
• summary_metrics
• previous_comparable_filing
• artifact_health
• fact_stats

まず比較可能な filing が何かを確認し、そこから detail や compare に進めます。

filing show

1 filing を深掘りするときは次を見ます。

• finance.facts[]
• finance.meta.available_summary_metrics
• filing.artifact_health
• filing.fact_stats
• filing.summary_metrics
• filing.segment_metrics
• sections.items[]
• section_key ごとの metadata

include_section_content=false を使うと、本文を落として軽く探索できます。

EDINET のデータが無いように見える場合は、先に filing.artifact_health.failed_count / pending_count と filing.fact_stats.total_rows / segment_fact_rows を確認してください。IFRS の報告セグメント分析では、raw facts を掘る前に filing.segment_metrics を見ます。

filing compare

compare では次を扱います。

• summary metrics の差分
• section ごとの比較
• previous_comparable_filing の自動解決
• against による比較先の明示指定

差分 status は updated / unchanged / added / removed / unavailable を返します。

典型的な使い方

sf company filings jpx_5574 --limit 5 --json
sf filing show jpx_5574 edinet_fil_xxx --section-key business_risks --json
sf filing compare jpx_5574 edinet_fil_xxx --summary-metric revenue,net_income --json
sf filing show jpx_7203 edinet_fil_S100VWVY --fact-limit 1000 --json

この surface で扱うのは current shipped compare です。永続化された diff object や review queue は current public docs の対象外です。