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

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

SAP Sales Cloud

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

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

このテンプレートでは、リードから入金までのプロセスを分析するために必要なデータの収集方法を順を追って説明します。詳細なイベントログの作成に必要な属性とアクティビティをまとめ、SAP Sales Cloudからデータを抽出する手順も紹介します。プロセスマイニングを始める際にお役立てください。

収集を推奨する属性
追跡する主要なアクティビティ
SAP Sales Cloudからのデータ抽出手順

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

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

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

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

3 必須 6 推奨 8 任意

	名前	説明
	アクティビティ名 ActivityName	プロセス内の特定の時点で発生した業務アクティビティまたはイベントの名前です。
説明アクティビティ名は、「Lead Qualified」「Quote Created」「Payment Received」など、リードから入金までのプロセスにおける特定のステップやイベントを表します。これらのイベントが、各営業案件のプロセスフローを構成する一連のアクションとなります。こうしたアクティビティの分析は、プロセスマイニングの中核です。プロセスマップの可視化、ステップ間のボトルネックの特定、プロセス経路ごとの発生頻度の測定を通じて、営業プロセスが実際にどのように進んでいるかを明らかにします。重要な理由この属性はプロセスマップの各ステップを定義するもので、プロセスフローの可視化と分析に欠かせません。入手先 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で、リードから入金までのプロセスにおける主なケース識別子です。
説明 Sales Opportunity IDは、リードとして登録された時点から受注または失注が確定するまで、各営業案件を一意に識別します。リードの選別、見積書の作成、受注処理、入金など、関連するすべてのアクティビティを結び付ける中心的なIDです。プロセスマイニング分析では、このIDを使って各営業案件の全体的な経過を再構成します。すべてのイベントを関連付けることで、営業案件ごとのプロセスバリアント、サイクルタイム、コンバージョン率を分析できます。重要な理由プロセス内のすべてのアクティビティを結び付け、各営業案件のライフサイクル全体を追跡するための重要なケースIDです。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトの主キーです。例 OP-8000123456OP-8000123457OP-8000123458
	リードソース LeadSource	最初のリードを獲得したマーケティングチャネルまたは流入元です。
説明リードソースは、ウェブフォーム、展示会、パートナーからの紹介など、見込み顧客を最初にどのように見つけたかを示します。通常、リードの作成時に記録されます。この属性は「ソース別リードコンバージョン率」ダッシュボードに欠かせません。この切り口で分析すると、マーケティングチームと営業チームは、どのチャネルから価値の高いリードを獲得できているかを把握し、リソースの配分やキャンペーンの改善に役立てられます。重要な理由マーケティングチャネルごとの効果を測定し、リード獲得施策を改善するために必要です。入手先 SAP Sales CloudのLeadおよびOpportunityビジネスオブジェクトにあります。項目名は「Source」または「Origin」の場合がよくあります。例ウェビナーパートナーからの紹介展示会ウェブサイトからの問い合わせ
	値引率 DiscountPercentage	見積または受注に適用された値引率です。
説明この属性は、通常、見積または受注の段階で営業案件に適用された値引きの割合を表します。定価に対する割合で示します。財務実績や営業規律を分析するうえで重要な指標です。「値引きの分布」ダッシュボードでは、この属性を使って営業担当者や製品ごとの値引き状況を確認できます。また、「値引き承認のコンプライアンス」重要業績評価指標（KPI）にも使われ、大幅な値引きが適切な承認ワークフローに従っているかを確認できます。重要な理由価格戦略や営業チームの値引き状況、値引きが収益性に与える影響を分析するうえで役立ちます。入手先 SAP Sales Cloudの関連する見積または受注ビジネスオブジェクトに含まれる価格要素から算出します。例 0.050.100.25
	受注金額 SalesOrderAmount	営業案件に紐づく受注伝票の合計金額です。
説明この属性は、商談の受注が確定し、受注伝票が作成された時点で販売する商品やサービスの合計金額を表します。営業プロセスが成功裏に完了したことで得られる売上を示します。受注金額は、分析における重要な財務指標です。商談を金額規模（小規模、中規模、大規模など）で分類し、規模によってプロセスの進み方に違いがあるかを確認できます。また、受注率などの重要業績評価指標（KPI）を分析する際に、受注した商談と失注した商談の合計金額を比較するための基準にもなります。重要な理由財務面からプロセスを捉え、営業サイクルや結果を金額に基づいて分析できます。入手先 SAP Sales Cloudの関連する受注ビジネスオブジェクトにある「合計正味金額」フィールドから取得します。例 50000.00125000.507800.00
	営業担当者 SalesRepresentative	営業案件を担当する従業員です。
説明この属性は、リードまたは営業案件を担当するユーザーや従業員を示します。顧客との主な窓口となり、営業パイプラインで案件を進める役割を担うことがよくあります。分析では、営業担当者が実績を比較するための重要な切り口になります。個人、チーム、地域ごとに営業サイクルの期間、受注率、プロセスルールへの準拠状況を評価し、優れた実績や指導が必要な領域を特定できます。重要な理由従業員ごとの実績を分析し、営業担当者への指導機会や優れた取り組みを特定できます。入手先 SAP Sales CloudのOpportunityまたはLeadビジネスオブジェクトにある「Owner」または「Employee Responsible」の担当者ロールに紐づきます。例 John SmithMaria GarciaChen Wei
	営業案件のステータス OpportunityStatus	「Open」「Won」「Lost」など、営業案件の現在の状態または結果です。
説明この属性は、特定の時点における営業案件全体のステータスを示します。案件が進行中なのか、受注に至ったのか、競合他社に敗れた、または別の理由で失注したのかを確認できます。最終ステータスの分析は、営業案件の受注率などの重要業績評価指標（KPI）の算出に欠かせません。受注に至った経路だけに絞って分析したり、失注につながりやすいプロセスのパターンを調べたりすることもできます。重要な理由ケースの結果を示す属性です。受注率と失注率の算出や、受注案件と失注案件のプロセス経路の分析に欠かせません。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトにある「Status」項目です。例進行中処理中受注失注停止
	製品カテゴリー ProductCategory	営業案件で販売する製品またはサービスのカテゴリーです。
説明製品カテゴリーは、営業案件に含まれる個々の製品やサービスを「ハードウェア」「ソフトウェア」「コンサルティングサービス」などの大きな分類にまとめたものです。多数の製品を扱う場合も、分析しやすくなります。製品カテゴリー別の分析は、提供する製品やサービスの種類によって営業プロセスがどう異なるかを把握するうえで役立ちます。「値引きの分布」や「受注処理の効率」などのダッシュボードで、カテゴリーによって値引き率や納品までの期間に違いがあるかを確認できます。重要な理由販売する製品やサービスの種類ごとにプロセスの違いを分析できます。種類によって営業サイクルが大きく異なる場合の比較に役立ちます。入手先 SAP Sales Cloudで、見積または受注の明細に関連付けられた製品マスターデータから取得します。例ソフトウェアライセンスハードウェアプロフェッショナルサービスサポート契約
	ソースシステム 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の商談または受注に設定される、主要な組織割り当て項目です。例 US01DE01北部法人営業
	地域 Region	顧客または営業チームが所在する地理的な地域です。
説明地域は、営業案件に割り当てられた地理的な範囲を表します。顧客の所在地や営業組織の構成に基づいて設定され、国、州、または独自に定義した営業区域などが該当します。地域は、分析対象を分類するうえで重要な属性です。「商談受注率の実績」ダッシュボードで地域ごとの実績を比較するために使います。地域によるプロセス効率、市場での成果、営業戦略の違いを把握できます。重要な理由地域ごとの受注率、サイクルタイム、プロセスの実行状況を比較し、営業実績の違いを地理的な観点から分析できます。入手先通常は、顧客の住所またはSAP Sales Cloudで営業案件に割り当てられた営業組織から取得します。例北米欧州・中東・アフリカアジア太平洋中南米
	手戻りあり IsReworked	アクティビティまたはケースで手戻りが発生したかを示すフラグです。
説明プロセス内で手戻りが検出されると、この真偽値フラグがtrueになります。たとえば、受注の作成後に内容が変更された場合や、見積が何度も修正された場合が該当します。アクティビティの順序を分析して判定します。この計算属性は、プロセスの非効率を定量化するうえで重要です。「受注の手戻り頻度」ダッシュボードと「受注の手戻り率」重要業績評価指標（KPI）を支え、複雑なパターン照合を行わずに手戻りのケースを絞り込み、件数を数えられます。重要な理由手戻りが発生したケースにフラグを付けてプロセスの非効率を直接定量化し、手戻りの頻度や原因を分析しやすくします。入手先この属性はソースシステムにはありません。データ変換時に、アクティビティの繰り返し（例：「受注作成」の後に「受注の手戻り」が発生）を検出して算出します。例 truefalse
	支払条件 PaymentTerms	「30日後払い」や「60日後払い」など、合意した支払条件です。
説明支払条件は、商品やサービスの代金を顧客がいつ支払うかを定めるものです。受注または契約の段階で設定され、請求書の支払期日に反映されます。「入金サイクルタイム」ダッシュボードの分析に欠かせない属性です。支払条件ごとに分類することで、顧客が合意した期日どおりに支払っているか、また、どの条件が入金サイクルの長期化や短縮に関係しているかを確認できます。重要な理由入金状況を分析する際の背景情報となり、遅延が顧客の支払行動によるものか、支払条件が緩やかなことによるものかを見極めるのに役立ちます。入手先 SAP Sales Cloudの受注または顧客マスターデータにあります。例 30日後払い60日後払い受領時払い
	配送方法 ShippingMethod	商品を顧客に届けるために使用する方法です。
説明この属性は、注文の配送方法を表します。「陸送」「航空貨物」「デジタル納品」などが該当し、物理的な商品を扱うプロセスで重要です。「受注処理の効率」ダッシュボードでは、配送方法によって処理時間に違いがあるかを分析できます。特定の物流経路における非効率の発見や、顧客への納期案内の精度向上に役立ちます。重要な理由物流経路ごとに納品実績を分類し、受注処理におけるボトルネックの特定に役立てます。入手先通常、SAP Sales Cloudの受注ビジネスオブジェクトにある明細またはヘッダーに設定されています。例陸送翌日航空便デジタルダウンロード貨物輸送
	顧客名 CustomerName	営業案件に関連する企業または個人の名前です。
説明この属性は、営業案件の見込み顧客を示し、営業プロセスをシステム内の特定の取引先に紐づけます。顧客別に分析すると、顧客を中心に営業プロセスを把握できます。営業サイクルが長い顧客や手戻りが多い顧客を特定できるほか、顧客別の「入金回収サイクルタイム」などの重要業績評価指標（KPI）の分析にも役立ちます。重要な理由顧客ごとの営業サイクルや支払いの傾向を把握するための分析に役立ちます。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトにある「Account」または「Prospect」の担当者ロールに紐づきます。例 Global Tech Inc.Innovate Solutions Ltd.Dynamic Corp

必須推奨任意

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

リードから入金までのプロセスを正確に把握・分析するために、イベントログに記録する主要なステップとマイルストーンです。

7 推奨 8 任意

	アクティビティ	説明
	入金確認	顧客からの入金が確認され、処理が完了したことを示すアクティビティです。通常は外部の財務システムやERPから情報を取得し、SAP Sales Cloudの請求書または受注伝票のステータスを更新します。
重要な理由リードから入金までのプロセスにおける、価値実現の最終段階です。請求から入金までの「入金回収サイクルタイム」を測定すると、キャッシュフローの管理や売掛金回収の状況を評価できます。入手先 InvoiceまたはSales Orderオブジェクトのステータスが「Paid」または「Cleared」に変更されたことから推定します。このデータは外部の財務システムから取得します。記録 Invoiceのステータスが「Paid」または「Cleared」に変更された日時を特定します。イベントタイプ inferred
	受注伝票の作成	正式な受注伝票が作成されたことを示すアクティビティです。納品と請求を開始するための社内文書で、ユーザーがSales Orderオブジェクトを作成し、親となるOpportunityに紐づけたときに明示的に記録されます。
重要な理由営業から業務部門への重要な引き継ぎ点です。「Opportunity Won」から「Sales Order Created」までの時間を分析すると社内の遅延を把握でき、この時点以降の手戻りを追跡するとデータ品質の問題が見つかります。入手先 Opportunityに紐づくSales Orderビジネスオブジェクトの作成日時に該当します。記録紐づくSales Orderレコードの作成日時を使用します。イベントタイプ explicit
	営業案件の作成	営業案件が正式に開始したことを示し、選別済みのリードが具体的な営業案件に移行した時点を表します。Opportunityビジネスオブジェクトの作成時にシステムで明示的に記録され、元のリードのデータが引き継がれることもあります。
重要な理由営業サイクル分析の主な起点となる重要なアクティビティです。案件が具体化した時点から、営業サイクルの期間、案件の受注率、営業チームの実績を測定できます。入手先 SAP Sales CloudのOpportunityビジネスオブジェクトの作成日時に該当します。記録 Opportunityレコードの作成日時を使用します。イベントタイプ explicit
	営業案件の受注	案件が成立し、組織が受注したことを示すアクティビティです。ユーザーがOpportunityのステータスを「Won」に変更すると記録されます。これはシステム上の標準的な明示操作です。
重要な理由受注率や営業実績を測定する重要な節目です。受注後の受注処理や納品などのプロセス開始につながることが多く、リードから入金までのプロセスにおける重要な移行点となります。入手先 Opportunityビジネスオブジェクトのステータス変更履歴から推定します。ステータスが「Won」に更新された日時です。記録 Opportunityオブジェクトのステータスが「Won」に変更された日時を特定します。イベントタイプ inferred
	営業案件の受注確定	受注処理や納品など、後続のアクティビティがすべて完了した後に、受注案件が最終状態になったことを示します。ユーザーがOpportunityのステータスを最終状態の「Closed」に変更し、理由として「Won」を指定したときに記録されます。
重要な理由プロセスマイニング分析における受注案件の最終地点となり、受注したすべての案件について営業サイクル全体の期間を算出できます。プロセスの終了を明確に特定できます。入手先 Opportunityオブジェクトのステータス変更履歴から推定します。ステータスが「Closed」に更新され、理由が「Won」となった日時を確認します。記録理由コードが「Won」の状態でステータスが「Closed」に変更された日時を特定します。イベントタイプ inferred
	営業案件の失注確定	競合他社に敗れた、または顧客が購入を見送ったことで、営業案件が失注に終わったことを示します。ユーザーがOpportunityのステータスを「Lost」または「Closed Lost」に変更したときに記録されます。
重要な理由営業戦略の改善には、案件を失注した時期と理由の分析が欠かせません。失注を終点として分析することで、失注案件が平均してどのステージで停滞するか、よくある失注理由は何かを把握できます。入手先 Opportunityビジネスオブジェクトのステータス変更履歴から推定します。ステータスが「Lost」または「Closed Lost」に更新された日時です。記録 Opportunityオブジェクトのステータスが「Lost」に変更された日時を特定します。イベントタイプ 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にリードのレコードが初めて作成されたことを示すアクティビティです。見込み顧客からの最初の接点や関心を表し、通常はウェブフォーム、リストのインポート、またはユーザーによる手入力で登録されます。
重要な理由このイベントを追跡すると、リードソースごとの効果を分析し、リード獲得数全体を測定できます。また、リードのコンバージョン率を算出し、営業ファネルの初期段階を把握する際の起点になります。入手先このイベントは、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で「分析」ワークセンターにアクセスでき、データソースとレポートの作成・編集権限を持つユーザーを用意します。
結合データソースの作成：「Business Analytics」ワークセンターで「Design Data Sources」ビューを開き、新しい結合データソースを作成します。すべての商談を取得できるよう、次の標準データソースを左外部結合で結合します：Lead Information → Opportunity Header and Item → Sales Quote Header and Item → Sales Order Header and Item。通常、商談IDまたは後続伝票のIDを結合条件にします。
カスタムレポートの作成：「Design Reports」ビューを開き、前の手順で作成した結合データソースに基づいて新しいレポートを作成します。識別子（リードID、商談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の分析機能で結合データソースを作成します。見積や受注に至らなかった商談も取得できるよう、商談オブジェクトを起点にLeft Outer Joinsを使用してください。
レポートの特性：カスタムレポートには、対象のアクティビティに対応するすべての日付・時刻項目を含めます。リード、商談、見積、受注の作成日時に加え、ステータス変更のタイムスタンプも必要です。
OData APIのフィルタリング：処理性能とデータ量を調整するため、Pythonスクリプト内のOData URLで$filterパラメーターを使用します。たとえば、OpportunityCreationDateで期間を絞り込むことを推奨します。初回分析では、通常6～12か月の期間を指定します。
ページネーション：提供されたスクリプトは、$topおよび$skipパラメーターを使ってODataのページネーションを処理します。API接続がタイムアウトすることなく、大量のデータを抽出するために必要です。
前提条件：この方法には、OData APIとリード、商談、見積、受注の基礎データソースへのアクセス権を持つ、専用の分析ユーザーが必要です。

クエリの例 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アクセスが有効になっていること、および連携ユーザーに商談、リード、見積、受注、請求書、ならびにテナントで利用可能な場合は入金または履行データへの読み取り権限があることを確認します。利用するシステムで提供されているSAP Sales Cloudの管理・連携ツールを使ってください。メニューの正確な場所やオブジェクトサービス名はテナントによって異なるため、システムに合わせて設定します。
公開済みの標準ODataサービス名、エンティティセット、キー項目、ナビゲーションプロパティ、ステータス項目、変更タイムスタンプ、担当者項目、ソース項目、金額項目、製品項目、関連項目を、必要なビジネスオブジェクトごとに確認します。オブジェクトやプロパティが公開されていると決めつけず、設定済みのODataサービスURLで参照できるサービスメタデータ文書から、確認済みのメタデータを記録します。
Pythonスクリプトで接続URL、認証情報またはOAuth設定、期間、ページサイズ、会社固有のフィルターを設定します。最初は3～6か月の期間で抽出し、処理性能とデータの網羅性を確認してから期間を延長します。
確認済みの標準ODataエンティティセットから商談とリードを抽出します。見積と受注も、それぞれ確認済みのエンティティセットから抽出します。請求書、履行、入金のレコードは、対応する標準ODataオブジェクトと関連がSAP Sales Cloudで公開されている場合に限り抽出します。これらのレコードが連携先のERPまたは財務システムで管理されている場合は、そのシステムから承認済みの同等のODataフィードを取得し、識別子を商談に対応付けます。
各ODataリクエストについて、サービスの次ページリンクに従うか、サポートされているページネーション方式を使って、すべてのページを取得します。サポートされている場合は、サーバー側で日付と会社のフィルターを適用します。件数やマッピングを監査できるよう、変換前の応答データを保存します。
タイムスタンプを1つのタイムゾーン（できればUTC）に統一し、SAPの日付または日時の値を、一貫したISO 8601形式に変換します。ステータス値は前後の空白を取り除き、大文字と小文字を区別しない比較ができるように正規化します。可能であれば、監査用データセットには元のステータス値も保持します。
必要なアクティビティごとにイベント行を作成します。「リード獲得」にはリードの作成時刻、「リードの適格化」にはリードが適格ステータスに達した時刻、「商談作成」には商談の作成時刻、「ソリューション提案」には商談が設定済みの提案またはソリューションのステージに達した時刻、「見積作成」には見積の作成時刻、「顧客への見積送付」には見積が送付済みまたは提案済みになった時刻、「顧客による見積承諾」には見積または商談のレコードに顧客の承諾が記録された時刻、「商談受注」には商談が受注ステータスに達した時刻、「受注作成」には受注の作成時刻を使います。「受注の手戻り」には、提出済みから処理中または修正待ちへの遷移を検出した時刻、「受注処理完了」には履行または出荷の完了時刻、「請求書発行」には請求書の作成時刻、「入金」には入金の受領または消込の時刻を使います。「商談の受注クローズ」には最終ステータスが受注であることを示す理由、「商談の失注クローズ」には最終ステータスが失注または失注クローズであることを示す理由を使います。
イベントをSalesOpportunityIdで外部結合します。リード、商談、見積、受注、請求書、履行、入金の各レコード間で、確認済みの関連項目を使います。直接関連付けられない場合は、連携または業務プロセスで管理されている承認済みの相互参照を使います。説明や金額が一致するだけで関連があると判断しないでください。
ソースとの関連付けで値を取得できる場合は、推奨属性を各イベントに設定します。営業担当者、リードソース、商談ステータス、受注金額、製品カテゴリー、値引率を関連するソースレコードから引き継ぎます。信頼できる値をソースから取得できない場合は、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に対応付けます。承認済みの相互参照を使って解決できる場合を除き、商談との信頼できる関連付けがないイベントは出力しないでください。
ステータスのマッピング：適格、提案またはソリューションの各ステージ、送付済み、提案済み、承諾済み、受注、クローズ、失注、失注クローズ、提出済み、処理中、修正待ち、履行完了、請求書作成、入金受領について、テナント固有の正確なマッピングを設定します。ステータスの表示名は、設定や言語によって異なる場合があります。
フィルター：会社、組織単位、伝票タイプ、営業エリア、ステータス、日付の各フィールドが公開され、その業務上の意味を把握できている場合に限り、確認済みの値で絞り込みます。会社コードと伝票タイプがすべてのSAP Sales Cloudオブジェクトに存在するとは限りません。
ページネーションとリクエスト制限：ODataサービスがサポートするページサイズと次ページの仕組みを使います。一時的なHTTPエラーに備えて再試行処理を加え、テナントのリクエスト制限を守り、過度な並列リクエストは避けてください。
変更履歴の要件：ステータスに基づくアクティビティには、タイムスタンプ付きのステータス履歴または変更ログが必要です。現在のステータス項目だけでは、過去にそのステータスに達した時刻を正確に再構成できません。
外部イベントソース：受注処理の完了、請求書の発行、入金の受領は、連携先のERP、物流、請求、財務システムで管理されている場合があります。承認済みのシステム間識別子と、ソースごとの抽出ルールを設定してください。
データ品質：値を取得できない場合はnullのまま保持します。業務ルールで制約を明示的に認めていない限り、過去の値の代わりに現在のステータスや担当者を設定しないでください。
前提条件：抽出をスケジュールする前に、必要なSAP Sales Cloudのエディション、APIの利用可否、連携設定、ビジネスオブジェクトの公開状況、テナントの権限、外部システムのライセンスを確認してください。

クエリの例 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分析OData APIによるデータ抽出

ステップ

設定

クエリの例 python

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

ステップ

設定

クエリの例 python

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

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