Filing Show / Compare

filing show と filing compare は、どちらも company_id と filing_id を前提に動きます。先に sf company filings <companyId> --json で対象を確認してください。

契約サマリー

filingId には edinet_fil_* の filing_id か EDINET doc_id を使えます。compare は競合 company 同士の比較ではありません。

filing を選ぶ

sf company filings jpx_5574 --limit 10 --json

見る key:

• filings[].filing_id
• filings[].doc_id
• filings[].document_type
• filings[].period_end
• filings[].previous_comparable_filing

previous_comparable_filing が null の場合でも、show は実行できます。compare は --against で比較先を明示します。

filing show

sf filing show jpx_5574 edinet_fil_S100XYUO --json
sf filing show jpx_5574 edinet_fil_S100XYUO \
  --section-key business_risks,strategy \
  --fact-limit 50 \
  --json

主な option:

• --fact-limit <n>
• --fact-offset <n>
• --metric-key <value[,value]>
• --metric-scope <value[,value]>
• --relative-year <value[,value]>
• --section-key <value[,value]>
• --section-content false

まず見る key:

• filing.filing_id
• filing.processing_state
• filing.artifact_health
• filing.fact_stats
• filing.summary_metrics
• filing.segment_metrics
• finance.facts[]
• finance.meta.available_summary_metrics
• finance.meta.returned_facts
• sections.items[]
• sections.meta.returned_sections
• meta.resolved_filing_by

本文が重い場合は --section-content false を付けます。facts が多すぎる場合は、--metric-key, --metric-scope, --relative-year, --fact-limit で絞ります。

有報やセグメント分析では、raw finance.facts[] を読む前に filing.artifact_health.failed_count / pending_count、filing.fact_stats.total_rows / segment_fact_rows、filing.segment_metrics を確認します。artifact が failed / expected のままなら、値が無いと判断せず source refresh / EDINET retry の対象にします。

filing compare

sf filing compare jpx_5574 edinet_fil_S100XYUO --json
sf filing compare jpx_5574 edinet_fil_S100XYUO \
  --summary-metric revenue,net_income \
  --section-key business_risks,strategy \
  --json
sf filing compare jpx_5574 edinet_fil_S100XYUO \
  --against edinet_fil_S100PREV \
  --json

主な option:

• --against <filingId>
• --summary-metric <value[,value]>
• --section-key <value[,value]>
• --section-content false

まず見る key:

• filings.current.filing_id
• filings.against.filing_id
• compare.summary_metrics
• compare.sections
• compare.summary_metrics.<metric>.status
• compare.sections.<section_key>.status
• meta.compared_against
• error.suggested_next_commands

status は updated, unchanged, added, removed, unavailable のどれかです。差分の有無だけを見る場合は、本文より先に status を確認します。

自動比較先が見つからないとき

sf company filings jpx_5574 --limit 10 --json
sf filing compare jpx_5574 edinet_fil_S100XYUO \
  --against edinet_fil_S100PREV \
  --json

compare_target_not_found が返る場合:

1. sf company filings <companyId> --limit 10 --json を実行します。
2. filings[].filing_id, filings[].document_type, filings[].period_end を確認します。
3. 比較したい filing を選び、--against <filingId> を付けて再実行します。

エラーと復旧

filing_not_found が返る場合:

1. sf company filings <companyId> --json に戻ります。
2. filings[].filing_id と filings[].doc_id を確認します。
3. 同じ company 内の filing だけを show / compare に渡してください。

invalid_query が返る場合:

1. --summary-metric, --section-key, --relative-year の値を確認します。
2. sf filing show --help または sf filing compare --help で許可値を確認します。

segment_metrics が空の場合:

1. filing.artifact_health.failed_count と pending_count を確認します。
2. filing.fact_stats.segment_fact_rows を確認します。
3. filing.processing_state が parsed ではない場合は、source refresh / EDINET retry の対象として扱います。
4. annual report 以外を見ていないか、sf company filings <companyId> --limit 20 --json に戻って確認します。

company_not_found が返る場合は、sf companies search <query> --json に戻って company_id を解決します。

次に進む先

• 1 社調査の順番を確認する: Company Research Workflow
• HTTP contract を確認する: 開示詳細 API, 開示比較 API