> 継続的なプロセス改善 > リードから入金まで > SAP Sales Cloud > データテンプレート

リードから入金までのデータテンプレート

SAP Sales Cloud

リードから入金までの属性 (17) リードから入金までのアクティビティ (15) 抽出ガイド (2)

リードから入金までのデータテンプレート

このテンプレートでは、リードから入金までのプロセスを分析するために必要なデータを収集する方法を体系的に説明します。詳細なイベントログを作成するために必要な属性とアクティビティを示し、SAP Sales Cloudからデータを抽出する方法も案内します。プロセスマイニングを始めるための準備をスムーズに進められます。

収集を推奨する属性
追跡する主要アクティビティ
SAP Sales Cloudからの抽出方法

イベントログを初めて扱いますか。学ぶプロセスマイニングのイベントログを作成する方法.

テンプレートをダウンロード

リードから入金までの属性

SAP Sales Cloudのリードから入金までのプロセスを詳細に分析するため、イベントログに含めることを推奨するデータ項目です。

3 必須 6 推奨 8 任意

	名前	説明
	アクティビティ名 ActivityName	プロセス内の特定の時点で発生した業務アクティビティまたはイベントの名称です。
説明アクティビティ名は、リードから入金までのプロセスにおける特定のステップまたはイベントを示します。たとえば、「リード評価完了」、「見積作成」、「入金確認」などです。これらのイベントが、各営業商談のプロセスフローを構成する一連のアクションになります。これらのアクティビティの分析は、プロセスマイニングの中心です。プロセスマップの可視化、ステップ間のボトルネックの特定、さまざまなプロセス経路の発生頻度の測定が可能になり、営業プロセスが実際にどのように実行されているかを明らかにできます。重要な理由プロセスマップ上のステップを定義する属性であり、プロセスフローの可視化と分析に欠かせません。入手先 SAP Sales Cloudのトランザクションログに記録された、ビジネスオブジェクトのステータス変更、文書作成イベント、特定のユーザー操作などから生成されます。例リードを獲得営業案件を作成顧客に見積書を送付入金を確認
	イベント時刻 EventTime	特定のアクティビティまたはイベントが発生した日時を示すタイムスタンプです。
説明イベント時刻には、アクティビティが完了した正確な日時が記録されます。この時系列データは、プロセスステップの実行時点と所要時間を把握するために欠かせません。プロセスフローを構築するために必要なイベントの時系列も提供します。プロセス分析では、タイムスタンプを使ってアクティビティ間のサイクルタイムや営業プロセス全体の所要時間を計算し、遅延やボトルネックを特定します。時間の経過に沿ってタイムスタンプを分析すれば、プロセスパフォーマンスの傾向も把握できます。重要な理由イベントを時系列に並べるために欠かせないタイムスタンプです。サイクルタイムの計算やボトルネックの特定など、時間に基づくすべての分析で使用します。入手先通常、SAP Sales CloudのLead、Opportunity、Quote、Sales Orderなどのビジネスオブジェクトに関連付けられた「Creation Date」または「Last Changed Date」フィールドに記録されています。例 2023-04-15T10:30:00Z2023-05-02T14:00:00Z2023-06-20T09:15:00Z
	営業商談 SalesOpportunityId	営業商談を一意に識別する識別子であり、リードから入金までのプロセスにおける主要なケース識別子です。
説明営業商談IDは、リードとして始まった段階から、受注または失注として最終的に確定するまで、各見込み案件を一意に識別します。リードの評価、見積作成、受注処理、入金など、関連するすべてのアクティビティをつなぐ中心的な識別子です。プロセスマイニング分析では、このIDを使って各商談のエンドツーエンドの進行を再構成できます。すべてのイベントを関連付けられるため、商談ごとにプロセスのバリアント、サイクルタイム、コンバージョン率を分析できます。重要な理由プロセス内のすべてのアクティビティを関連付ける必須のケースIDです。各営業商談のライフサイクル全体を追跡できます。入手先 SAP Sales CloudにおけるOpportunityビジネスオブジェクトの主キーです。例 OP-8000123456OP-8000123457OP-8000123458
	リードソース LeadSource	最初のリードを獲得したマーケティングチャネルまたは発生元です。
説明リードソースは、見込み顧客を最初に特定した経路を示します。たとえば、Webフォーム、展示会、パートナーからの紹介などです。通常、リードの作成時に記録されます。この属性は、「ソース別リードコンバージョン率」ダッシュボードに欠かせません。この軸を分析すると、マーケティングと営業のチームは、最も価値の高いリードを生み出すチャネルを把握し、リソース配分やマーケティングキャンペーンを改善できます。重要な理由さまざまなマーケティングチャネルの効果を測定し、リード獲得戦略を改善するために欠かせません。入手先 SAP Sales CloudのLeadおよびOpportunityビジネスオブジェクトにあります。フィールド名は「Source」または「Origin」であることが一般的です。例ウェビナーパートナー紹介展示会Webサイトからの問い合わせ
	割引率 DiscountPercentage	営業見積または受注に適用された割引率です。
説明通常、見積または受注の段階で商談に適用された全体の割引率を記録する属性です。定価に対する割合で表します。財務パフォーマンスと営業規律を分析するための重要な指標です。「割引分布」ダッシュボードでは、この属性を使って営業担当者や商品ごとの値引き行動を監視します。また、「割引承認コンプライアンス」KPIにも使用し、大幅な値引きが適切な承認ワークフローに従っているかを確認します。重要な理由価格戦略、営業チームの値引き行動、収益性への影響を分析するうえで重要です。入手先 SAP Sales Cloudの関連するSales QuoteまたはSales Orderビジネスオブジェクトにある価格要素から計算されます。例 0.050.100.25
	受注金額 SalesOrderAmount	商談に関連付けられた受注の合計金額です。
説明商談が受注に至り、Sales Orderが作成された時点で販売される商品またはサービスの合計金額を表す属性です。営業プロセスを成功裏に完了して得られる売上を示します。受注金額は、分析における重要な財務軸です。商談を規模別（小規模、中規模、大規模など）に分類し、プロセスの動きに違いがあるかを確認できます。また、受注した商談と失注した商談の合計金額を示すことで、受注率などのKPIに金額の観点を加えられます。重要な理由プロセスに財務面の軸を加え、営業サイクルと結果を金額別に分析できます。入手先 SAP Sales Cloudの関連するSales Orderビジネスオブジェクトにある「Total Net Value」フィールドから取得します。例 50000.00125000.507800.00
	商品カテゴリ ProductCategory	商談で販売される商品またはサービスのカテゴリです。
説明商品カテゴリは、商談に含まれる個別の商品やサービスを、「ハードウェア」、「ソフトウェア」、「コンサルティングサービス」などの大きな分類にまとめます。個別の商品が多数ある場合でも、分析しやすくなります。商品カテゴリ別の分析は、提供内容の種類によって営業プロセスがどのように異なるかを把握するうえで欠かせません。「割引分布」や「受注処理効率」などのダッシュボードで使用し、特定のカテゴリで割引率が高いか、納品までの時間が長いかを確認できます。重要な理由販売する商品またはサービスの種類に応じたプロセスの違いを分析できます。種類によって営業サイクルが大きく異なる場合があります。入手先 SAP Sales CloudのSales QuoteまたはSales Orderの明細に関連付けられた商品マスターデータから生成されます。例ソフトウェアライセンスハードウェアプロフェッショナルサービスサポートサブスクリプション
	商談ステータス OpportunityStatus	「Open」、「Won」、「Lost」など、営業商談の現在の状態または結果です。
説明この属性は、特定時点における営業商談全体のステータスを示します。商談が進行中なのか、受注に至ったのか、競合他社やその他の理由で失注したのかを表します。最終ステータスの分析は、商談受注率などの主要KPIを計算するうえで基本となります。また、成功した経路だけに絞り込んだり、失注につながりやすいプロセスパターンを調査したりできます。重要な理由ケースの結果を定義します。受注率・失注率の計算や、成功した商談と成功しなかった商談のプロセス経路を分析するうえで重要です。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトにある「Status」フィールドです。例オープン処理中受注失注停止
	営業担当者 SalesRepresentative	営業商談の管理を担当する従業員です。
説明リードまたは商談の担当者であるユーザーまたは従業員を示す属性です。多くの場合、顧客との主な窓口となり、営業パイプラインに沿って商談を進める責任を担います。分析では、営業担当者がパフォーマンス比較の重要な軸になります。担当者、チーム、地域ごとに営業サイクル、受注率、プロセス遵守状況を評価できるため、成果の高い担当者やコーチングが必要な領域を特定できます。重要な理由従業員ごとのパフォーマンス分析が可能になり、営業担当者に対するコーチングの機会やベストプラクティスを特定できます。入手先 SAP Sales CloudのOpportunityまたはLeadビジネスオブジェクトにおける「Owner」または「Employee Responsible」の担当者ロールに関連付けられています。例 John SmithMaria GarciaChen Wei
	ソースシステム SourceSystem	データの取得元となるシステムを識別します。
説明イベントデータが生成されたソースアプリケーションを示す属性です。このプロセスでは通常「SAP Sales Cloud」ですが、リード獲得に使うマーケティングオートメーションプラットフォームなど、ほかの連携システムが含まれる場合もあります。複数のシステムで構成された環境では、データの系譜を把握し、データ連携の問題を調査するうえで重要な属性です。各情報の取得元を明確にしたうえで分析できるようになります。重要な理由連携環境におけるデータの取得元を区別し、分析時にデータの系譜と文脈を明確にします。入手先通常、レコードの取得元を示すために、データ抽出時に追加される固定値です。例 SAP Sales CloudSAP C4CSSC_PROD_100
	最終データ更新日時 LastDataUpdate	ソースシステムからデータが最後に抽出または更新された日時を示すタイムスタンプです。
説明イベントログのデータが最後に更新された日時を示す属性です。分析対象データの鮮度を把握するための文脈を提供し、分析結果の妥当性を判断するうえで役立ちます。プロセス分析では、データがいつ更新されたかを把握することが欠かせません。分析結果が現在の業務を反映しているのか、過去の期間を反映しているのかを関係者が判断できるため、分析に基づく意思決定にも影響します。重要な理由データの鮮度に関する重要な文脈を提供し、最新の情報に基づいて分析と意思決定を行えるようにします。入手先データの抽出および変換（ETL）処理中に追加されるメタデータのタイムスタンプです。例 2024-07-20T02:00:00Z2024-07-21T02:00:00Z
	営業組織 SalesOrganization	販売を担当する組織単位です。
説明営業組織は、販売取引を担当する企業内の特定の部門、事業部、またはチームを表します。SAPにおける企業構造の重要な要素です。この属性を使うと、事業のさまざまな部門に分けて分析できます。事業部門や営業部門ごとにプロセスパフォーマンス、受注率、サイクルタイムを比較し、組織全体の効率を把握できます。重要な理由異なる事業部門や社内部門を横断したパフォーマンス比較とプロセス分析が可能になります。入手先 SAP Sales CloudのOpportunityまたはSales Orderにおける主要な組織割り当てフィールドです。例 US01DE01法人営業：北部
	地域 Region	顧客または営業チームが所在する地理的な地域です。
説明地域は、営業商談に割り当てられた地理的な範囲を表します。通常は顧客の所在地や営業組織の構成に基づき、国、州、または独自に定義した営業テリトリーなどが該当します。セグメント分析における重要な属性です。「商談受注率パフォーマンス」ダッシュボードで直接使用し、地域間のパフォーマンスを比較します。地域ごとのプロセス効率、市場での成果、営業戦略の違いを特定できます。重要な理由営業パフォーマンスを地理的に分析し、受注率、サイクルタイム、プロセス実行における地域差を明らかにします。入手先通常、SAP Sales Cloudで管理される顧客住所または商談に割り当てられた営業組織から生成されます。例北米EMEAAPACLATAM
	手戻りあり IsReworked	アクティビティまたはケースで手戻りが発生したかどうかを示すフラグです。
説明営業受注の作成後に変更が加えられた場合や、見積が複数回修正された場合など、プロセス内に手戻りのループが検出されるとtrueに設定されます。アクティビティの順序を分析して生成されます。この計算属性は、プロセスの非効率を定量化するうえで欠かせません。「営業受注手戻り頻度」ダッシュボードと「営業受注手戻り率」KPIを直接支援し、分析ツールで複雑なパターン照合を行わなくても、手戻りの発生を絞り込み、件数を集計できます。重要な理由手戻りのループがあるケースにフラグを付けることで、プロセスの非効率を直接定量化し、手戻りの頻度と原因を分析しやすくします。入手先ソースシステムには存在しません。アクティビティの繰り返しパターン（例：「Sales Order Created」に続く「Sales Order Reworked」）を検出し、データ変換時に計算されます。例 truefalse
	支払条件 PaymentTerms	「Net 30」や「Net 60」など、合意された支払い条件です。
説明支払条件は、顧客が商品またはサービスの代金を支払う際の条件を定めます。通常、受注または契約の段階で設定され、請求書の支払期日を決定します。「入金回収サイクルタイム」ダッシュボードの重要な分析軸です。支払条件別に分析すると、顧客が合意したスケジュールを守っているか、どの条件で入金サイクルが長くなるか、または短くなるかを確認できます。重要な理由入金回収分析の文脈を提供し、遅延が顧客の行動によるものか、緩やかな支払条件によるものかを判断できます。入手先 SAP Sales CloudのSales Orderまたは顧客マスターデータにあります。例 30日払い60日払い受領時払い
	配送方法 ShippingMethod	商品を顧客に届けるために使用する方法です。
説明注文の物流または配送方法を示す属性です。「陸上輸送」、「航空貨物」、「デジタル配送」などが該当します。物理的な商品を扱うプロセスで使用します。「受注処理効率」ダッシュボードでは、この属性を使って配送方法ごとの納品時間を分析できます。特定の物流チャネルにおける非効率を明らかにしたり、顧客への納期案内をより正確にしたりできます。重要な理由配送チャネル別に納品パフォーマンスを分類し、受注処理におけるボトルネックの診断に役立ちます。入手先通常、SAP Sales CloudのSales Orderビジネスオブジェクトにおける明細レベルまたはヘッダーレベルにあります。例陸上輸送翌日航空便デジタルダウンロード貨物輸送
	顧客名 CustomerName	営業商談に関連付けられた企業または個人の名称です。
説明営業案件の見込み顧客を示す属性です。システム内の特定のアカウントに営業プロセスを関連付けます。顧客別に分析すると、顧客を中心とした営業プロセスの見方が可能になります。営業サイクルが最も長い顧客や、手戻りが多い顧客を特定できるほか、顧客別の「入金回収サイクルタイム」などのKPIにも欠かせません。重要な理由顧客を中心とした分析が可能になり、特定のアカウントにおける営業サイクルや入金行動のパターンを特定できます。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトにおける「Account」または「Prospect」の担当者ロールに関連付けられています。例 Global Tech Inc.Innovate Solutions Ltd.Dynamic Corp

必須推奨任意

リードから入金までのアクティビティ

リードから入金までのプロセスを正確にディスカバリーし、分析するため、イベントログに記録すべき主要なプロセス手順とマイルストーンです。

7 推奨 8 任意

	アクティビティ	説明
	入金を確認	顧客からの入金が受領され、処理されたことを確認し、財務取引が完了したことを示します。この情報はほぼ常に外部の財務システムまたはERPから取得され、SAP Sales Cloudの請求書または受注のステータスを更新します。
重要な理由受注から入金までのプロセスで、価値を実現する最後のステップです。請求書発行から入金までの「Payment Collection Cycle Time」を測定することは、キャッシュフローの管理と売掛金業務の評価における重要なKPIです。入手先 InvoiceまたはSales Orderオブジェクトのステータスが「Paid」または「Cleared」に変更されたことから推定します。このデータは外部の財務システムから取得します。取得 Invoiceのステータスが「Paid」または「Cleared」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	受注を作成	正式な受注が作成されたことを示します。受注処理と請求を開始する社内の正式な文書であり、ユーザーがSales Orderオブジェクトを作成して親営業案件に関連付けた時点で明示的に記録されます。
重要な理由営業から業務部門へ引き継ぐ重要なポイントです。「Opportunity Won」から「Sales Order Created」までの期間を分析すると社内の遅延を把握でき、この時点以降の手戻りを追跡するとデータ品質の問題を特定できます。入手先このイベントは、Opportunityに関連付けられたSales Orderビジネスオブジェクトの作成タイムスタンプに対応します。取得関連するSales Orderレコードの作成日時を使用します。イベントタイプ explicit
	営業案件を作成	評価済みのリードが具体的な営業活動へ移行し、営業案件が正式に開始されたことを示します。Opportunityビジネスオブジェクトが作成された時点でシステムに明示的に記録され、元のリードのデータが引き継がれることもあります。
重要な理由営業サイクル分析の主な起点となる基本的なアクティビティです。案件が具体化した時点から、営業サイクルの期間、成約率、営業チームの成果を測定できます。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトの作成タイムスタンプに対応します。取得 Opportunityレコードの作成日時を使用します。イベントタイプ explicit
	営業案件を失注	競合他社に案件を奪われた、または顧客が購入しないことを決めたなど、営業案件が失注して明確に終了したことを示します。ユーザーがOpportunityのステータスを「Lost」または「Closed Lost」に変更した時点で記録されます。
重要な理由営業案件をいつ、なぜ失注したかを分析することは、営業戦略の改善に欠かせません。失注時点を終点として、平均的にどのステージで離脱するか、失注理由として何が多いかなどを分析できます。入手先 Opportunityビジネスオブジェクトのステータス変更履歴から推定します。ステータスが「Lost」または「Closed Lost」に更新された時点のタイムスタンプです。取得 Opportunityオブジェクトのステータスが「Lost」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	営業案件を成約	案件が無事に成約し、組織が受注を確保したことを示します。ユーザーがOpportunityのステータスを「Won」に変更した時点で記録される、標準的で明示的な操作です。
重要な理由成約率と営業成果を測定する重要なマイルストーンです。多くの場合、受注作成や受注処理などの後続プロセスを開始するきっかけとなり、受注から入金までのサイクルにおける重要な移行点になります。入手先 Opportunityビジネスオブジェクトのステータス変更履歴から推定します。ステータスが「Won」に更新された時点のタイムスタンプです。取得 Opportunityオブジェクトのステータスが「Won」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	営業案件を成約済みにする	受注作成や受注処理などの後続アクティビティが完了した後、成功した営業案件に設定される最終ステータスです。ユーザーがOpportunityのステータスを最終的な「Closed」に変更し、理由として「Won」を指定した時点で記録されます。
重要な理由プロセスマイニング分析における成功時の終点となり、成約案件のエンドツーエンドの営業サイクル期間を算出できます。プロセスの終了を明確に確定できます。入手先 Opportunityオブジェクトのステータス変更履歴から推定します。ステータスが「Closed」に更新され、理由が「Won」となった時点のタイムスタンプです。取得ステータスが「Closed」に変更され、理由コードが「Won」となったタイムスタンプを特定します。イベントタイプ inferred
	顧客に見積書を送付	正式な見積書を顧客に提出し、確認を依頼した時点を示します。通常は、Sales Quoteオブジェクトのステータスが「In Preparation」から「Sent」または「Proposed」などに変更されたことから推定します。
重要な理由顧客との交渉と意思決定にかかる時間の計測を開始する重要なマイルストーンです。このイベントから見積承諾までの期間を分析することで、案件の進行速度と交渉上のボトルネックを把握できます。入手先 Sales Quoteビジネスオブジェクトのステータス変更履歴から推定します。送付済みを示す値にステータスが更新されたタイムスタンプを確認します。取得 Sales Quoteオブジェクトのステータスが「Sent」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	ソリューションを提案	見込み顧客にソリューションまたは製品構成を提示したことを示します。通常は、Opportunityオブジェクトの営業ステージまたはステータスが「Proposal」や「Solution Design」などに変更されたことから推定します。
重要な理由このステージにかかった時間と見積もり段階への移行を分析すると、ソリューション検討プロセスのボトルネックを特定できます。最初の接点から具体的な提案に至るまでの期間を把握できます。入手先 Opportunityオブジェクトの変更ログまたはステータス履歴から推定します。営業ステージが「Solution Proposed」や「Value Proposition」などに更新された時点を確認します。取得 Opportunityの営業ステージ項目が提案を示す値に変更されたタイムスタンプを特定します。イベントタイプ inferred
	リードを獲得	このアクティビティは、SAP Sales Cloudでリードレコードが最初に作成されたことを示します。見込み顧客からの最初の接点または関心を表し、通常はWebフォーム、リストのインポート、またはユーザーによる手動入力から自動的に記録されます。
重要な理由このイベントを追跡することは、リードソースごとの効果を分析し、リード獲得量全体を測定するうえで重要です。リードのコンバージョン率を算出し、営業ファネルの上流を把握する際の起点になります。入手先このイベントは、Leadビジネスオブジェクトの作成タイムスタンプから取得します。リードのソースは通常、同じオブジェクトの属性として記録されています。取得 Leadレコードの作成日時を使用します。イベントタイプ explicit
	リードを評価済みにする	リードの評価が完了し、有望な営業見込み客とみなす基準を満たした時点を示します。通常は、ユーザーがLeadのステータスを「Qualified」または同等の状態に手動で変更した時点で記録され、コンバージョンの準備が整ったことを意味します。
重要な理由このアクティビティにより、未評価のリードと有望な見込み客を分け、評価プロセスの効率を分析できます。さまざまなソースから得たリードの質を判断し、リード獲得から営業活動開始までのボトルネックを特定するのに役立ちます。入手先 Leadビジネスオブジェクトのステータス変更履歴から推定します。ステータス項目が「Qualified」に更新されたタイムスタンプを確認します。取得 Leadオブジェクトでステータスが「Qualified」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	受注を変更	提出済みの受注に対して変更または訂正が行われたことを示します。たとえば、受注ステータスが「Submitted」から「In Process」または「Pending Revision」に戻るなど、ステータスのループを検出して推定します。
重要な理由手戻りを特定することは、プロセスの非効率、入力ミス、営業と業務部門間のコミュニケーション不足を明らかにするうえで重要です。手戻りの頻度が高い場合は、遅延やコスト増加につながる品質問題があることを示します。入手先 Sales Orderオブジェクトのステータス変更履歴から推定します。ステータスが後戻りする動きやループを特定するため、変更の順序を分析します。取得「Submitted」から「In Process」への変更など、ループを示すステータス遷移を検出します。イベントタイプ inferred
	受注処理を完了	製品が顧客に出荷された、またはサービスが提供されたことを示します。多くの場合、ERPまたは物流システムとの連携によって取得され、SAP Sales CloudのSales Orderのステータスが更新されます。
重要な理由納品工程が完了したことを示します。「Sales Order Created」から「Order Fulfilled」までの期間を測定することは、受注処理の効率と顧客満足度への影響を監視するうえで重要です。入手先通常は、Sales Orderオブジェクトのステータスが「Fulfilled」や「Shipped」などに変更されたことから推定します。このステータスは、外部システムとの連携によって更新されることがよくあります。取得 Sales Orderのステータスが「Fulfilled」または「Delivered」に変更されたタイムスタンプを特定します。イベントタイプ inferred
	見積書を作成	営業案件に関連付けられた正式な営業見積書が作成されたことを示します。顧客に見積書を送付する前の社内ステップであり、ユーザーが新しいQuoteレコードを生成した時点で明示的に記録されます。
重要な理由このアクティビティにより、社内での準備時間と顧客が見積書を受け取ってからの時間を分けて分析できます。見積書作成プロセスの効率や、営業担当者が価格を準備するまでの期間を把握するのに役立ちます。入手先このイベントは、Opportunityに関連付けられたSales Quoteビジネスオブジェクトの作成タイムスタンプです。取得関連するSales Quoteレコードの作成日時を使用します。イベントタイプ explicit
	請求書を発行	顧客向け請求書が作成され、プロセスの最終的な財務段階が始まったことを示します。SAP Sales Cloud内のInvoiceオブジェクトの作成から取得する場合もありますが、通常は連携された請求システムから取得します。
重要な理由入金サイクルを開始するきっかけとなるアクティビティです。請求書の発行が遅れるとキャッシュフローに直接影響するため、受注処理完了から請求書発行までの期間を監視することが財務の健全性に欠かせません。入手先 Sales Orderに関連付けられたInvoiceビジネスオブジェクトの作成タイムスタンプ、または外部ERPからの更新を使用できます。取得元はシステム構成によって異なります。取得 Invoiceレコードの作成日、または連携されたERPのアクティビティログエントリを使用します。イベントタイプ explicit
	顧客が見積書を承諾	顧客が見積条件に正式または非公式に同意したことを示します。通常は、営業担当者がSales QuoteまたはOpportunityオブジェクトのステータスを手動で更新して記録します。
重要な理由購入意向を示す強いシグナルであり、契約締結や受注作成前の重要なマイルストーンです。提案の効果や、顧客の意思決定にかかる期間を測定できます。入手先 Sales Quoteオブジェクトのステータスが「Accepted」に変更されたこと、または関連するOpportunityオブジェクトで同様のステータス変更が行われたことから推定します。取得 Sales Quoteのステータスが「Accepted」に変更されたタイムスタンプを特定します。イベントタイプ inferred

推奨任意

抽出ガイド

SAP Sales Cloudからデータを取得する方法

ステップ

前提条件：SAP Sales Cloudで、Analyticsワークセンターにアクセスでき、データソースとレポートの作成・編集権限を持つユーザーを用意します。
統合データソースを作成：Business Analyticsワークセンター内のDesign Data Sourcesビューに移動します。新しいCombined Data Sourceを作成します。すべての商談を取得できるよう、次の標準データソースを左外部結合で結合します：Lead Information → Opportunity Header and Item → Sales Quote Header and Item → Sales Order Header and Item。結合条件は通常、Opportunity IDまたは後続文書IDに基づきます。
カスタムレポートを作成：Design Reportsビューに移動します。前の手順で作成した統合データソースに基づいて、新しいレポートを作成します。レポートビューに必要なすべての特性とキー数値を追加します。リードID、Opportunity IDなどの識別子、関連するすべてのステータスフィールド、作成日やステータス変更日などのタイムスタンプフィールドを含めます。営業担当者、リードソース、受注金額などの必要な属性も追加します。
レポートをODataサービスとして公開：Design Reportsビューで新しく作成したレポートを選択します。レポートの設定で、レポートをODataクエリとして公開するオプションを探します。通常はEnable for ODataというチェックボックスです。変更を保存すると、このレポート固有のOData URLが生成されます。
OData URLを確認：AdministratorワークセンターのOData Servicesビューに移動します。一覧からカスタムレポートを探し、サービスURLをコピーします。Pythonスクリプトで使用します。
Python環境を設定：Pythonとrequestsおよびpandasライブラリをインストールします。次のpipコマンドでインストールできます：pip install requests pandas。
Pythonスクリプトを設定：提供されたPythonスクリプトをコピーします。C4C_TENANT_URL、OData_SERVICE_PATH、USERNAME、PASSWORDのプレースホルダーを、SAP Sales Cloudの認証情報と前の手順で取得したOData URLに置き換えます。
抽出スクリプトを実行：Pythonスクリプトを実行します。スクリプトはOData APIで認証し、大量のデータを処理できるようページ単位でデータを取得し、pandas DataFrameに読み込みます。
データを変換：スクリプトは、横持ち形式のデータ（商談ごとに1行）を縦持ち形式のイベントログに自動変換します。各候補アクティビティを順に確認し、有効なタイムスタンプがあるかを判定します。タイムスタンプが存在する場合は、対応するActivityNameを持つイベントレコードを作成します。
イベントログをエクスポート：スクリプトが完了すると、最終的なイベントログが同じディレクトリにlead_to_cash_event_log.csvファイルとして保存されます。このファイルは、プロセスマイニングツールへ直接アップロードできる形式です。

設定

データソースの設定：この方法の中心となるのは、SAP Sales Cloud AnalyticsのCombined Data Sourceです。QuoteやOrderに至らなかった商談も取得できるよう、Opportunityオブジェクトを起点にLeft Outer Joinsを使用することが重要です。
レポートの特性：カスタムレポートには、対象アクティビティに対応するすべての日付・時刻フィールドを含める必要があります。リード、商談、見積、受注の作成タイムスタンプに加え、ステータス変更のタイムスタンプも含めます。
OData APIのフィルタリング：パフォーマンスとデータ量を管理するため、Pythonスクリプト内のOData URLで$filterパラメーターを使用します。たとえばOpportunityCreationDateで日付範囲を指定することを強く推奨します。初回分析では、通常6～12か月の期間を指定します。
ページネーション：提供されたスクリプトは、$topおよび$skipパラメーターを使ってODataのページネーションを処理します。API接続がタイムアウトすることなく、大規模なデータセットを抽出するために欠かせません。
前提条件：この方法では、OData APIとリード、商談、見積、受注の基盤データソースにアクセスする権限を持つ専用の分析ユーザーが必要です。

a サンプルクエリ python

import requests
import pandas as pd
import numpy as np

class=class="hl-string">"hl-comment"># --- Configuration Placeholders ---
C4C_TENANT_URL = class="hl-string">"[Your SAP Sales Cloud Tenant URL, e.g., my123456.crm.ondemand.com]"
class=class="hl-string">"hl-comment"># The service path comes from the OData Services view for your custom report
ODATA_SERVICE_PATH = class="hl-string">"/sap/c4c/odata/analytics/ds/CUST_REPORT_ID.svc"
USERNAME = class="hl-string">"[Your_Username]"
PASSWORD = class="hl-string">"[Your_Password]"

class=class="hl-string">"hl-comment"># --- OData Service Details ---
class=class="hl-string">"hl-comment"># The entity set is usually the report ID followed by class="hl-string">'ResultSet'
ENTITY_SET = class="hl-string">"CUST_REPORT_IDResultSet"
BASE_API_URL = fclass="hl-string">"https://{C4C_TENANT_URL}{ODATA_SERVICE_PATH}/{ENTITY_SET}"

class=class="hl-string">"hl-comment"># --- Data Extraction ---
def get_odata_data(api_url, username, password):
    records = []
    page_size = 1000
    skip = 0
    
    class=class="hl-string">"hl-comment"># It is highly recommended to add a date filter for performance
    class=class="hl-string">"hl-comment"># e.g., class="hl-string">"$filter=OpportunityCreationDate ge datetime'2023-01-01T00:00:00'"
    odata_params = {
        class="hl-string">"$format": class="hl-string">"json",
        class="hl-string">"$top": page_size,
        class="hl-string">"$skip": skip,
        class="hl-string">"$inlinecount": class="hl-string">"allpages"
        class=class="hl-string">"hl-comment"># class="hl-string">"$filter": class="hl-string">"[Your OData Filter String]"
    }

    print(class="hl-string">"Starting data extraction from SAP Sales Cloud...")
    while True:
        odata_params[class="hl-string">'$skip'] = skip
        response = requests.get(api_url, auth=(username, password), params=odata_params)
        
        if response.status_code != 200:
            print(fclass="hl-string">"Error: Failed to fetch data. Status code: {response.status_code}")
            print(response.text)
            break

        data = response.json()[class="hl-string">'d']
        if class="hl-string">'results' in data and data[class="hl-string">'results']:
            records.extend(data[class="hl-string">'results'])
            count = len(data[class="hl-string">'results'])
            print(fclass="hl-string">"Fetched {len(records)} records...")
            if count < page_size:
                break
            skip += page_size
        else:
            break
            
    print(class="hl-string">"Extraction complete.")
    return pd.DataFrame(records)

source_df = get_odata_data(BASE_API_URL, USERNAME, PASSWORD)

class=class="hl-string">"hl-comment"># --- Data Transformation ---
if not source_df.empty:
    print(class="hl-string">"Starting data transformation into event log format...")
    
    class=class="hl-string">"hl-comment"># Rename columns for clarity (adjust these based on your report's field names)
    class=class="hl-string">"hl-comment"># These are example API field names from the OData service.
    class=class="hl-string">"hl-comment"># You MUST inspect your OData metadata to get the correct field names.
    column_mapping = {
        class="hl-string">'C_OpportunityId': class="hl-string">'SalesOpportunityId',
        class="hl-string">'LeadCreationDateTime': class="hl-string">'LeadCaptured_Time',
        class="hl-string">'LeadConversionDateTime': class="hl-string">'LeadQualified_Time',
        class="hl-string">'OpportunityCreationDateTime': class="hl-string">'OpportunityCreated_Time',
        class="hl-string">'OpportunityProposalStageDateTime': class="hl-string">'SolutionProposed_Time',
        class="hl-string">'QuoteCreationDateTime': class="hl-string">'QuoteCreated_Time',
        class="hl-string">'QuoteSentToCustomerDateTime': class="hl-string">'QuoteSentToCustomer_Time',
        class="hl-string">'QuoteAcceptedDateTime': class="hl-string">'QuoteAccepted_Time',
        class="hl-string">'OpportunityWonDateTime': class="hl-string">'OpportunityWon_Time',
        class="hl-string">'SalesOrderCreationDateTime': class="hl-string">'SalesOrderCreated_Time',
        class="hl-string">'SalesOrderReworkedDateTime': class="hl-string">'SalesOrderReworked_Time',
        class="hl-string">'SalesOrderFulfilledDateTime': class="hl-string">'OrderFulfilled_Time',
        class="hl-string">'InvoiceGeneratedDateTime': class="hl-string">'InvoiceGenerated_Time',
        class="hl-string">'PaymentReceivedDateTime': class="hl-string">'PaymentReceived_Time',
        class="hl-string">'OpportunityClosedWonDateTime': class="hl-string">'OpportunityClosedWon_Time',
        class="hl-string">'OpportunityClosedLostDateTime': class="hl-string">'OpportunityClosedLost_Time',
        class="hl-string">'SalesRepresentativeName': class="hl-string">'SalesRepresentative',
        class="hl-string">'LeadSourceName': class="hl-string">'LeadSource',
        class="hl-string">'OpportunityStatusName': class="hl-string">'OpportunityStatus',
        class="hl-string">'SalesOrderAmountValue': class="hl-string">'SalesOrderAmount',
        class="hl-string">'ProductCategoryName': class="hl-string">'ProductCategory',
        class="hl-string">'QuoteDiscountPercentage': class="hl-string">'DiscountPercentage'
    }
    source_df.rename(columns=column_mapping, inplace=True)

    class=class="hl-string">"hl-comment"># Convert date strings to datetime objects, coercing errors to NaT (Not a Time)
    date_cols = [col for col in source_df.columns if class="hl-string">'_Time' in col]
    for col in date_cols:
        class=class="hl-string">"hl-comment"># OData date format is /Date(timestamp)/. We need to extract the timestamp.
        source_df[col] = source_df[col].str.extract(rclass="hl-string">'\/Date\((\d+)\)\/').astype(float)
        source_df[col] = pd.to_datetime(source_df[col], unit=class="hl-string">'ms', errors=class="hl-string">'coerce')

    class=class="hl-string">"hl-comment"># Define the activities and their corresponding timestamp columns
    activity_mapping = {
        class="hl-string">'Lead Captured': class="hl-string">'LeadCaptured_Time',
        class="hl-string">'Lead Qualified': class="hl-string">'LeadQualified_Time',
        class="hl-string">'Opportunity Created': class="hl-string">'OpportunityCreated_Time',
        class="hl-string">'Solution Proposed': class="hl-string">'SolutionProposed_Time',
        class="hl-string">'Quote Created': class="hl-string">'QuoteCreated_Time',
        class="hl-string">'Quote Sent to Customer': class="hl-string">'QuoteSentToCustomer_Time',
        class="hl-string">'Quote Accepted by Customer': class="hl-string">'QuoteAccepted_Time',
        class="hl-string">'Opportunity Won': class="hl-string">'OpportunityWon_Time',
        class="hl-string">'Sales Order Created': class="hl-string">'SalesOrderCreated_Time',
        class="hl-string">'Sales Order Reworked': class="hl-string">'SalesOrderReworked_Time',
        class="hl-string">'Order Fulfilled': class="hl-string">'OrderFulfilled_Time',
        class="hl-string">'Invoice Generated': class="hl-string">'InvoiceGenerated_Time',
        class="hl-string">'Payment Received': class="hl-string">'PaymentReceived_Time',
        class="hl-string">'Opportunity Closed Won': class="hl-string">'OpportunityClosedWon_Time',
        class="hl-string">'Opportunity Closed Lost': class="hl-string">'OpportunityClosedLost_Time'
    }

    class=class="hl-string">"hl-comment"># Unpivot the DataFrame into an event log format
    event_log_df = pd.DataFrame()
    for activity, time_col in activity_mapping.items():
        if time_col in source_df.columns:
            temp_df = source_df[[class="hl-string">'SalesOpportunityId'] + [col for col in column_mapping.values() if col in source_df.columns]].copy()
            temp_df = temp_df.dropna(subset=[time_col])
            if not temp_df.empty:
                temp_df[class="hl-string">'ActivityName'] = activity
                temp_df.rename(columns={time_col: class="hl-string">'EventTime'}, inplace=True)
                event_log_df = pd.concat([event_log_df, temp_df])

    class=class="hl-string">"hl-comment"># Select and order final columns
    required_cols = [class="hl-string">'SalesOpportunityId', class="hl-string">'ActivityName', class="hl-string">'EventTime']
    recommended_cols = [class="hl-string">'SalesRepresentative', class="hl-string">'LeadSource', class="hl-string">'OpportunityStatus', class="hl-string">'SalesOrderAmount', class="hl-string">'ProductCategory', class="hl-string">'DiscountPercentage']
    final_cols = required_cols + [col for col in recommended_cols if col in event_log_df.columns]
    
    event_log_df = event_log_df[final_cols]
    event_log_df.sort_values(by=[class="hl-string">'SalesOpportunityId', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># --- Export to CSV ---
    event_log_df.to_csv(class="hl-string">'lead_to_cash_event_log.csv', index=False)
    print(class="hl-string">"Event log saved to 'lead_to_cash_event_log.csv'.")
else:
    print(class="hl-string">"No data extracted. Skipping transformation and export.")

ステップ

SAP Sales Cloudの標準ODataアクセスが、対象のビジネスオブジェクトで有効になっていることを確認します。また、連携ユーザーに、テナントで利用できるOpportunity、Lead、Sales Quote、Sales Order、請求書、支払いまたは履行データへの読み取り権限があることを確認します。ご利用のシステムで使用できるSAP Sales Cloudの管理・連携ツールを利用してください。正確なメニューの場所やオブジェクトサービス名はテナントによって異なるため、ご利用のシステムに合わせて設定します。
必要なビジネスオブジェクトについて、公開されている標準ODataサービス名、エンティティセット、キー項目、ナビゲーションプロパティ、ステータス項目、変更日時、担当者項目、ソース項目、金額項目、製品項目、関係項目を特定します。オブジェクトやプロパティが公開されているとは限りません。設定済みのODataサービスURLで利用できるサービスメタデータ文書から、確認済みのメタデータを記録してください。
Pythonスクリプトで、接続URL、認証情報またはOAuth設定、期間、ページサイズ、会社固有のフィルターを設定します。最初は3～6か月の期間を指定し、性能と完全性を検証した後に延長してください。
確認済みの標準ODataエンティティセットを通じて、OpportunityとLeadのレコードを抽出します。Sales QuoteとSales Orderのレコードも、確認済みのエンティティセットから抽出します。請求書、履行、支払いのレコードは、対応する標準ODataオブジェクトと関係がSAP Sales Cloudで公開されている場合にのみ抽出してください。これらのレコードが連携済みのERPまたは財務システムで管理されている場合は、そのシステムから承認済みの同等のODataフィードを取得し、識別子を商談にマッピングします。
ODataリクエストごとに、サービスの次ページリンクをたどるか、対応するページネーション方式を適用して、すべてのページを取得します。対応している場合は、サーバー側で日付と会社のフィルターを適用します。件数とマッピングを監査できるよう、変換前に生のレスポンスを保存してください。
タイムスタンプを1つのタイムゾーン、できればUTCに統一し、SAPの日付または日時の値を一貫したISO 8601形式に変換します。ステータス値は、空白を削除し、大文字・小文字を区別しない比較を適用して正規化します。可能な場合は、監査用データセットに元のステータス値を保持してください。
必要なアクティビティごとに1行のイベントを作成します。Lead CapturedにはLeadの作成日時、Lead QualifiedにはLeadがQualifiedに到達した日時、Opportunity CreatedにはOpportunityの作成日時、Solution ProposedにはOpportunityが設定済みの提案またはソリューションステージに到達した日時、Quote CreatedにはSales Quoteの作成日時、Quote Sent to Customerには見積がSentまたはProposedになった日時、Quote Accepted by Customerには見積または商談が顧客の承諾を記録した日時、Opportunity WonにはOpportunityがWonになった日時、Sales Order CreatedにはSales Orderの作成日時、Sales Order ReworkedにはSubmittedからIn ProcessまたはPending Revisionへの検出された遷移日時、Order Fulfilledには履行または出荷の完了日時、Invoice Generatedには請求書の作成日時、Payment Receivedには支払いの受領または消込日時、Opportunity Closed Wonには理由がWonである最終的なClosed日時、Opportunity Closed Lostには最終的なLostまたはClosed Lostステータスの日時を使用します。
SalesOpportunityIdをキーとして、外部でイベントを結合します。Lead、Opportunity、Sales Quote、Sales Order、請求書、履行、支払いのレコード間で確認済みの関係項目を使用してください。直接の関係がない場合は、連携または業務プロセスで管理されている承認済みの相互参照を使用します。説明や金額が一致することだけを根拠に、関係を推測しないでください。
ソースとの関係から取得できる場合は、推奨属性をすべてのイベントに設定します。SalesRepresentative、LeadSource、OpportunityStatus、SalesOrderAmount、ProductCategory、DiscountPercentageは関連するソースレコードから引き継ぎ、信頼できる値がソースにない場合はnullを保持してください。
最終イベントログをSalesOpportunityIdとEventTimeの順に並べ替えます。繰り返されたAPIページや再試行によって作成された完全一致の重複行だけを削除します。業務ルールで明示的に許可されていない限り、異なるステータス遷移や同じタイムスタンプを持つイベントを統合しないでください。
15個すべてのアクティビティ名が存在すること、必須項目が空でないこと、タイムスタンプが指定期間内にあるか、関連する過去のイベントとして明示的に記録されていること、関係の結合によって予期しないケースの重複が発生していないことを検証します。SalesOpportunityId、ActivityName、EventTimeという正確な必須列名に加え、利用できる推奨属性を含むUTF-8 CSVまたはProcessMindが対応する別のイベントログ形式でエクスポートします。欠落したイベントをプラットフォームが自動生成することを前提にせず、作成したファイルをProcessMindにアップロードしてください。

設定

ODataサービスの設定： テナントのサービスメタデータで確認できた標準SAP Sales Cloud ODataサービスとエンティティセットだけを使用します。サービス名、エンティティ名、プロパティ名、ナビゲーションパスは、ご利用のシステムに合わせて設定してください。
接続と認証： 承認済みのSAP Sales Cloud URL、認証方式、クライアント認証情報、スコープ、読み取り権限を設定します。SAP Sales Cloudでイベントが公開されていない場合、外部ERP、物流、請求、支払いデータへのアクセスには別途権限が必要です。
期間： 最初は3～6か月を指定します。作成日時やステータスのタイムスタンプが選択したプロセス期間より前になる場合は、短い遡及期間を含めてください。フィルターが作成日時、最終変更日時、ステータス遷移日時、または別の確認済みのタイムスタンプのどれを使用するかを記録します。
必須ケースキー： すべてのイベントをSalesOpportunityIdにマッピングします。承認済みの相互参照で解決できる場合を除き、信頼できる商談との関係がないイベントは出力しないでください。
ステータスマッピング： Qualified、提案またはソリューションステージ、Sent、Proposed、accepted、Won、Closed、Lost、Closed Lost、Submitted、In Process、Pending Revision、履行完了、請求書作成、支払い受領について、テナント固有の正確なマッピングを設定します。ステータスラベルは設定や言語によって異なる場合があります。
フィルター： 会社、組織単位、文書タイプ、営業エリア、ステータス、日付の各フィールドが公開され、その業務上の意味を理解している場合にのみ、確認済みのフィルターを適用します。すべてのSAP Sales Cloudオブジェクトに会社コードや文書タイプが存在するとは限りません。
ページネーションとスロットリング： ODataサービスが対応するページサイズと次ページの仕組みを使用します。一時的なHTTPエラーへの再試行処理を追加し、テナントのレート制限を守り、過度な並列リクエストを避けてください。
変更履歴の要件： ステータスに基づくアクティビティには、タイムスタンプ付きのステータス履歴または変更ログが必要です。現在のステータス項目だけでは、過去のステータスに到達した日時を正確に再構成できません。
外部イベントソース： 受注の履行、請求書の作成、支払いの受領は、連携済みのERP、物流、請求、財務システムで管理されている場合があります。承認済みのシステム間識別子と、ソース固有の抽出ルールを設定してください。
データ品質： 値を取得できない場合はnullを保持します。業務ルールでその制限を明示的に許容していない限り、過去の値の代わりに現在のステータスや現在の担当者を設定しないでください。
前提条件： 抽出をスケジュールする前に、必要なSAP Sales Cloudエディション、APIの利用可否、連携設定、ビジネスオブジェクトの公開状況、テナント権限、外部システムのライセンスを確認してください。

a サンプルクエリ python

import os
import time
from datetime import datetime, timezone
from typing import Any, Dict, Iterable, List, Optional

import pandas as pd
import requests

class=class="hl-string">"hl-comment"># Configure these values for your tenant and approved OData services.
BASE_URL = os.environ.get(class="hl-string">"SAP_SALES_CLOUD_ODATA_BASE_URL", class="hl-string">"[Your SAP Sales Cloud OData base URL]")
USERNAME = os.environ.get(class="hl-string">"SAP_SALES_CLOUD_USERNAME", class="hl-string">"[Your username]")
PASSWORD = os.environ.get(class="hl-string">"SAP_SALES_CLOUD_PASSWORD", class="hl-string">"[Your password]")
START_DATE = os.environ.get(class="hl-string">"EXTRACTION_START_DATE", class="hl-string">"[YYYY-MM-DD]")
END_DATE = os.environ.get(class="hl-string">"EXTRACTION_END_DATE", class="hl-string">"[YYYY-MM-DD]")
OUTPUT_FILE = os.environ.get(class="hl-string">"OUTPUT_FILE", class="hl-string">"lead_to_cash_event_log.csv")
PAGE_SIZE = int(os.environ.get(class="hl-string">"ODATA_PAGE_SIZE", class="hl-string">"500"))

class=class="hl-string">"hl-comment"># Replace each value below with the confirmed standard OData service URL and entity set
class=class="hl-string">"hl-comment"># from the metadata document in your tenant. Do not use an unconfirmed object name.
SERVICES = {
    class="hl-string">"lead": class="hl-string">"[Confirmed Lead OData service URL]",
    class="hl-string">"opportunity": class="hl-string">"[Confirmed Opportunity OData service URL]",
    class="hl-string">"sales_quote": class="hl-string">"[Confirmed Sales Quote OData service URL]",
    class="hl-string">"sales_order": class="hl-string">"[Confirmed Sales Order OData service URL]",
    class="hl-string">"invoice": class="hl-string">"[Confirmed Invoice OData service URL or approved integrated billing service URL]",
    class="hl-string">"fulfillment": class="hl-string">"[Confirmed fulfillment OData service URL or approved integrated logistics service URL]",
    class="hl-string">"payment": class="hl-string">"[Confirmed payment OData service URL or approved integrated financial service URL]",
}

class=class="hl-string">"hl-comment"># Replace property names and relationship paths with names confirmed from service metadata.
FIELDS = {
    class="hl-string">"lead": {
        class="hl-string">"id": class="hl-string">"[Confirmed Lead identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed Lead to Opportunity relationship property]",
        class="hl-string">"created_at": class="hl-string">"[Confirmed Lead creation timestamp property]",
        class="hl-string">"status": class="hl-string">"[Confirmed Lead status property]",
        class="hl-string">"status_changed_at": class="hl-string">"[Confirmed Lead status change timestamp property]",
        class="hl-string">"sales_representative": class="hl-string">"[Confirmed Lead representative property]",
        class="hl-string">"lead_source": class="hl-string">"[Confirmed Lead source property]",
        class="hl-string">"opportunity_status": class="hl-string">"[Confirmed related Opportunity status property or blank]",
        class="hl-string">"sales_order_amount": class="hl-string">"[Confirmed related Sales Order amount property or blank]",
        class="hl-string">"product_category": class="hl-string">"[Confirmed Lead product category property or blank]",
        class="hl-string">"discount_percentage": class="hl-string">"[Confirmed related discount property or blank]",
    },
    class="hl-string">"opportunity": {
        class="hl-string">"id": class="hl-string">"[Confirmed Opportunity identifier property]",
        class="hl-string">"created_at": class="hl-string">"[Confirmed Opportunity creation timestamp property]",
        class="hl-string">"stage": class="hl-string">"[Confirmed Opportunity stage property]",
        class="hl-string">"status": class="hl-string">"[Confirmed Opportunity status property]",
        class="hl-string">"status_changed_at": class="hl-string">"[Confirmed Opportunity status change timestamp property]",
        class="hl-string">"status_reason": class="hl-string">"[Confirmed Opportunity status reason property]",
        class="hl-string">"sales_representative": class="hl-string">"[Confirmed Opportunity representative property]",
        class="hl-string">"lead_source": class="hl-string">"[Confirmed Opportunity lead source property]",
        class="hl-string">"sales_order_amount": class="hl-string">"[Confirmed Opportunity or related Sales Order amount property]",
        class="hl-string">"product_category": class="hl-string">"[Confirmed Opportunity product category property]",
        class="hl-string">"discount_percentage": class="hl-string">"[Confirmed Opportunity or related discount property]",
    },
    class="hl-string">"sales_quote": {
        class="hl-string">"id": class="hl-string">"[Confirmed Sales Quote identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed Sales Quote to Opportunity relationship property]",
        class="hl-string">"created_at": class="hl-string">"[Confirmed Sales Quote creation timestamp property]",
        class="hl-string">"status": class="hl-string">"[Confirmed Sales Quote status property]",
        class="hl-string">"status_changed_at": class="hl-string">"[Confirmed Sales Quote status change timestamp property]",
        class="hl-string">"accepted_at": class="hl-string">"[Confirmed Sales Quote acceptance timestamp property or blank]",
        class="hl-string">"sales_representative": class="hl-string">"[Confirmed Sales Quote representative property]",
        class="hl-string">"sales_order_amount": class="hl-string">"[Confirmed Sales Quote amount property]",
        class="hl-string">"product_category": class="hl-string">"[Confirmed Sales Quote product category property]",
        class="hl-string">"discount_percentage": class="hl-string">"[Confirmed Sales Quote discount property]",
    },
    class="hl-string">"sales_order": {
        class="hl-string">"id": class="hl-string">"[Confirmed Sales Order identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed Sales Order to Opportunity relationship property]",
        class="hl-string">"created_at": class="hl-string">"[Confirmed Sales Order creation timestamp property]",
        class="hl-string">"status": class="hl-string">"[Confirmed Sales Order status property]",
        class="hl-string">"status_changed_at": class="hl-string">"[Confirmed Sales Order status change timestamp property]",
        class="hl-string">"previous_status": class="hl-string">"[Confirmed Sales Order previous status property or status history field]",
        class="hl-string">"sales_order_amount": class="hl-string">"[Confirmed Sales Order amount property]",
        class="hl-string">"product_category": class="hl-string">"[Confirmed Sales Order product category property]",
        class="hl-string">"discount_percentage": class="hl-string">"[Confirmed Sales Order discount property]",
    },
    class="hl-string">"invoice": {
        class="hl-string">"id": class="hl-string">"[Confirmed Invoice identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed Invoice to Opportunity relationship property]",
        class="hl-string">"created_at": class="hl-string">"[Confirmed Invoice creation timestamp property]",
        class="hl-string">"invoice_date": class="hl-string">"[Confirmed Invoice date property]",
    },
    class="hl-string">"fulfillment": {
        class="hl-string">"id": class="hl-string">"[Confirmed fulfillment identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed fulfillment to Opportunity relationship property]",
        class="hl-string">"completed_at": class="hl-string">"[Confirmed fulfillment completion timestamp property]",
        class="hl-string">"status": class="hl-string">"[Confirmed fulfillment status property]",
    },
    class="hl-string">"payment": {
        class="hl-string">"id": class="hl-string">"[Confirmed payment identifier property]",
        class="hl-string">"opportunity_id": class="hl-string">"[Confirmed payment to Opportunity relationship property]",
        class="hl-string">"received_at": class="hl-string">"[Confirmed payment receipt or clearing timestamp property]",
        class="hl-string">"status": class="hl-string">"[Confirmed payment status property]",
    },
}

session = requests.Session()
session.auth = (USERNAME, PASSWORD)
session.headers.update({class="hl-string">"Accept": class="hl-string">"application/json"})


def is_placeholder(value: Any) -> bool:
    return not value or (isinstance(value, str) and value.startswith(class="hl-string">"["))


def parse_time(value: Any) -> Optional[pd.Timestamp]:
    if value is None or value == class="hl-string">"":
        return None
    parsed = pd.to_datetime(value, utc=True, errors=class="hl-string">"coerce")
    if pd.isna(parsed):
        return None
    return parsed


def text(value: Any) -> Optional[str]:
    if value is None:
        return None
    value = str(value).strip()
    return value or None


def get_value(record: Dict[str, Any], property_name: str) -> Any:
    if is_placeholder(property_name):
        return None
    if class="hl-string">"/" in property_name:
        current: Any = record
        for part in property_name.split(class="hl-string">"/"):
            if not isinstance(current, dict):
                return None
            current = current.get(part)
        return current
    return record.get(property_name)


def fetch_all(service_url: str, select_fields: Iterable[str], filter_expression: Optional[str] = None) -> List[Dict[str, Any]]:
    if is_placeholder(service_url):
        return []
    fields = [field for field in select_fields if not is_placeholder(field) and field]
    params: Dict[str, Any] = {class="hl-string">"$top": PAGE_SIZE}
    if fields:
        params[class="hl-string">"$select"] = class="hl-string">",".join(dict.fromkeys(fields))
    if filter_expression:
        params[class="hl-string">"$filter"] = filter_expression
    records: List[Dict[str, Any]] = []
    next_url: Optional[str] = service_url
    first_request = True
    while next_url:
        response = session.get(next_url, params=params if first_request else None, timeout=120)
        response.raise_for_status()
        payload = response.json()
        page = payload.get(class="hl-string">"value", [])
        if not isinstance(page, list):
            raise ValueError(class="hl-string">"The OData response value property is not an array")
        records.extend(page)
        next_url = payload.get(class="hl-string">"@odata.nextLink") or payload.get(class="hl-string">"odata.nextLink")
        first_request = False
        if next_url:
            time.sleep(0.1)
    return records


def common_attributes(record: Dict[str, Any], field_map: Dict[str, str]) -> Dict[str, Any]:
    return {
        class="hl-string">"SalesRepresentative": text(get_value(record, field_map.get(class="hl-string">"sales_representative", class="hl-string">""))),
        class="hl-string">"LeadSource": text(get_value(record, field_map.get(class="hl-string">"lead_source", class="hl-string">""))),
        class="hl-string">"OpportunityStatus": text(get_value(record, field_map.get(class="hl-string">"opportunity_status", class="hl-string">""))) or text(get_value(record, field_map.get(class="hl-string">"status", class="hl-string">""))),
        class="hl-string">"SalesOrderAmount": get_value(record, field_map.get(class="hl-string">"sales_order_amount", class="hl-string">"")),
        class="hl-string">"ProductCategory": text(get_value(record, field_map.get(class="hl-string">"product_category", class="hl-string">""))),
        class="hl-string">"DiscountPercentage": get_value(record, field_map.get(class="hl-string">"discount_percentage", class="hl-string">"")),
    }


def add_event(events: List[Dict[str, Any]], opportunity_id: Any, activity: str, event_time: Any, attributes: Dict[str, Any]) -> None:
    case_id = text(opportunity_id)
    timestamp = parse_time(event_time)
    if not case_id or timestamp is None:
        return
    row = {
        class="hl-string">"SalesOpportunityId": case_id,
        class="hl-string">"ActivityName": activity,
        class="hl-string">"EventTime": timestamp.isoformat(),
    }
    row.update(attributes)
    events.append(row)


start_filter = None if is_placeholder(START_DATE) else START_DATE
end_filter = None if is_placeholder(END_DATE) else END_DATE

def date_filter(field_name: str) -> Optional[str]:
    if is_placeholder(field_name) or not start_filter or not end_filter:
        return None
    return fclass="hl-string">"{field_name} ge '{start_filter}T00:00:00Z' and {field_name} lt '{end_filter}T00:00:00Z'"


lead_fields = list(FIELDS[class="hl-string">"lead"].values())
opportunity_fields = list(FIELDS[class="hl-string">"opportunity"].values())
quote_fields = list(FIELDS[class="hl-string">"sales_quote"].values())
order_fields = list(FIELDS[class="hl-string">"sales_order"].values())
invoice_fields = list(FIELDS[class="hl-string">"invoice"].values())
fulfillment_fields = list(FIELDS[class="hl-string">"fulfillment"].values())
payment_fields = list(FIELDS[class="hl-string">"payment"].values())

leads = fetch_all(SERVICES[class="hl-string">"lead"], lead_fields, date_filter(FIELDS[class="hl-string">"lead"][class="hl-string">"created_at"]))
opportunities = fetch_all(SERVICES[class="hl-string">"opportunity"], opportunity_fields, date_filter(FIELDS[class="hl-string">"opportunity"][class="hl-string">"created_at"]))
quotes = fetch_all(SERVICES[class="hl-string">"sales_quote"], quote_fields, date_filter(FIELDS[class="hl-string">"sales_quote"][class="hl-string">"created_at"]))
orders = fetch_all(SERVICES[class="hl-string">"sales_order"], order_fields, date_filter(FIELDS[class="hl-string">"sales_order"][class="hl-string">"created_at"]))
invoices = fetch_all(SERVICES[class="hl-string">"invoice"], invoice_fields, date_filter(FIELDS[class="hl-string">"invoice"][class="hl-string">"created_at"]))
fulfillments = fetch_all(SERVICES[class="hl-string">"fulfillment"], fulfillment_fields, date_filter(FIELDS[class="hl-string">"fulfillment"][class="hl-string">"completed_at"]))
payments = fetch_all(SERVICES[class="hl-string">"payment"], payment_fields, date_filter(FIELDS[class="hl-string">"payment"][class="hl-string">"received_at"]))

events: List[Dict[str, Any]] = []

for record in leads:
    field_map = FIELDS[class="hl-string">"lead"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"]) or get_value(record, field_map[class="hl-string">"id"])
    attributes = common_attributes(record, field_map)
    add_event(events, opportunity_id, class="hl-string">"Lead Captured", get_value(record, field_map[class="hl-string">"created_at"]), attributes)
    if text(get_value(record, field_map[class="hl-string">"status"])).lower() == class="hl-string">"qualified":
        add_event(events, opportunity_id, class="hl-string">"Lead Qualified", get_value(record, field_map[class="hl-string">"status_changed_at"]) or get_value(record, field_map[class="hl-string">"created_at"]), attributes)

for record in opportunities:
    field_map = FIELDS[class="hl-string">"opportunity"]
    opportunity_id = get_value(record, field_map[class="hl-string">"id"])
    attributes = common_attributes(record, field_map)
    add_event(events, opportunity_id, class="hl-string">"Opportunity Created", get_value(record, field_map[class="hl-string">"created_at"]), attributes)
    stage = text(get_value(record, field_map[class="hl-string">"stage"])).lower()
    if stage in {class="hl-string">"proposal", class="hl-string">"solution design", class="hl-string">"solution proposed"}:
        add_event(events, opportunity_id, class="hl-string">"Solution Proposed", get_value(record, field_map[class="hl-string">"status_changed_at"]) or get_value(record, field_map[class="hl-string">"created_at"]), attributes)
    status = text(get_value(record, field_map[class="hl-string">"status"])).lower()
    reason = text(get_value(record, field_map[class="hl-string">"status_reason"])).lower()
    if status == class="hl-string">"won":
        add_event(events, opportunity_id, class="hl-string">"Opportunity Won", get_value(record, field_map[class="hl-string">"status_changed_at"]), attributes)
    if status in {class="hl-string">"closed", class="hl-string">"closed won"} and reason == class="hl-string">"won":
        add_event(events, opportunity_id, class="hl-string">"Opportunity Closed Won", get_value(record, field_map[class="hl-string">"status_changed_at"]), attributes)
    if status in {class="hl-string">"lost", class="hl-string">"closed lost"}:
        add_event(events, opportunity_id, class="hl-string">"Opportunity Closed Lost", get_value(record, field_map[class="hl-string">"status_changed_at"]), attributes)

for record in quotes:
    field_map = FIELDS[class="hl-string">"sales_quote"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"])
    attributes = common_attributes(record, field_map)
    add_event(events, opportunity_id, class="hl-string">"Quote Created", get_value(record, field_map[class="hl-string">"created_at"]), attributes)
    status = text(get_value(record, field_map[class="hl-string">"status"])).lower()
    status_time = get_value(record, field_map[class="hl-string">"status_changed_at"]) or get_value(record, field_map[class="hl-string">"created_at"])
    if status in {class="hl-string">"sent", class="hl-string">"proposed"}:
        add_event(events, opportunity_id, class="hl-string">"Quote Sent to Customer", status_time, attributes)
    if status in {class="hl-string">"accepted", class="hl-string">"customer accepted"} or get_value(record, field_map[class="hl-string">"accepted_at"]):
        add_event(events, opportunity_id, class="hl-string">"Quote Accepted by Customer", get_value(record, field_map[class="hl-string">"accepted_at"]) or status_time, attributes)

for record in orders:
    field_map = FIELDS[class="hl-string">"sales_order"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"])
    attributes = common_attributes(record, field_map)
    add_event(events, opportunity_id, class="hl-string">"Sales Order Created", get_value(record, field_map[class="hl-string">"created_at"]), attributes)
    status = text(get_value(record, field_map[class="hl-string">"status"])).lower()
    previous_status = text(get_value(record, field_map[class="hl-string">"previous_status"])).lower()
    if previous_status == class="hl-string">"submitted" and status in {class="hl-string">"in process", class="hl-string">"pending revision"}:
        add_event(events, opportunity_id, class="hl-string">"Sales Order Reworked", get_value(record, field_map[class="hl-string">"status_changed_at"]), attributes)

for record in fulfillments:
    field_map = FIELDS[class="hl-string">"fulfillment"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"])
    status = text(get_value(record, field_map[class="hl-string">"status"])).lower()
    if status in {class="hl-string">"fulfilled", class="hl-string">"completed", class="hl-string">"delivered", class="hl-string">"shipped"} or get_value(record, field_map[class="hl-string">"completed_at"]):
        add_event(events, opportunity_id, class="hl-string">"Order Fulfilled", get_value(record, field_map[class="hl-string">"completed_at"]), {})

for record in invoices:
    field_map = FIELDS[class="hl-string">"invoice"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"])
    add_event(events, opportunity_id, class="hl-string">"Invoice Generated", get_value(record, field_map[class="hl-string">"created_at"]) or get_value(record, field_map[class="hl-string">"invoice_date"]), {})

for record in payments:
    field_map = FIELDS[class="hl-string">"payment"]
    opportunity_id = get_value(record, field_map[class="hl-string">"opportunity_id"])
    status = text(get_value(record, field_map[class="hl-string">"status"])).lower()
    if status in {class="hl-string">"received", class="hl-string">"cleared", class="hl-string">"processed", class="hl-string">"paid"} or get_value(record, field_map[class="hl-string">"received_at"]):
        add_event(events, opportunity_id, class="hl-string">"Payment Received", get_value(record, field_map[class="hl-string">"received_at"]), {})

columns = [
    class="hl-string">"SalesOpportunityId",
    class="hl-string">"ActivityName",
    class="hl-string">"EventTime",
    class="hl-string">"SalesRepresentative",
    class="hl-string">"LeadSource",
    class="hl-string">"OpportunityStatus",
    class="hl-string">"SalesOrderAmount",
    class="hl-string">"ProductCategory",
    class="hl-string">"DiscountPercentage",
]

result = pd.DataFrame(events)
for column in columns:
    if column not in result.columns:
        result[column] = None
result = result[columns]
result = result.drop_duplicates()
result[class="hl-string">"EventTime"] = pd.to_datetime(result[class="hl-string">"EventTime"], utc=True, errors=class="hl-string">"coerce")
result = result.dropna(subset=[class="hl-string">"SalesOpportunityId", class="hl-string">"ActivityName", class="hl-string">"EventTime"])
result = result.sort_values([class="hl-string">"SalesOpportunityId", class="hl-string">"EventTime", class="hl-string">"ActivityName"], kind=class="hl-string">"stable")
result[class="hl-string">"EventTime"] = result[class="hl-string">"EventTime"].dt.strftime(class="hl-string">"%Y-%m-%dT%H:%M:%SZ")
result.to_csv(OUTPUT_FILE, index=False, encoding=class="hl-string">"utf-8")

required_activities = {
    class="hl-string">"Lead Captured",
    class="hl-string">"Lead Qualified",
    class="hl-string">"Opportunity Created",
    class="hl-string">"Solution Proposed",
    class="hl-string">"Quote Created",
    class="hl-string">"Quote Sent to Customer",
    class="hl-string">"Quote Accepted by Customer",
    class="hl-string">"Opportunity Won",
    class="hl-string">"Sales Order Created",
    class="hl-string">"Sales Order Reworked",
    class="hl-string">"Order Fulfilled",
    class="hl-string">"Invoice Generated",
    class="hl-string">"Payment Received",
    class="hl-string">"Opportunity Closed Won",
    class="hl-string">"Opportunity Closed Lost",
}
missing_activities = sorted(required_activities.difference(set(result[class="hl-string">"ActivityName"].dropna().unique())))
print(fclass="hl-string">"Wrote {len(result)} event rows to {OUTPUT_FILE}")
if missing_activities:
    print(class="hl-string">"Activities with no extracted rows in this data range or configuration:")
    for activity in missing_activities:
        print(fclass="hl-string">"- {activity}")

始める準備はできていますか。

このデータテンプレートがあれば、リードから入金までのプロセスの改善を始めるために必要なものがそろいます。今すぐ収益サイクルの改善に取り組みましょう。

改善ガイドに戻るテンプレートをダウンロード

今すぐリードから入金までのプロセスを改善し、受注率を高めましょう。

無料トライアルで失注を減らし、受注率を20％高めましょう。

無料トライアルを開始

クレジットカードは不要です。数分で設定できます。

リードから入金までのデータテンプレート

リードから入金までのデータテンプレート

リードから入金までの属性

リードから入金までのアクティビティ

抽出ガイド

SAP Sales Cloud Analytics OData APIによる抽出

ステップ

設定

a サンプルクエリ python

SAP Sales Cloud標準ODataビジネスオブジェクトクエリ

ステップ

設定

a サンプルクエリ python

始める準備はできていますか。

今すぐリードから入金までのプロセスを改善し、受注率を高めましょう。

リードから入金までのデータテンプレート

リードから入金までのデータテンプレート

リードから入金までの属性

リードから入金までのアクティビティ

抽出ガイド

SAP Sales Cloud Analytics OData APIによる抽出

ステップ

設定

a サンプルクエリ python

SAP Sales Cloud標準ODataビジネスオブジェクトクエリ

ステップ

設定

a サンプルクエリ python

始める準備はできていますか。

今すぐリードから入金までのプロセスを改善し、受注率を高めましょう。

プライバシーを大切にしています