financial-reporting

財務報告

目的

このスキルは、データを集約し、可視化を作成し、GAAP や IFRS などの基準への準拠を確保することで、財務レポートの生成と分析を可能にします。財務データセットを処理し、レポート作成のための実用的なインサイトを提供します。

使用する場面

四半期財務サマリー、年次監査、コンプライアンスチェック、または損益計算書や貸借対照表のアドホック分析にこのスキルを使用します。会計ソフトウェアと連携する場合や、財務指標の推移を可視化する場合にも適用します。

主な機能

• データ集約：API エンドポイント /api/v1/aggregate?start_date=2023-01-01&end_date=2023-12-31 を介してデータソースからデータを取得し、勘定科目や通貨のフィルターをサポートします。
• 可視化：Matplotlib などのライブラリを使用してチャートを生成します。たとえば、plot_type='pie'&data_source='expenses' で費用の内訳を円グラフにします。
• コンプライアンスツール：compliance_check('GAAP', report_data) で合計値を検証するなど、ルールに照らしてレポートをチェックし、真偽値を返します。
• 分析関数：calculate_ratio('debt_to_equity', balance_sheet_data) などで比率分析を実行し、浮動小数点値を出力します。
• エクスポート形式：JSON、CSV、PDF の出力をサポートします。export_format='PDF'&file_path='/reports/q1.pdf' で設定します。

使用パターン

このスキルを使用するには、Python スクリプトにモジュールをインポートするか、CLI 経由で呼び出します。まず $FINANCIAL_API_KEY で認証してからデータを集約し、その後に分析します。スクリプトでは、エラーに対する耐性を高めるため、呼び出しを try-except ブロックで囲みます。一般的なパターンは、データの取得、処理、可視化、エクスポートです。ワークフローの例：aggregate_data() -> analyze_data() -> generate_report()。

一般的なコマンド/API

• CLI コマンド：openclaw financial-report aggregate --start-date 2023-01-01 --end-date 2023-12-31 --key $FINANCIAL_API_KEY
  • データを集約し、標準出力に出力します。
• API エンドポイント：JSON 本文 {"type": "balance_sheet", "data": {"assets": 100000}} を指定して POST /api/v1/reports/generate を呼び出します。
  • ヘッダー Authorization: Bearer $FINANCIAL_API_KEY が必要です。
• コードスニペット（Python）：

  import openclaw_financial
  api_key = os.environ.get('FINANCIAL_API_KEY')
  report = openclaw_financial.generate_report('income_statement', api_key)
  

• 別のスニペット（分析用）：

  from openclaw_financial import analyze
  result = analyze.calculate_ratio('quick_ratio', {'cash': 50000, 'receivables': 30000, 'liabilities': 100000})
  print(result)  # Outputs: 0.8
  

• 設定形式：設定には JSON を使用します。たとえば、ファイル .financial-config.json に {"api_endpoint": "/api/v1/aggregate", "auth_key": "$FINANCIAL_API_KEY", "default_currency": "USD"} を指定します。

統合に関する注意

コマンドの実行前に、認証用の環境変数 $FINANCIAL_API_KEY を設定して統合します。外部システムの場合は、SDK を使用して接続します。たとえば、Node.js アプリでは、パッケージを読み込み、キーを渡します：const client = new FinancialClient(process.env.FINANCIAL_API_KEY);。データソースに互換性があること（CSV または API 互換など）を確認してください。ウェブアプリでは、サーバー設定にヘッダーを追加して /api/v1/* エンドポイントの CORS を処理します。

エラー処理

認証エラーは、401 応答を確認し、$FINANCIAL_API_KEY の入力を求めて処理します。無効な日付などのデータエラーについては、コード内で ValueError などの例外を捕捉します：try: openclaw_financial.aggregate_data(start_date) except ValueError as e: print(f"Error: {e} - Use YYYY-MM-DD format")。API のタイムアウトには指数バックオフを用いた再試行ロジックを使用します。requests ライブラリで次のように実装します：response = requests.get(url, headers, timeout=10)。デバッグのため、エンドポイントが見つからない場合の 404 など、エラーコードを含む詳細情報とともにすべてのエラーをログに記録します。

具体的な使用例

1. 四半期貸借対照表を生成する：CLI を使用します：openclaw financial-report generate --type balance_sheet --period Q1-2024 --key $FINANCIAL_API_KEY。資産と負債を集約し、監査用の PDF レポートを出力します。
2. 収益の推移を分析する：Python でデータを取得して可視化します：

   import openclaw_financial
   data = openclaw_financial.aggregate_data('earnings', os.environ['FINANCIAL_API_KEY'])
   openclaw_financial.visualize(data, 'line', 'earnings_trend.png')
   

   これにより四半期ごとの収益がプロットされ、成長パターンを特定できます。

グラフの関連性

• 関連スキル：accounting-tools（台帳管理用）、data-visualization（グラフ生成用）
• クラスター：financial（budgeting および forecasting スキルとデータソースを共有します）
• 依存関係：基盤となる機能には data-analysis クラスターが必要です
• 接続：/api/v1/compliance-check などの共有 API エンドポイントを介して compliance-auditing にリンクします