レポート(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
}
]
}