メインコンテンツへ
BlueAI
ホーム/CRM(顧客管理)/レポート

レポート(Reports)

パイプライン別の受注見込み集計、売上予測、ステージ別分布などの営業レポートを取得します。

|

エンドポイント

GET/api/v1/crm/reports/pipeline-summaryパイプラインサマリーを取得
GET/api/v1/crm/reports/forecast売上予測を取得
GET/api/v1/crm/reports/owner-performance担当者別実績を取得
GET/api/v1/crm/reports/pipeline-summary

パイプラインサマリーを取得

ステージ別の案件数・合計金額の分布を返します。営業パイプラインの全体像を把握するために使用します。

認証が必要ですセッション Cookie または Bearer トークンを含めてください

クエリパラメータ

名前必須説明
pipeline_id
string任意パイプライン ID で絞り込み

レスポンスフィールド

名前必須説明
PipelineSummaryRow[]任意ステージ別サマリーの配列

コード例

curl "https://api.blueai.jp/api/v1/crm/reports/pipeline-summary" \
  -H "Cookie: better-auth.session_token=<token>"

レスポンス例

{
  "data": [
    {
      "stage": "lead",
      "deal_count": 15,
      "total_amount": 4500000
    },
    {
      "stage": "qualification",
      "deal_count": 8,
      "total_amount": 3200000
    },
    {
      "stage": "proposal",
      "deal_count": 5,
      "total_amount": 6000000
    },
    {
      "stage": "negotiation",
      "deal_count": 3,
      "total_amount": 4800000
    },
    {
      "stage": "closed_won",
      "deal_count": 10,
      "total_amount": 12000000
    },
    {
      "stage": "closed_lost",
      "deal_count": 4,
      "total_amount": 1600000
    }
  ]
}
GET/api/v1/crm/reports/forecast

売上予測を取得

成約予定日ベースの月次売上予測を返します。指定期間内の月別に案件数と予測金額を集計します。

認証が必要ですセッション Cookie または Bearer トークンを含めてください

クエリパラメータ

名前必須説明
from
string任意開始月(YYYY-MM、必須)
to
string任意終了月(YYYY-MM、必須)

レスポンスフィールド

名前必須説明
ForecastRow[]任意月次予測の配列

コード例

curl "https://api.blueai.jp/api/v1/crm/reports/forecast" \
  -H "Cookie: better-auth.session_token=<token>"

レスポンス例

{
  "data": [
    {
      "month": "2026-01",
      "deal_count": 3,
      "total_amount": 3600000
    },
    {
      "month": "2026-02",
      "deal_count": 5,
      "total_amount": 5800000
    },
    {
      "month": "2026-03",
      "deal_count": 7,
      "total_amount": 8400000
    }
  ]
}
GET/api/v1/crm/reports/owner-performance

担当者別実績を取得

担当者ごとの案件数・受注数・成約率・売上金額を返します。チーム全体のパフォーマンス分析に使用します。

認証が必要ですセッション Cookie または Bearer トークンを含めてください

レスポンスフィールド

名前必須説明
OwnerPerformanceRow[]任意担当者別実績の配列

コード例

curl "https://api.blueai.jp/api/v1/crm/reports/owner-performance" \
  -H "Cookie: better-auth.session_token=<token>"

レスポンス例

{
  "data": [
    {
      "assigned_member_id": "usr_99999999999999999999999999999999",
      "assigned_member_name": "山田太郎",
      "deal_count": 12,
      "won_count": 5,
      "total_amount": 9600000,
      "won_amount": 6000000
    },
    {
      "assigned_member_id": "usr_88888888888888888888888888888888",
      "assigned_member_name": "佐藤花子",
      "deal_count": 8,
      "won_count": 3,
      "total_amount": 7200000,
      "won_amount": 4500000
    },
    {
      "assigned_member_id": null,
      "assigned_member_name": null,
      "deal_count": 3,
      "won_count": 0,
      "total_amount": 900000,
      "won_amount": 0
    }
  ]
}