> 継続的なプロセス改善 > 受注から入金まで（Order to Cash）請求と会計 > `Salesforce Sales Cloud` > データテンプレート

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

Salesforce Sales Cloud

受注から入金まで（Order to Cash） - 請求と会計の属性 (20) 受注から入金まで（Order to Cash） - 請求と会計の活動 (13) 抽出ガイド (3)

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

このテンプレートは、貴社の「受注から入金まで（Order to Cash）」の請求・会計プロセスを効果的に分析するために必要な、主要なデータ属性と活動について包括的な概要を提供します。イベントログのために収集すべき具体的な情報と、そのデータの抽出に関する実践的なガイダンスが示されています。このリリソースを活用して、プロセスマイニングの取り組みを効率化し、価値ある洞察を得てください。

収集を推奨する項目
追跡すべき主要アクティビティ
抽出の手引き

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

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

受注から入金まで（Order to Cash） - 請求と会計の属性

これらは、包括的な「受注から入金まで（Order to Cash）」の請求・会計分析のためにイベントログに含めるべき推奨データフィールドであり、すべての重要な情報が確実に捕捉されるようにします。

3 必須 5 推奨 12 任意

	名前	説明
	アクティビティ名 ActivityName	請求プロセスで発生した特定のビジネスイベントの名前。
説明この属性は、「請求書生成済み」や「入金受領済み」など、請求書ライフサイクル内で達成されたステップまたはマイルストーンを記述します。これらの活動はプロセスマップ上のノードを形成します。活動名のシーケンス分析はプロセスマイニングの基本です。これにより実際のプロセスフローが明らかになり、設計されたプロセスとの比較が可能になります。特定のステップ間の逸脱、ボトルネック、手戻りループを特定するために使用され、「請求プロセスにおける手戻りおよびエラー」や「請求コンプライアンス違反レポート」といったダッシュボードを直接サポートします。その重要性それはプロセスのステップを定義し、プロセスマップの基盤を形成し、ワークフロー、ボトルネック、および逸脱の分析を可能にします。取得元これは通常、請求書オブジェクトのStatusフィールドの変更、またはタスクやイベントといった特定の行動を追跡する関連オブジェクトのレコードから導出されます。例請求書生成済み請求書承認済み顧客へ請求書送付済み入金確認済み
	イベント日時 EventTime	特定のアクティビティが発生した日時を示すタイムスタンプです。
説明この属性は、各活動の日付と時間を提供し、時系列順序付けとパフォーマンス分析にとって非常に重要です。タイムスタンプはイベントの順序を確立し、それらの間の期間の計算を可能にします。プロセス分析において、イベントタイムはサイクル時間、待機時間、特定の活動の期間を含むすべての時間ベースのメトリックを計算するために使用されます。「平均請求サイクル時間」や「DSO」といったKPIの基盤であり、「請求書承認サイクル時間」や「入金消込パフォーマンス」といったダッシュボードを強化します。その重要性このタイムスタンプは、イベントを正確に順序付けし、サイクル時間や期間などのすべてのパフォーマンスメトリックを計算するために極めて重要であり、遅延を特定する鍵となります。取得元このデータは、請求書オブジェクトや関連するタスク/イベントレコードにおける`CreatedDate`や`LastModifiedDate`といったシステム生成のタイムスタンプフィールドから取得されることがよくあります。例 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	請求書番号 InvoiceNumber	各請求書の一意の識別子であり、請求プロセスの主要なケース識別子として機能します。
説明請求書番号は、関連するすべての請求活動を一つのケースとしてまとめる中心的な属性です。各番号は、顧客に送付された個別の請求書を示します。プロセスマイニング分析において、この属性は請求書の生成から最終的な支払い、完了までのライフサイクルをエンドツーエンドで追跡することを可能にします。プロセスマップの構築や、「平均請求サイクル時間」や「売上債権回転日数（DSO）」といったケースレベルのKPIを算出する上で不可欠です。請求書番号ごとにプロセスを分析することで、個々の請求処理におけるボトルネック、手戻りループ、コンプライアンス違反を特定するのに役立ちます。その重要性これは、関連するすべての請求イベントを紐付け、各固有の取引における請求プロセス全体をエンドツーエンドで完全に可視化するための不可欠な鍵です。取得元これは通常、Salesforce Sales Cloudの請求書オブジェクトの主キーであり、`InvoiceNumber`または類似の一意のIDフィールドで表されることがよくあります。例 INV-00582INV-01934INV-10345
	担当ユーザー UserResponsible	活動を実行したユーザーまたは担当者。
説明この属性は、請求書の承認や入金処理など、特定の活動を担当したSalesforceユーザーを特定します。多くの場合、レコードを最後に変更したユーザーやタスクの所有者に紐付けられます。担当ユーザー別にプロセスを分析することは、チームのパフォーマンス、ワークロードの分散、トレーニングニーズを理解する上で重要です。「請求チームのワークロードとパフォーマンス」ダッシュボードを直接サポートし、パフォーマンス比較やリソース配分分析を可能にします。また、遅延やエラー発生時の根本原因分析にも役立ちます。その重要性それは個人およびチームのパフォーマンス、ワークロードのバランス分析を可能にし、トップパフォーマーや追加トレーニングが必要なユーザーを特定するのに役立ちます。取得元これは、請求書オブジェクトの`LastModifiedById`フィールドや、関連するタスクまたはカスタムオブジェクトの`OwnerId`フィールドなどから取得できます。これらのIDは、ユーザー名を取得するためにUserオブジェクトと結合する必要があります。例 Alice JohnsonBob WilliamsCharlie Brown
	支払期日 PaymentDueDate	顧客が請求書を支払うべき期日。
説明この属性は、請求書に記載されている支払い期限を指定します。これは請求書の日付と合意された支払い条件に基づいて計算されます。支払期日は、財務計画と回収管理にとって重要なデータポイントです。実際の支払いパフォーマンスを測定する基準となります。「期限内支払い率」KPIの算出や、「売上債権回転日数（DSO）トレンド」のような支払い適時性を追跡するダッシュボードに不可欠です。その重要性これは、支払いパフォーマンスの測定、DSO（売上債権回転日数）の計算、そして支払い督促のような回収活動のトリガーとなるベンチマークです。取得元これはSalesforceの請求書オブジェクトにおける標準の日付フィールドで、多くの場合`DueDate`という名前です。例 2023-05-152023-06-302023-07-01
	経理部門 BillingDepartment	請求活動を担当する部署またはチーム。
説明この属性は、担当ユーザーが所属する機能グループ（例：「債権管理」や「営業オペレーション」）を指定します。これは通常、Salesforceのユーザープロファイルまたはロールから導出されます。部門別にパフォーマンスを分析することは、プロセスの責任範囲を理解し、特定のチーム内で発生しているシステム的な問題を特定する上で極めて重要です。「入金消込パフォーマンス」および「請求チームのワークロードとパフォーマンス」ダッシュボードで使用され、異なる機能領域間での効率性とリソース利用状況を比較します。その重要性これにより、チームまたは部門レベルでのパフォーマンス分析が可能となり、グループ固有のボトルネック、リソース制約、またはトレーニングのギャップを特定するのに役立ちます。取得元この情報は通常、SalesforceのUserオブジェクトにおいて、`Department`や`Role.Name`のようなフィールドに保存されています。例債権財務・経理業務回収チーム
	請求合計金額 InvoiceTotalAmount	請求書の合計金額。
説明この属性は、提供された商品やサービスに対して顧客から支払われるべき合計金額を表します。各請求ケースに関連付けられた主要な財務指標です。請求合計金額を分析することは、高額請求書の優先順位付けや、小規模取引と大規模取引でプロセスパフォーマンスがどのように異なるかを理解するのに役立ちます。ダッシュボードでの分析をセグメント化するために使用でき、例えば、高額請求書の方が承認に時間がかかったり、支払いが遅れたりする傾向があるかを確認できます。これは、財務リスクを管理し、回収努力を効果的に集中させる上で重要です。その重要性これにより財務影響分析が可能になり、高額請求書を優先し、金額が承認時間や支払い遅延などのプロセス行動にどのように影響するかを理解するのに役立ちます。取得元これはSalesforceの請求書オブジェクトにある標準の通貨フィールドで、おそらく`GrandTotal`や類似の合計額フィールドという名前になるでしょう。例 5400.5012500.00850.75
	請求書ステータス InvoiceStatus	請求書ライフサイクルにおける現在のステータス。
説明この属性は、「下書き」、「承認待ち」、「送信済み」、「支払い済み」、「無効」など、請求書の現在の状態を反映します。これは、特定の時点における請求書のプロセス上の位置のスナップショットを提供します。請求書ステータスは、フィルタリングとセグメンテーションのための重要な次元です。アナリストが、現在支払いを待っているすべての請求書や却下されたすべての請求書など、特定の請求書群に焦点を当てることを可能にします。これは、作業の優先順位付けや、特定の段階で滞留する請求書の特徴を分析するのに役立ちます。その重要性請求書の現在の状態を明確に把握でき、未処理、クローズ済み、または問題のあるケースのフィルタリングと分析を可能にします。取得元これは通常、Salesforceの請求書オブジェクトにある`Status`という名前の標準の選択リスト（picklist）フィールドです。例承認待ち承認済み顧客へ送信済み支払い済み償却済み
	`売上債権回転日数` DaysSalesOutstanding	請求書が送付されてから入金が受領されるまでの日数。
説明売掛金回収期間（DSO）は、売上が発生してから企業が支払いを受領するまでの平均日数を測定する重要な財務指標です。「顧客への請求書送付」イベントから「顧客からの支払い受領」イベントまでの期間として計算されます。このKPIは受注から現金化（O2C）プロセスの主要な焦点であり、この属性によってすべての請求書で利用可能になります。「売掛金回収期間（DSO）トレンド」ダッシュボードを直接サポートし、キャッシュフローの監視と改善に不可欠です。その重要性これは、回収プロセスの有効性および会社のキャッシュフローへの直接的な影響を測定するための重要なKPIです。取得元これは計算された属性です。計算式は `(Timestamp('Customer Payment Received') - Timestamp('Invoice Sent to Customer'))` です。例 32日間58日29日間
	アカウントオーナー AccountOwner	顧客アカウントを担当する営業担当者またはアカウントマネージャー。
説明この属性は、顧客関係の社内担当者を特定します。これは通常、Salesforceの取引先（Account）に割り当てられた営業担当者またはアカウントマネージャーです。請求業務に直接関与しないものの、取引先オーナーは分析において重要な要素となり得ます。請求プロセスにおける問題は顧客関係に影響を与える可能性があるため、この属性はプロセスパフォーマンスデータをビジネスの商業面と結びつけるのに役立ちます。特定のオーナーが管理する取引先で請求に関する問題が多く発生しているかどうかを確認するために活用できます。その重要性請求処理のパフォーマンスを営業担当者に紐付け、請求書作成ミスや遅延がビジネスに与える影響を把握できます。取得元これは、請求書に関連する取引先（Account）オブジェクトの`Owner.Name`フィールドです。例 David Millerソフィア・ガルシアJames Wilson
	イベントの終了時刻 EventEndTime	アクティビティの完了時刻を示すタイムスタンプ。
説明この属性は活動の完了時間を記録します。請求業務における多くの活動は、開始時間と終了時間が同時の瞬間的なイベントですが、承認ステップのように測定可能な期間を持つものもあります。終了時間を持つことで、活動の処理時間、つまり担当者やシステムがタスクに積極的に作業する期間を正確に計算できます。これにより、実際の作業時間と待機時間を区別するのに役立ち、プロセス効率のより詳細な視点を提供します。その重要性正確なアクティビティ処理時間の計算を可能にし、アクティブな作業とアイドル状態の待機時間を区別することで、より正確な効率分析を実現します。取得元これは多くの場合、標準フィールドではありません。ケース内の後続アクティビティのStartTimeを取得するか、カスタムフィールドで捕捉することで導出する必要がある場合があります。例 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	ソースシステム SourceSystem	`データ`の出所となった`システム`を特定します。
説明この属性は、イベントデータが生成されたソースアプリケーションを指定します。このプロセスにおいては、通常「Salesforce Sales Cloud」となります。複数の統合システムが存在する環境では、このフィールドはデータリネージュとトラブルシューティングにとって極めて重要です。データのコンテキストを理解し、異なるシステムからのイベントがプロセスマイニングツール内で正確に統合・解釈されることを保証するのに役立ちます。その重要性データガバナンス、検証、複数システム環境での分析に不可欠なデータ発生源に関する重要なコンテキストを提供します。取得元これは通常、データ抽出、変換、ロード（ETL）プロセス中に、データセットの発生源を識別するために追加される静的な値です。例 `Salesforce Sales Cloud`SFSC
	最終データ更新 LastDataUpdate	ソースシステムからの最終`データ`更新の`タイムスタンプ`。
説明この属性は、プロセスマイニング分析用のデータがSalesforce Sales Cloudから最後に抽出された日時を示します。これは、データが更新されるたびにデータセット全体に適用されるメタデータフィールドです。このタイムスタンプは、ユーザーが分析データの鮮度を把握するために不可欠です。表示しているダッシュボードやKPIが最新であるかを知るのに役立ち、プロセス洞察に基づいたタイムリーで情報に基づいたビジネス上の意思決定を行う上で極めて重要です。その重要性データの適時性をユーザーに通知し、意思決定がプロセスの現状と関連性の高いビューに基づいていることを保証します。取得元この値は、ETLツールまたはデータパイプラインによって、各実行時に生成され、データセットに記録されます。例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	延滞 IsLatePayment	支払期日後に支払いが行われたかどうかを示す計算フラグ。
説明このブール属性は、「顧客からの入金受領」タイムスタンプと「支払期日」を比較して導出されます。支払いが遅れた場合はTrue、それ以外の場合はFalseとなります。このフラグは、支払い行動と回収の有効性分析を簡素化します。「期限内支払い率」KPIの基礎となり、さらなる分析のために顧客を期限内支払い者と遅延支払い者に分類するのに役立ちます。各請求書の支払いパフォーマンスについて、明確な二者択一の結果を提供します。その重要性これは、回収における明確な成功指標を提供し、「期限内支払い率」KPIを直接サポートするとともに、支払い遅延の要因分析を可能にします。取得元この属性はソースシステムには存在しません。支払日を`PaymentDueDate`フィールドと比較することにより、ETL層またはプロセスマイニングツールで計算されます。例 truefalse
	手戻り IsRework	請求書が手直しループを経たかどうかを示す計算フラグ。
説明このブール属性は、データ処理中に導出されます。請求書の活動シーケンスが手戻りの証拠、例えば一度通過した段階（例：「請求書承認済み」の後に「請求書修正済み」）に戻るなど、を示した場合にTrueに設定されます。このフラグは、プロセスの非効率性を迅速に特定し、定量化するために極めて重要です。「請求書手戻り率」KPIと「請求プロセスにおける手戻りおよびエラー」ダッシュボードを直接強化し、アナリストが高コストで時間のかかる手戻りループを持つケースを特定・調査することを可能にします。その重要性このフラグは、修正ループを伴うケースを特定することでプロセスの非効率性を直接定量化し、エラーの原因を特定し、品質不良によるコストを算出するのに役立ちます。取得元この属性はソースシステムには存在しません。各ケースの活動シーケンスに基づいて、プロセスマイニングツールまたはETL層で計算されます。例 truefalse
	支払条件 PaymentTerms	「Net 30」や「受領時払い」など、請求書支払いの合意された条件を指します。
説明この属性は、請求書がいつ、どのように支払われるべきかを規定するルールを定義します。支払期日の算出方法を決定し、早期支払い割引に関する規定を含むこともあります。支払条件別に分析することで、異なる契約が支払い行動にどのように影響するかを理解するのに役立ちます。「早期支払い割引活用率」ダッシュボードにとって不可欠であり、支払い日と条件を比較して、見過ごされている財務機会を特定します。また、一部の請求書で支払いサイクルが長くなったり短くなったりする理由についてのコンテキストも提供します。その重要性支払い期日のコンテキストを提供し、支払い行動、DSO、および早期支払い割引プログラムの有効性を分析するために不可欠です。取得元この情報は、Salesforceの請求書オブジェクトまたは関連する取引先（Account）オブジェクト内の選択リストまたはテキストフィールドに保存されている可能性が高いです。例支払条件：正味30日支払条件：正味60日2% 10, Net 30受領時支払い
	請求先国 BillingCountry	請求書の請求先住所に指定された国。
説明この属性は、顧客の請求先住所の国を捕捉します。これはプロセスデータをセセグメント化する上で重要な地理的次元となります。国別に請求プロセスを分析することは、パフォーマンス、コンプライアンス、顧客行動における地域ごとの差異を特定するために不可欠です。特定の国で支払いサイクルが長くなったり、手戻り率が異なったり、プロセスに影響を与える特定の規制要件が存在したりするかどうかを明らかにできます。これにより、グローバルなプロセス標準化と地域に合わせた最適化の取り組みをサポートします。その重要性地域ごとのパフォーマンス、コンプライアンス要件、支払い行動の違いを特定するための地理的分析を可能にします。取得元これは請求書オブジェクトの標準的な複合アドレスフィールドの一部であり、通常は`BillingCountry`です。例米国ドイツ日本ブラジル
	請求書処理リードタイム InvoiceCycleTime	請求書の生成から完了までの総経過時間。
説明この計算メトリックは、単一の請求書における請求プロセス全体の期間を測定します。通常、「請求書生成済み」イベントと「請求書クローズ済み」または「入金消込済み」イベント間の時間差として計算されます。これは、請求プロセス全体の効率性を測定するための主要なKPIです。「平均請求サイクル時間」KPIおよび「エンドツーエンド請求サイクル概要」ダッシュボードで使用され、時間の経過とともにプロセスパフォーマンスを監視し、ベンチマークします。このサイクル時間を短縮することは、より迅速な現金化に繋がります。その重要性これは、請求プロセス全体のエンドツーエンドの効率性を測定する主要なパフォーマンス指標であり、現金化サイクルに直接影響を与えます。取得元このメトリックはソースシステムには存在しません。各ケースの最後のイベントのタイムスタンプから最初のイベントのタイムスタンプを差し引くことで、プロセスマイニングツールによって計算されます。例 25 days 4 hours45日12時間60日2時間
	請求通貨 InvoiceCurrency	USDやEURなど、請求金額の通貨コード。
説明この属性は、請求書がどの通貨で建てられているかを示します。これは複数の国で事業を展開する組織にとって特に重要です。このフィールドは、あらゆる財務分析において不可欠なコンテキストを提供します。これにより、金額の正確な集計が可能となり、異なる通貨圏間でのプロセス指標の比較が可能になります。財務KPIを分析する際には、異なる通貨が混在するのを避けるための必須フィルターとなります。その重要性すべての金額に適切なコンテキストを提供することで、特に多国籍事業における正確な財務分析とレポート作成を保証します。取得元これは通常、複数通貨が有効化されたSalesforceインスタンスで利用可能な標準の`CurrencyIsoCode`フィールドです。例 USDEURGBPJPY
	顧客名 CustomerName	請求先の顧客名またはアカウント名。
説明この属性は、請求書が発行された顧客または企業を特定します。通常、Salesforceの関連する取引先（Account）レコードからリンクされます。顧客別にプロセスを分析することは、顧客固有の行動を理解し、主要なアカウントに影響を与えている可能性のある問題を特定するために不可欠です。特定の顧客が常に支払いが遅れる、より多くの手戻りが必要となる、あるいは複雑な承認サイクルを持つといった傾向を明らかにできます。この洞察は、顧客関係の管理や、回収戦略の調整に役立ちます。その重要性顧客中心の分析を可能にし、どの顧客が頻繁に支払いを遅延させたり、より多くの請求書修正を必要としたりするかといったパターンを特定し、顧客関係管理を向上させます。取得元これは、請求書オブジェクトから取引先（Account）オブジェクトへの参照関係を介してリンクされた`Account.Name`フィールドから取得されます。例 ABC Corporation`Global Tech Inc.`Innovate Solutions LLC

必須推奨任意

受注から入金まで（Order to Cash） - 請求と会計の活動

これらは、正確なプロセスディスカバリとパフォーマンス評価のためにイベントログに記録すべき主要なプロセスステップとマイルストーンです。

5 推奨 8 任意

	アクティビティ	説明
	請求書がクローズ済み	請求書のライフサイクルが完了し、全額が支払われ、消込が完了した状態を指します。これは、正常に処理された請求書における最終活動であり、通常はステータス更新によって記録されます。
その重要性この活動はプロセスの主要な終点として機能し、正確なエンドツーエンドのサイクル時間計算を可能にします。プロセス分析において、完了の明確な定義を提供します。取得元 Invoiceオブジェクトのステータスフィールドが「クローズ済み」、「全額支払い済み」、または類似の最終ステータスに更新されたときのタイムスタンプから推測されます。取得請求書のステータスフィールドが最終的な「クローズ済み」値に変更されること。イベントタイプ inferred
	請求書承認済み	権限のあるユーザーが請求書を確認・承認し、その正確性と顧客への送付準備が整っていることを確認しました。このイベントは通常、請求書のステータスが「承認済み」に変更されたときに捕捉されます。
その重要性これは、請求プロセスのそれ以降の進行を左右する重要なマイルストーンです。ここでの遅延は、DSO（売上債権回転日数）や全体のサイクル時間に影響を与える重大なボトルネックを生み出し、「請求書承認サイクル時間」ダッシュボードで測定されます。取得元 Invoiceオブジェクトのステータスフィールドが「承認済み」に変更されたことから推測されます。Salesforce承認プロセスが使用されている場合、これはProcessInstanceオブジェクトの履歴から明示的に捕捉できます。取得請求書のステータスフィールドが「承認済み」に変更されること、または正式な承認プロセスステップの完了。イベントタイプ inferred
	請求書生成済み	この活動は、Salesforce内で新しい請求書レコードが作成されたことを示します。これは特定の取引における請求プロセスの正式な開始であり、通常、注文が履行された後や契約上のマイルストーンが達成された後にトリガーされます。このイベントは、請求書レコードの作成タイムスタンプから捕捉されます。
その重要性これは請求プロセスの主要な開始イベントです。この時点から支払いまでの時間を分析することで、受注から入金まで（Order to Cash）の全体サイクル時間を測定し、初期データ入力の遅延を特定するのに役立ちます。取得元このイベントは、Salesforce内の請求書カスタムオブジェクト、または請求書を表す同様のオブジェクトの作成日（CreatedDateフィールド）から捕捉されます。取得請求書オブジェクトのレコード作成タイムスタンプ。イベントタイプ explicit
	顧客からの入金受領	顧客が請求書に対して支払いを行い、入金が確認されたことを指します。これは通常、関連する「支払い」レコードを作成し、それを請求書に紐付けることで記録されます。
その重要性これは、プロセスにおける現金回収段階で最も重要なマイルストーンです。DSO（売上債権回転日数）計算の終点であり、収益の受領成功を示します。取得元 Invoiceオブジェクトに関連付けられた「Payment」カスタムオブジェクトレコードの作成日から捕捉されます。または、請求書のステータスが「支払い済み」に変更されたことから推測することもできます。取得関連する支払いレコードの作成。イベントタイプ explicit
	顧客へ請求書送付済み	承認された請求書が、メール、郵送、またはポータルを通じて顧客に正式に送付されたことを指します。このイベントは、多くの場合、「送信日」フィールドにデータが入力されるか、ステータスが「送信済み」に変わることで捕捉されます。
その重要性これは支払い回収期間の開始を示し、売上債権回転日数（DSO）を計算するための開始点です。顧客とのコミュニケーションや支払いタイムラインを追跡するための重要なマイルストーンとなります。取得元 Invoiceオブジェクトの「送付日」フィールドが入力されたとき、またはステータスが「送付済み」に更新されたことから推測されます。統合されたメールツールを介して送信された場合、アクティビティ履歴に明示的なイベントとして記録されることもあります。取得「Sent_Date__c」フィールドが入力されたタイムスタンプ。イベントタイプ inferred
	元帳への入金記帳	受領した入金が、会社の財務会計システムまたは元帳に正式に記録された状態を指します。これは、多くの場合、連携処理の実行後に、入金または請求書レコードのステータスが更新されることで捕捉されます。
その重要性この活動は、入金受領と財務消込を切り分けます。入金受領から記帳までの時間は、社内の会計処理における遅延を浮き彫りにすることができます。取得元 PaymentまたはInvoiceオブジェクトのステータスフィールドが、「転記済み」や「ERPへエクスポート済み」のような値に変更されたことから推測されます。これはしばしばAPI統合を介して更新されます。取得支払いまたは請求書のステータスが「転記済み」に変更されること。イベントタイプ inferred
	承認のために請求書提出済み	請求書が最終化され、顧客へ送付される前に社内レビューのために提出されたことを指します。この活動は通常、請求書レコードのステータスフィールドの変更（例：「下書き」から「承認待ち」）によって捕捉されます。
その重要性この活動を追跡することで、承認キューでの滞留時間を特定できます。「平均請求書承認時間」KPIを計算するための重要な第一歩となります。取得元 Invoiceオブジェクトの項目履歴追跡から推測され、ステータスフィールドが「承認のために提出済み」や「審査中」のような値に更新されたときに検出されます。取得請求書のステータスフィールドが「承認待ち」に変更されること。イベントタイプ inferred
	支払期日到達	これは、請求書の支払条件に従って支払いが期限となる時点を表す計算されたイベントです。ユーザーのアクションではなく、請求書データから導出されます。
その重要性この活動は、支払い行動を分析し、「期限内支払い率」KPIを測定するための重要なベンチマークを提供します。これにより、期限内支払いと遅延支払いを区別するのに役立ちます。取得元これは計算されたイベントです。現在のタイムスタンプと請求書オブジェクトの「期日」フィールドを比較して導出されます。Salesforceには保存されたイベントとしては存在しません。取得現在の日付を請求書の期日フィールドと比較して算出されます。イベントタイプ calculated
	支払督促の発行	顧客に対して、間近に迫った支払いまたは延滞している支払いについて通知する連絡が送信された。これはしばしば、請求書にリンクされた特定のアクティビティ（タスクまたはメール）レコードとしてログに記録されます。
その重要性督促活動を追跡することは、回収戦略の有効性を評価する上で役立ちます。「支払督促の有効性」ダッシュボードや「支払督促トリガー率」KPIにとって不可欠です。取得元 Invoiceオブジェクトに関連付けられたアクティビティ（タスクまたはメール）レコードの作成から捕捉されます。その件名またはタイプが支払い催促であることを示します。取得特定のタイプ/件名を持つ関連タスクまたはメールレコードの作成。イベントタイプ explicit
	現金適用/照合済み	受領した入金が、システム内の特定の請求書と完全に照合され、適用されることで売掛金が決済された状態を指します。これは、入金または請求書レコードの最終ステータス変更によって捕捉されます。
その重要性これは、現金化サイクルの最終ステップを示します。「入金消込パフォーマンス」ダッシュボードは、財務チームの現金適用効率を測定するためにこの活動に依拠しています。取得元 Invoiceまたは関連するPaymentオブジェクトのステータスが「照合済み」や「適用済み」のような最終ステータスに変更されたことから推測されます。取得請求書または支払いのステータスが「照合済み」に変更されること。イベントタイプ inferred
	請求書修正済み	請求書が却下された、あるいはエラーが見つかった後に手作業で行われる修正または更新を指します。これは、請求書のステータスが「却下済み」から「下書き」に戻るなど、以前の状態に戻った場合に推測されます。
その重要性修正ループを特定することは、「請求書手直し率」KPIを測定するために不可欠です。修正が多いということは、初期の請求書作成プロセスに問題があり、遅延につながっていることを示しています。取得元項目履歴追跡から推測され、後続の段階の値（例：「却下済み」、「承認済み」）から先行の段階の値（例：「ドラフト」、「進行中」）へのステータス変更を検出します。取得請求書のステータスがプロセスフローで後退します。イベントタイプ inferred
	請求書償却済み	債権をキャンセルする決定が下され、請求書は全額支払われることなくクローズされた。これは、請求プロセスの代替的で不成功な終結を表します。
その重要性貸倒れを追跡することは、収益損失を定量化し、不良債権に繋がる顧客や状況を特定するのに役立ちます。これは、財務健全性を監視するための重要な例外パスです。取得元 Invoiceオブジェクトのステータスフィールドが「償却済み」または「キャンセル済み - 不良債権」に更新されたときのタイムスタンプから推測されます。取得請求書のステータスフィールドが「償却済み」に変更されること。イベントタイプ inferred
	請求書却下	承認者が請求書を却下しました。通常はエラーや不一致が原因で、修正して再提出する必要があります。これは、請求書レコードのステータスが「却下済み」に変更されることで捕捉されます。
その重要性この活動は、手戻り作業とプロセスの非効率性を示します。却下の頻度を分析することで、共通のエラー原因を特定し、「請求プロセスにおける手戻りおよびエラー」ダッシュボードの根本原因分析をサポートします。取得元 Invoiceオブジェクトのステータスフィールドが「却下済み」に変更されたことから推測されます。このデータは、正式な承認プロセスの履歴内のコメントからも見つかる場合があります。取得請求書のステータスフィールドが「却下済み」に変更されること。イベントタイプ inferred

推奨任意

抽出ガイド

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

ステップ

前提条件の確認: Salesforceで、「レポートの実行」、「レポートの作成とカスタマイズ」、「レポートのエクスポート」を含む必要な権限があることを確認してください。InvoiceおよびPaymentオブジェクトの主要なステータスフィールドで項目履歴追跡が有効になっていることを確認してください。これを行うには、「設定」>「オブジェクトマネージャー」に移動し、関連するオブジェクトを見つけ、「項目とリレーション」に移動して「履歴の追跡設定」をクリックします。
レポート戦略の定義: このプロセスでは、アクティビティが異なるレコードまたはイベント（例：請求書作成、ステータス変更、関連する支払い）から発生するため、複数のレポートを作成する必要があります。個別のソースごとにレポートを作成し、その後、外部で結果を結合します。
レコード作成用のレポート作成: 最も単純なイベントから始めます。「請求書発行済み」と「顧客からの支払い受領」のレポートを作成します。「レポート」タブに移動し、「新規レポート」をクリックします。Invoiceオブジェクト（例：「請求書」）またはPaymentオブジェクトを含むレポートタイプを選択します。イベントログ属性に対応する列を追加します。「請求書発行済み」アクティビティの場合、請求書レコードのCreatedDateがEventTimeになります。
項目履歴用のレポート作成: 「承認のために請求書提出済み」、「請求書承認済み」、「請求書却下済み」、「請求書修正済み」のようなステータス変更を捕捉するには、「請求書履歴」レポートタイプに基づいてレポートを作成します。この特別なレポートタイプは、項目履歴追跡によって追跡された変更を公開します。このレポートをStatusフィールドの変更でフィルターします。
日付ベースのイベント用レポート作成: 「顧客への請求書送付」や「支払期日到来」のようなイベントの場合、Invoiceオブジェクトにレポートを作成します。Sent_Date__cやPayment_Due_Date__cなどの日付フィールド自体をEventTimeとして使用します。これらの日付がnullではないレコードをフィルターする必要があります。
関連アクティビティ用のレポート作成: 「支払い催促発行」のようなイベントの場合、アクティビティ（タスクまたはイベント）を請求書にリンクするレポートが必要です。「請求書に関するアクティビティ」のようなレポートタイプ、または作成したカスタムレポートタイプを使用します。リマインダーを示す特定の件名またはタイプのアクティビティをフィルターします。
すべてのレポートに標準列を追加: 作成する各レポートで、必須のイベントログ構造にマッピングできる列が追加されていることを確認してください: InvoiceNumber、EventTime用のフィールド（CreatedDateや項目変更日など）、UserResponsible（LastModifiedByIdなど）、およびその他の推奨される属性。
CSVへのレポートエクスポート: 各レポートを個別に実行します。レポート結果画面からドロップダウンメニューを使用して「エクスポート」を選択し、.csv拡張子の「詳細のみ」形式を選択します。作成したすべてのレポートに対してこれを繰り返します。
データの結合と変換: エクスポートされたCSVファイルをスプレッドシートプログラムで開くか、データ準備ツールを使用します。各ファイルについて、ActivityNameという名前の新しい列を追加し、それが表す特定のアクティビティ（例：最初のレポートのすべての行には「請求書発行済み」）を入力します。ソース列（例：Invoice: Created Date）を標準のイベントログヘッダー（EventTime）にマッピングします。
最終イベントログの作成: 個々のCSVファイルから変換されたすべてのデータを単一のマスターファイルに統合します。列ヘッダーがInvoiceNumber、ActivityName、EventTime、UserResponsibleなどと完全に一致していることを確認します。この統一されたファイルが最終的なイベントログです。
最終フォーマット: 統合されたファイルをUTF-8エンコーディングのCSVとして保存します。ファイルはこれでProcessMindにアップロードする準備ができました。

設定

レポートタイプ: 親オブジェクト（Accountなど）と子/孫オブジェクト（Invoice, Payment, Activityなど）を結合するために、複数のカスタムレポートタイプが必要になる場合があります。これらは「設定」>「レポートタイプ」で作成してください。
項目履歴追跡: これは非常に重要です。Invoiceオブジェクトの場合、Statusフィールドの履歴追跡を有効にしてください。これを有効にしないと、「承認済み」や「却下済み」といったステータス変更アクティビティを捕捉できません。履歴は遡って追跡されません。
データフィルター: データ量を管理しやすくするため、レポートには必ず日付フィルターを適用してください。推奨される方法としては、主オブジェクトの作成日を過去3〜6ヶ月でフィルターすることです（例：Invoice: Created DateがLAST 180 DAYSに等しい）。
データエクスポートサービス: 個々のレポートを実行する代わりに、標準のデータエクスポートサービス（「設定」>「データエクスポート」）を利用することもできます。このサービスは、組織のすべてのデータを週次または月次でエクスポートします。これにより完全なバックアップが提供されますが、データをイベントログにフィルター、結合、変換するためにかなりの後処理が必要です。
ユーザー権限: データ抽出を実行するユーザーには、レポートの作成およびエクスポート権限に加え、関連するすべてのオブジェクト（Account, Order, Invoice__c, Payment__c, Activityなど）とフィールドに対する読み取りアクセス権が必要です。

a クエリ例 config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

ステップ

前提条件とセットアップ: システムにPython 3.6以降がインストールされていることを確認してください。必要なライブラリは、ターミナルで次のコマンドを実行してインストールします: pip install simple-salesforce pandas。また、Salesforceのユーザー名、パスワード、セキュリティトークンも必要です。セキュリティトークンを取得するには、Salesforceにログインし、個人設定に移動して「セキュリティトークンのリセット」オプションを見つけてください。
項目履歴追跡の有効化: 管理者としてSalesforce組織にログインします。「設定」に進み、「オブジェクトマネージャー」を選択します。主要なInvoiceオブジェクト（例：Invoice__c）を見つけ、「項目とリレーション」に移動します。「履歴の追跡設定」をクリックします。請求書のステータスを表すフィールド（例：Status__c）の追跡を有効にします。Paymentオブジェクト（例：Payment__c）およびその対応するステータスフィールドに対してもこのプロセスを繰り返します。
スクリプトのダウンロードと設定: 提供されたPythonスクリプトをextract_invoices.pyという名前のファイルとして保存します。テキストエディタでファイルを開き、「Salesforce Credentials and Settings」セクションのプレースホルダー値を更新します。SF_USERNAME、SF_PASSWORD、SF_SECURITY_TOKEN、SF_INSTANCE_URLを提供する必要があります。抽出期間を定義するためにSTART_DATEとEND_DATEを調整してください。
オブジェクトおよび項目名のカスタマイズ: スクリプト内のSOQLクエリを注意深く確認してください。スクリプトは、Invoice__c、Payment__c、Status__c、Total_Amount__cなどのプレースホルダー名を使用しています。これらを、Salesforceインスタンスで請求と入金に使用されているオブジェクトおよびフィールドの実際のAPI名に置き換える必要があります。これらはSalesforceの「設定」の「オブジェクトマネージャー」で確認できます。
抽出スクリプトの実行: ターミナルまたはコマンドプロンプトを開き、スクリプトを保存したディレクトリに移動して、コマンドpython extract_invoices.pyを実行します。スクリプトはSalesforce APIに接続し、クエリを実行してデータを処理します。
スクリプトの進行状況の監視: スクリプトは、各アクティビティタイプのデータをフェッチおよび処理する際に、ステータスメッセージをコンソールに表示します。データ量とAPI制限によっては、時間がかかる場合があります。誤った認証情報やAPI名を示す可能性のあるエラーメッセージに注意してください。
出力ファイルの確認: スクリプトが正常に完了すると、同じディレクトリにsalesforce_billing_event_log.csvという名前のファイルが生成されます。スプレッドシートプログラムでこのCSVファイルを開き、その内容を確認して、期待されるデータが含まれていることを検証します。
アップロードの準備: 生成されたCSVファイルは、InvoiceNumber、ActivityName、EventTimeという必須列と、その他の推奨属性で構成されています。このファイルは、追加のフォーマットなしでプロセスマイニングツールに直接アップロードする準備ができています。

設定

Salesforce資格情報: Salesforceのユーザー名、パスワード、およびセキュリティトークンを提供する必要があります。組織の信頼できるIP範囲外からのAPIアクセスにはセキュリティトークンが必要です。
SalesforceインスタンスURL: your_instance.my.salesforce.comのようなSalesforceインスタンスのドメインを指定してください。サンドボックスを使用している場合、URLはtest.salesforce.comのように異なります。
日付範囲フィルター: スクリプトにはSTART_DATEとEND_DATE変数が含まれています。データ量を管理し、API制限に収まるように、まずは3〜6ヶ月のような短い期間から始めることをお勧めします。これらの日付は、請求書作成日の初期クエリをフィルターします。
オブジェクトおよび項目API名: このスクリプトは、Invoice__cやStatus__cのようなオブジェクトやフィールドのプレースホルダーAPI名で構築されています。これらをSalesforceデータモデルの正確なAPI名に置き換える必要があります。これらはSalesforceの「設定」>「オブジェクトマネージャー」で見つけることができます。
追跡の前提条件: イベントログの正確性、特にステータス変更に関するものは、取引が発生する前に関連フィールドでSalesforceの項目履歴追跡が有効になっているかどうかに完全に依存します。有効になっていなかった場合、過去の変更は捕捉されません。
APIコール制限: Salesforceは、24時間あたりに実行できるAPIコールの数にガバナ制限を設けています。非常に大規模なデータセットの場合、これらの制限に達するのを避けるため、抽出をより小さい日付範囲のバッチで実行するか、オフピーク時にスケジュールすることを検討してください。

a クエリ例 python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Salesforce Credentials and Settings ---
class=class="hl-string">"hl-comment"># IMPORTANT: Replace all placeholder values with your actual Salesforce information.
SF_USERNAME = class="hl-string">'[your_salesforce_username]'
SF_PASSWORD = class="hl-string">'[your_salesforce_password]'
SF_SECURITY_TOKEN = class="hl-string">'[your_salesforce_security_token]' class=class="hl-string">"hl-comment"># Append this to your password if required
SF_INSTANCE_URL = class="hl-string">'https://[your_instance].my.salesforce.com' class=class="hl-string">"hl-comment"># e.g., na1.salesforce.com

class=class="hl-string">"hl-comment"># --- Extraction Period ---
START_DATE = class="hl-string">'2023-01-01T00:00:00Z'
END_DATE = class="hl-string">'2023-12-31T23:59:59Z'

class=class="hl-string">"hl-comment"># --- Object and Field API Name Placeholders ---
class=class="hl-string">"hl-comment"># Replace these with the actual API names from your Salesforce org.
INVOICE_OBJECT = class="hl-string">'Invoice__c'
INVOICE_NUMBER_FIELD = class="hl-string">'Name'
INVOICE_STATUS_FIELD = class="hl-string">'Status__c'
INVOICE_TOTAL_AMOUNT_FIELD = class="hl-string">'Total_Amount__c'
INVOICE_DUE_DATE_FIELD = class="hl-string">'Due_Date__c'

PAYMENT_OBJECT = class="hl-string">'Payment__c'
PAYMENT_INVOICE_LOOKUP_FIELD = class="hl-string">'Invoice__c' class=class="hl-string">"hl-comment"># Lookup field from Payment to Invoice
PAYMENT_STATUS_FIELD = class="hl-string">'Status__c'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    print(class="hl-string">"Connecting to Salesforce...")
    sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
    print(class="hl-string">"Connection successful.")

    all_events = []

    class=class="hl-string">"hl-comment"># 1. Get base Invoice data
    print(class="hl-string">"Fetching base invoice data...")
    soql_invoices = fclass="hl-string">"""
        SELECT Id, {INVOICE_NUMBER_FIELD}, CreatedDate, CreatedById, LastModifiedById, 
               {INVOICE_STATUS_FIELD}, {INVOICE_TOTAL_AMOUNT_FIELD}, {INVOICE_DUE_DATE_FIELD}
        FROM {INVOICE_OBJECT}
        WHERE CreatedDate >= {START_DATE} AND CreatedDate <= {END_DATE}
    """
    invoices_data = sf.query_all(soql_invoices)[class="hl-string">'records']
    df_invoices = pd.DataFrame(invoices_data).drop(columns=[class="hl-string">'attributes'])
    invoice_ids = class="hl-string">"','".join(df_invoices[class="hl-string">'Id'].tolist())

    class=class="hl-string">"hl-comment"># Activity: Invoice Generated & Payment Due Date Reached
    print(class="hl-string">"Processing 'Invoice Generated' and 'Payment Due Date Reached' events...")
    generated_events = df_invoices.copy()
    generated_events[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
    generated_events[class="hl-string">'EventTime'] = pd.to_datetime(generated_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
    generated_events[class="hl-string">'UserResponsible'] = generated_events[class="hl-string">'CreatedById']
    all_events.append(generated_events)

    due_date_events = df_invoices[df_invoices[INVOICE_DUE_DATE_FIELD].notna()].copy()
    due_date_events[class="hl-string">'ActivityName'] = class="hl-string">'Payment Due Date Reached'
    due_date_events[class="hl-string">'EventTime'] = pd.to_datetime(due_date_events[INVOICE_DUE_DATE_FIELD]).dt.tz_localize(None)
    due_date_events[class="hl-string">'UserResponsible'] = None class=class="hl-string">"hl-comment"># System-generated event
    all_events.append(due_date_events)

    class=class="hl-string">"hl-comment"># 2. Get Invoice Status Changes from Field History
    print(class="hl-string">"Fetching invoice status changes...")
    soql_invoice_history = fclass="hl-string">"""
        SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
        FROM {INVOICE_OBJECT}History
        WHERE ParentId IN ('{invoice_ids}') AND Field = '{INVOICE_STATUS_FIELD}'
    """
    invoice_history_data = sf.query_all(soql_invoice_history)[class="hl-string">'records']
    if invoice_history_data:
        df_invoice_history = pd.DataFrame(invoice_history_data).drop(columns=[class="hl-string">'attributes'])
        df_invoice_history = df_invoice_history.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id')
        df_invoice_history[class="hl-string">'EventTime'] = pd.to_datetime(df_invoice_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_invoice_history[class="hl-string">'UserResponsible'] = df_invoice_history[class="hl-string">'CreatedById']

        class=class="hl-string">"hl-comment"># Map status changes to Activity Names
        status_map = {
            (class="hl-string">'Draft', class="hl-string">'Pending Approval'): class="hl-string">'Invoice Submitted for Approval',
            (class="hl-string">'Pending Approval', class="hl-string">'Approved'): class="hl-string">'Invoice Approved',
            (class="hl-string">'Pending Approval', class="hl-string">'Rejected'): class="hl-string">'Invoice Rejected',
            (class="hl-string">'Rejected', class="hl-string">'Draft'): class="hl-string">'Invoice Corrected',
            (class="hl-string">'Approved', class="hl-string">'Sent'): class="hl-string">'Invoice Sent to Customer',
            (class="hl-string">'Approved', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Sent', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Approved', class="hl-string">'Written Off'): class="hl-string">'Invoice Written Off'
        }
        df_invoice_history[class="hl-string">'ActivityName'] = df_invoice_history.apply(lambda row: status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
        df_invoice_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
        all_events.append(df_invoice_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># 3. Get Payment Reminders from Tasks
    print(class="hl-string">"Fetching payment reminder tasks...")
    soql_tasks = fclass="hl-string">"""
        SELECT WhatId, ActivityDate, CreatedById, CreatedDate
        FROM Task
        WHERE WhatId IN ('{invoice_ids}') AND Subject LIKE '%Payment Reminder%'
    """
    task_data = sf.query_all(soql_tasks)[class="hl-string">'records']
    if task_data:
        df_tasks = pd.DataFrame(task_data).drop(columns=[class="hl-string">'attributes'])
        df_tasks = df_tasks.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_STATUS_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'WhatId', right_on=class="hl-string">'Id')
        df_tasks[class="hl-string">'ActivityName'] = class="hl-string">'Payment Reminder Issued'
        df_tasks[class="hl-string">'EventTime'] = pd.to_datetime(df_tasks[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_tasks[class="hl-string">'UserResponsible'] = df_tasks[class="hl-string">'CreatedById']
        all_events.append(df_tasks)

    class=class="hl-string">"hl-comment"># 4. Get Payment Data
    print(class="hl-string">"Fetching payment data...")
    soql_payments = fclass="hl-string">"""
        SELECT Id, {PAYMENT_INVOICE_LOOKUP_FIELD}, CreatedDate, CreatedById, LastModifiedById, {PAYMENT_STATUS_FIELD}
        FROM {PAYMENT_OBJECT}
        WHERE {PAYMENT_INVOICE_LOOKUP_FIELD} IN ('{invoice_ids}')
    """
    payment_data = sf.query_all(soql_payments)[class="hl-string">'records']
    if payment_data:
        df_payments = pd.DataFrame(payment_data).drop(columns=[class="hl-string">'attributes'])
        df_payments = df_payments.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=PAYMENT_INVOICE_LOOKUP_FIELD, right_on=class="hl-string">'Id', suffixes=(class="hl-string">'_payment', class="hl-string">'_invoice'))
        payment_ids = class="hl-string">"','".join(df_payments[class="hl-string">'Id_payment'].tolist())
        
        class=class="hl-string">"hl-comment"># Activity: Customer Payment Received
        payment_received_events = df_payments.copy()
        payment_received_events[class="hl-string">'ActivityName'] = class="hl-string">'Customer Payment Received'
        payment_received_events[class="hl-string">'EventTime'] = pd.to_datetime(payment_received_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        payment_received_events[class="hl-string">'UserResponsible'] = payment_received_events[class="hl-string">'CreatedById']
        all_events.append(payment_received_events)
        
        class=class="hl-string">"hl-comment"># 5. Get Payment Status Changes
        print(class="hl-string">"Fetching payment status changes...")
        soql_payment_history = fclass="hl-string">"""
            SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
            FROM {PAYMENT_OBJECT}History
            WHERE ParentId IN ('{payment_ids}') AND Field = '{PAYMENT_STATUS_FIELD}'
        """
        payment_history_data = sf.query_all(soql_payment_history)[class="hl-string">'records']
        if payment_history_data:
            df_payment_history = pd.DataFrame(payment_history_data).drop(columns=[class="hl-string">'attributes'])
            df_payment_history = df_payment_history.merge(df_payments[[class="hl-string">'Id_payment', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id_payment')
            df_payment_history[class="hl-string">'EventTime'] = pd.to_datetime(df_payment_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df_payment_history[class="hl-string">'UserResponsible'] = df_payment_history[class="hl-string">'CreatedById']

            payment_status_map = {
                (class="hl-string">'Received', class="hl-string">'Posted'): class="hl-string">'Payment Posted to Ledger',
                (class="hl-string">'Posted', class="hl-string">'Reconciled'): class="hl-string">'Cash Applied/Reconciled'
            }
            df_payment_history[class="hl-string">'ActivityName'] = df_payment_history.apply(lambda row: payment_status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
            df_payment_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
            all_events.append(df_payment_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># --- Final Assembly ---
    print(class="hl-string">"Assembling final event log...")
    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Standardize column names
    final_df.rename(columns={
        INVOICE_NUMBER_FIELD: class="hl-string">'InvoiceNumber',
        INVOICE_STATUS_FIELD: class="hl-string">'InvoiceStatus',
        INVOICE_TOTAL_AMOUNT_FIELD: class="hl-string">'InvoiceTotalAmount',
        INVOICE_DUE_DATE_FIELD: class="hl-string">'PaymentDueDate'
    }, inplace=True)

    class=class="hl-string">"hl-comment"># Select and order columns for the final event log
    required_cols = {
        class="hl-string">'InvoiceNumber': None,
        class="hl-string">'ActivityName': None,
        class="hl-string">'EventTime': None,
        class="hl-string">'UserResponsible': None,
        class="hl-string">'InvoiceStatus': None,
        class="hl-string">'InvoiceTotalAmount': None,
        class="hl-string">'PaymentDueDate': None
    }
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = required_cols[col]
    
    class=class="hl-string">"hl-comment"># We cannot extract Billing Department directly from this model, so we will add it as an empty column
    final_df[class="hl-string">'BillingDepartment'] = None

    final_df = final_df[list(required_cols.keys()) + [class="hl-string">'BillingDepartment']]

    class=class="hl-string">"hl-comment"># Sort by case and event time
    final_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'salesforce_billing_event_log.csv'
    final_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Event log saved to {output_filename}")

if __name__ == class="hl-string">'__main__':
    main()

ステップ

前提条件の確認: Salesforceで、「レポートの実行」、「レポートの作成とカスタマイズ」、「レポートのエクスポート」を含む必要な権限があることを確認してください。InvoiceおよびPaymentオブジェクトの主要なステータスフィールドで項目履歴追跡が有効になっていることを確認してください。これを行うには、「設定」>「オブジェクトマネージャー」に移動し、関連するオブジェクトを見つけ、「項目とリレーション」に移動して「履歴の追跡設定」をクリックします。
レポート戦略の定義: このプロセスでは、アクティビティが異なるレコードまたはイベント（例：請求書作成、ステータス変更、関連する支払い）から発生するため、複数のレポートを作成する必要があります。個別のソースごとにレポートを作成し、その後、外部で結果を結合します。
レコード作成用のレポート作成: 最も単純なイベントから始めます。「請求書発行済み」と「顧客からの支払い受領」のレポートを作成します。「レポート」タブに移動し、「新規レポート」をクリックします。Invoiceオブジェクト（例：「請求書」）またはPaymentオブジェクトを含むレポートタイプを選択します。イベントログ属性に対応する列を追加します。「請求書発行済み」アクティビティの場合、請求書レコードのCreatedDateがEventTimeになります。
項目履歴用のレポート作成: 「承認のために請求書提出済み」、「請求書承認済み」、「請求書却下済み」、「請求書修正済み」のようなステータス変更を捕捉するには、「請求書履歴」レポートタイプに基づいてレポートを作成します。この特別なレポートタイプは、項目履歴追跡によって追跡された変更を公開します。このレポートをStatusフィールドの変更でフィルターします。
日付ベースのイベント用レポート作成: 「顧客への請求書送付」や「支払期日到来」のようなイベントの場合、Invoiceオブジェクトにレポートを作成します。Sent_Date__cやPayment_Due_Date__cなどの日付フィールド自体をEventTimeとして使用します。これらの日付がnullではないレコードをフィルターする必要があります。
関連アクティビティ用のレポート作成: 「支払い催促発行」のようなイベントの場合、アクティビティ（タスクまたはイベント）を請求書にリンクするレポートが必要です。「請求書に関するアクティビティ」のようなレポートタイプ、または作成したカスタムレポートタイプを使用します。リマインダーを示す特定の件名またはタイプのアクティビティをフィルターします。
すべてのレポートに標準列を追加: 作成する各レポートで、必須のイベントログ構造にマッピングできる列が追加されていることを確認してください: InvoiceNumber、EventTime用のフィールド（CreatedDateや項目変更日など）、UserResponsible（LastModifiedByIdなど）、およびその他の推奨される属性。
CSVへのレポートエクスポート: 各レポートを個別に実行します。レポート結果画面からドロップダウンメニューを使用して「エクスポート」を選択し、.csv拡張子の「詳細のみ」形式を選択します。作成したすべてのレポートに対してこれを繰り返します。
データの結合と変換: エクスポートされたCSVファイルをスプレッドシートプログラムで開くか、データ準備ツールを使用します。各ファイルについて、ActivityNameという名前の新しい列を追加し、それが表す特定のアクティビティ（例：最初のレポートのすべての行には「請求書発行済み」）を入力します。ソース列（例：Invoice: Created Date）を標準のイベントログヘッダー（EventTime）にマッピングします。
最終イベントログの作成: 個々のCSVファイルから変換されたすべてのデータを単一のマスターファイルに統合します。列ヘッダーがInvoiceNumber、ActivityName、EventTime、UserResponsibleなどと完全に一致していることを確認します。この統一されたファイルが最終的なイベントログです。
最終フォーマット: 統合されたファイルをUTF-8エンコーディングのCSVとして保存します。ファイルはこれでProcessMindにアップロードする準備ができました。

設定

レポートタイプ: 親オブジェクト（Accountなど）と子/孫オブジェクト（Invoice, Payment, Activityなど）を結合するために、複数のカスタムレポートタイプが必要になる場合があります。これらは「設定」>「レポートタイプ」で作成してください。
項目履歴追跡: これは非常に重要です。Invoiceオブジェクトの場合、Statusフィールドの履歴追跡を有効にしてください。これを有効にしないと、「承認済み」や「却下済み」といったステータス変更アクティビティを捕捉できません。履歴は遡って追跡されません。
データフィルター: データ量を管理しやすくするため、レポートには必ず日付フィルターを適用してください。推奨される方法としては、主オブジェクトの作成日を過去3〜6ヶ月でフィルターすることです（例：Invoice: Created DateがLAST 180 DAYSに等しい）。
データエクスポートサービス: 個々のレポートを実行する代わりに、標準のデータエクスポートサービス（「設定」>「データエクスポート」）を利用することもできます。このサービスは、組織のすべてのデータを週次または月次でエクスポートします。これにより完全なバックアップが提供されますが、データをイベントログにフィルター、結合、変換するためにかなりの後処理が必要です。
ユーザー権限: データ抽出を実行するユーザーには、レポートの作成およびエクスポート権限に加え、関連するすべてのオブジェクト（Account, Order, Invoice__c, Payment__c, Activityなど）とフィールドに対する読み取りアクセス権が必要です。

a クエリ例 config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

受注から入金まで（Order to Cash） - 請求と会計の属性

受注から入金まで（Order to Cash） - 請求と会計の活動

抽出ガイド

Salesforceレポートビルダーとデータエクスポートサービス

ステップ

設定

a クエリ例 config

Salesforce REST APIを利用したPythonスクリプト

ステップ

設定

a クエリ例 python

事前に構築されたSalesforceコネクタを介したETLツール抽出

ステップ

設定

a クエリ例 config

今すぐ始めますか？

支払い加速：O2C請求・入金プロセスを今すぐ最適化

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

貴社の受注から入金まで（Order to Cash） - 請求と会計データテンプレート

受注から入金まで（Order to Cash） - 請求と会計の属性

受注から入金まで（Order to Cash） - 請求と会計の活動

抽出ガイド

Salesforceレポートビルダーとデータエクスポートサービス

ステップ

設定

a クエリ例 config

Salesforce REST APIを利用したPythonスクリプト

ステップ

設定

a クエリ例 python

事前に構築されたSalesforceコネクタを介したETLツール抽出

ステップ

設定

a クエリ例 config

お客様のプライバシーを大切にしています

今すぐ始めますか？

支払い加速：O2C請求・入金プロセスを今すぐ最適化