> 継続的なプロセス改善 > 与信管理・債権回収 > HighRadius > データテンプレート

債権管理・回収データテンプレート

HighRadius

与信管理・債権回収属性 (22) 与信管理・債権回収アクティビティ (15) 抽出ガイド (2)

債権管理・回収データテンプレート

このテンプレートは、貴社の債権管理・回収プロセスを分析するために必要なデータを収集するための構造化されたガイドを提供します。捕捉すべき必須属性、追跡すべき主要活動を概説し、HighRadiusシステムからこの情報を抽出する方法に関する実用的なガイダンスを提供します。このテンプレートを使用することで、プロセスマイニングのためにデータを効率的に準備するのに役立ちます。

収集を推奨する項目
プロセスの可視化のために追跡すべき主要アクティビティ
HighRadius固有の抽出ガイド

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

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

与信管理・債権回収属性

これらは、債権管理・回収プロセスを包括的に分析するために、イベントログに含めることが推奨されるデータフィールドです。

3 必須 7 推奨 12 任意

	名前	説明
	アクティビティ名 ActivityName	請求書に対してある時点で発生した特定のビジネスイベントの名前。
説明アクティビティ名には、「請求書生成」、「延滞督促通知送信済み」、「支払受領」など、与信および回収プロセスにおけるステップが記述されます。この一連の活動が、各ケースのプロセスフローを形成します。この属性を分析することで、実際のプロセスマップを発見し、可視化することができます。ボトルネック、標準手順からの逸脱、および手戻りのループを特定するのに役立ちます。「督促電話記録」や「紛争登録」のような活動の頻度と順序は、プロセス効率を理解する上で重要です。その重要性この属性はプロセス内のステップを定義し、各請求書のプロセスフローの再構築と分析を可能にします。取得元これは通常、HighRadiusプラットフォームの様々なモジュール内のイベントログ、ステータス変更、または特定の行動記録から導出されます。例顧客へ請求書送付済み督促手続き開始入金確認済み紛争解決済み
	イベント日時 EventTime	活動が発生した日時を示すタイムスタンプ（日付と時刻を含む）。
説明イベントタイムは、プロセス内の各アクティビティの正確な日付と時間を提供します。この時系列データはプロセスマイニングの根幹であり、イベントの正しい順序付けとそれらの間の期間の計算を可能にします。この属性は、異議解決、与信承認、支払記帳などのサイクルタイムを含む、すべての時間ベースのKPIを計算するために使用されます。また、時間の経過に伴うプロセスパフォーマンスの分析、遅延を引き起こすアクティビティの特定、サービスレベルアグリーメントへの遵守状況の測定にも使用されます。その重要性すべての活動の時系列的な文脈を提供し、サイクルタイムの計算、ボトルネックの発見、プロセスダイナミクスの理解に不可欠です。取得元 HighRadius内のすべての取引記録またはイベントログには、通常「作成日」または「タイムスタンプ」という名前の対応するタイムスタンプフィールドが必要です。例 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	請求書番号 InvoiceNumber	各請求書の一意の識別子であり、与信から現金化プロセスにおける主要なケース識別子として機能します。
説明請求書番号は、単一の売掛金取引に関連するすべてのアクティビティをリンクする中心的なキーです。これにより、請求書生成から、様々な債権管理および回収活動を経て、最終決済または償却までの全ライフサイクルを追跡することができます。プロセスマイニング分析において、この属性はすべての関連イベントを単一のケースにグループ化するために不可欠です。これにより、エンドツーエンドのプロセスフローの可視化、売上債権回転日数（DSO）のようなケース期間の計算、および紛争解決や督促手続きなど、請求書が取りうる異なる経路の分析が可能になります。その重要性すべてのプロセスステップを結びつける基本的な識別子であり、請求書の作成から完了までの完全な過程を分析することを可能にします。取得元これはHighRadiusの主要フィールドであり、通常、コア請求書または売掛金データオブジェクトに含まれています。例 INV-2023-001239876543210SI-55482
	回収担当者名 CollectorName	回収活動の実行を担当したユーザーまたは担当者の名前。
説明この属性は、「督促電話記録」や「紛争解決」などの手動活動を実行した回収担当者、与信アナリスト、またはその他のユーザーを特定します。分析において、これは異なる回収担当者やチーム間のパフォーマンス比較を可能にします。ワークロードの分散を理解し、個々の戦略の有効性を評価（例：回収担当者ごとの回収電話成功率）し、コーチングの機会を特定するのに役立ちます。また、リソース管理とキャパシティプランニングにおいても重要です。その重要性プロセス活動を特定の個人に紐付け、チームのパフォーマンス、ワークロード、手動介入の有効性を分析することを可能にします。取得元この情報は通常、HighRadiusコレクションモジュール内の活動ログまたはユーザーアクション記録に保存されます。例 John Smithジェーン・ドウエミリー・ジョーンズ
	支払ステータス PaymentStatus	請求書の現在の財務ステータス（オープン、支払い済み、延滞、紛争中など）。
説明支払ステータスは、請求書がライフサイクルのどの段階にあるかのスナップショットを提供します。まだ支払待ちか、全額または一部支払済みか、支払期日を過ぎているか、あるいは紛争のために調査中であるかを示します。この属性は、「請求書支払ステータスと滞留」ダッシュボードの中心となります。これにより、売掛金ポートフォリオを迅速にセグメンテーションし、全体的な財務健全性を把握し、延滞または紛争中の項目に対する回収努力の優先順位付けを行うことができます。その重要性請求書を実行可能なグループに分類し、売掛金の状態を即座に可視化し、債権回収活動の優先順位付けに役立ちます。取得元これは、HighRadius内の請求書または売掛金レコードにおける主要なステータスフィールドです。例オープン支払い済み期限超過異議あり償却済み
	支払期日 DueDate	請求書支払いが期日となる計算された日付。
説明期日は、請求書が延滞と見なされるのを避けるために支払われるべき特定のカレンダー日付です。通常、請求書発行日と支払条件から計算されます。この属性は、すべての延滞分析にとって不可欠です。「延滞日数」の計算、督促手続きのトリガー、および「支払条件遵守率」KPIの測定のための主要な入力となります。請求書滞留分析と督促効果に関連するダッシュボードを直接サポートします。その重要性請求書が期限内か延滞かを判断し、その後のすべての債権回収活動とKPIをトリガーする重要な日付です。取得元これはHighRadiusの請求書レコードにおける標準フィールドです。ソースERPから取り込まれるか、HighRadius内で計算される場合があります。例 2023-04-142023-05-312023-06-20
	支払条件 PaymentTerms	顧客が請求書をいつ支払うべきかを定める合意された条件。
説明支払条件は、「Net 30」、「Net 60」、「受領時支払い」などの支払いの条件を定めます。この属性は、請求書の支払期日を計算するための基礎となります。これは、「支払条件遵守」ダッシュボードとKPIにとって重要な属性です。これを分析することで、標準条件が一貫して適用されているか、また、どの支払条件が延滞率の高さに関連しているかを特定するのに役立ちます。この洞察は、与信ポリシーや顧客交渉に情報を提供することができます。その重要性期待される支払いタイムラインの基準を設定し、期日の計算や顧客の支払い合意遵守状況の測定に不可欠です。取得元これは通常、HighRadiusまたはソースERP内の請求書ヘッダーまたは顧客マスターデータに含まれています。例支払条件：正味30日支払条件：正味60日受領時支払い
	紛争理由 DisputeReason	顧客が請求書に異議を唱えた際に提供される理由コードまたは説明。
説明顧客が紛争を提起する際、通常、「誤った価格設定」、「損傷した商品」、「重複請求書」などの理由を提供します。この属性はその理由を捕捉します。紛争理由の分析は、「請求書紛争解決時間」ダッシュボードの鍵となります。紛争の根本原因を特定するのに役立ち、企業が価格設定、配送、または請求におけるシステム的な問題に対処することを可能にします。発生源での紛争削減は、キャッシュフローを大幅に加速できる可能性があります。その重要性支払い遅延の根本原因に関する洞察を提供し、将来の異議を防止するための的を絞ったプロセス改善を可能にします。取得元この情報は、紛争が記録された際にHighRadiusの紛争管理または控除モジュールで捕捉されます。例数量の誤り価格不一致破損品重複請求
	請求金額 InvoiceAmount	請求書の合計金額。
説明この属性は、請求書に記載された合計金額を表します。これは、各ケースに関連する価値を理解するための重要な財務指標です。プロセスマイニングでは、請求金額は、例えば高額の延滞請求書に焦点を当てることで、回収努力の優先順位付けに利用されます。売上債権回転日数（DSO）のような財務KPIの基礎であり、「請求書償却分析」ダッシュボードで不良債権の財務的影響を定量化するために使用されます。その重要性各ケースの財務的文脈を提供し、価値に基づく分析、作業の優先順位付け、および償却のような財務的影響の定量化を可能にします。取得元これはHighRadius内の請求書ヘッダーデータにおける標準フィールドです。例 5000.001250.7525000.50
	顧客ID CustomerId	請求書に関連付けられた顧客の一意の識別子。
説明顧客IDは、請求書を特定の顧客エンティティにリンクします。これにより、顧客中心の視点からプロセスデータを集計し分析することが可能になります。この属性は、異なる顧客または顧客セグメントの支払い行動を分析するために不可欠です。どの顧客が頻繁に遅延しているか、どの顧客が最も多くの紛争を提起しているかといった問いに答えるのに役立ちます。支払条件遵守のようなダッシュボードをサポートし、KPIを顧客別にセグメンテーションすることを可能にします。その重要性顧客レベルでの支払い行動、異議の頻度、および全体的なプロセスインタラクションの分析を可能にし、債権回収戦略の調整に役立ちます。取得元これはHighRadius内の請求書ヘッダーまたは顧客口座データにおける標準フィールドです。例 CUST-001ACME-CORPGLOBEX-US
	`督促``レベル` DunningLevel	延滞請求書に対して達成された自動督促プロセスの段階またはレベル。
説明督促レベルは、回収努力の強度を示し、多くの場合、顧客に送信される自動通知や連絡のシーケンスに対応します。例えば、レベル1は穏やかなリマインダーである一方、レベル3は最終通知である場合があります。この属性は、「督促戦略有効性」ダッシュボードにとって不可欠です。どの督促レベルが最も頻繁に支払いに繋がるかを分析することで、企業は督促ワークフローを最適化し、過度に攻撃的にならずに顧客関係を損なうことなく、効果を確保できます。その重要性債権回収活動のエスカレーションを追跡し、どの督促戦略が支払いを促す上で最も効果的であるかを分析することを可能にします。取得元これは、HighRadius内の自動回収または督促ワークフローエンジンによって管理されるステータスフィールドです。例 123 - 最終通知法的手続きによる債権回収
	ソースシステム SourceSystem	データが生成されたシステム。
説明この属性は、イベントデータが生成されたソースシステムを特定します。このプロセスビューでは、値は通常「HighRadius」になります。複数のシステムがある環境では、このフィールドはデータ系列を理解し、情報をその発生源まで追跡するために不可欠です。ERPや専門的な回収ツールなど、異なるプラットフォームにまたがるプロセスを区別するのに役立ちます。その重要性データの出所を明確にし、データガバナンス、検証、およびプロセスの技術的ランドスケープの理解にとって重要です。取得元これは通常、データセットをラベル付けするためにデータ抽出および変換プロセス中に加えられる静的な値です。例 HighRadiusHighRadius-CollectionsHighRadius-CashApp
	ビジネスユニット BusinessUnit	販売または請求書の責任を負う社内の事業部門または課。
説明事業部門属性は、請求書を「小売」、「卸売」、「サービス」など、組織の特定の部門に割り当てます。これにより、異なる事業セグメントごとに業績分析を行うことができます。経営陣は、事業部門間でDSO、紛争率、償却額などのKPIを比較し、優れた領域や改善が必要な領域を特定できます。これは、組織の各部門に売掛金パフォーマンスの責任を負わせるのに役立ちます。その重要性組織の異なる部門間でのパフォーマンスベンチマークを可能にし、どの部門が最も効果的なクレジット・トゥ・キャッシュプロセスを持っているかを特定するのに役立ちます。取得元これは組織データであり、通常はHighRadiusまたはERP内の請求書上、または関連する販売注文や顧客口座から派生します。例 BU-North Americaサービス部門製造業
	償却理由 WriteOffReason	請求書が不良債権として償却された理由コードまたは説明。
説明請求書が回収不能と判断された場合、それは償却されます。この属性は、「顧客破産」、「未解決紛争」、「少額残高償却」など、償却の理由を捕捉します。これは、「請求書償却分析」ダッシュボードにとって重要な属性です。財務損失の根本原因分析に役立ち、与信ポリシーの洗練、紛争処理の改善、または将来の償却を最小限に抑えるための回収戦略の調整に使用できる洞察を提供します。その重要性収益損失の理由を説明し、与信リスク評価と回収ポリシーを改善するための重要なフィードバックを提供します。取得元この情報は、「請求書償却」活動が処理された際、通常HighRadiusの財務または回収モジュール内で記録されます。例倒産時効満了回収コストが債務額を超える
	最終データ更新 LastDataUpdate	このレコードのデータがソースシステムから最後に更新されたときのタイムスタンプ。
説明この属性は、データの最新性を示します。HighRadiusからの最終データ抽出または更新の日時を記録します。分析において、このフィールドは洞察の鮮度に関するコンテキストを提供します。ダッシュボードやレポートで情報がどれだけ最新であるかを表示するために不可欠であり、ビジネス上の意思決定が最新のデータに基づいていることを保証します。その重要性データの適時性に関する透明性を提供し、分析への信頼を築き、情報に基づいた意思決定を行う上で不可欠です。取得元このタイムスタンプは、抽出プロセス中にデータインジェストパイプラインによって各レコードに生成され、追加されます。例 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	処理時間 ProcessingTime	単一のアクティビティの期間。終了時刻と開始時刻の差として計算されます。
説明処理時間は、特定のタスクに積極的に費やされた時間を測定します。多くの回収活動では、これらは瞬間的なイベントであるためゼロとなります。しかし、明確な開始と終了を持つタスクについては、貴重な洞察を提供します。この指標は、活動間の待機時間ではなく、どの具体的な活動が最も時間を消費しているかを特定するのに役立ちます。例えば、紛争案件が積極的に処理されている時間を測定できます。これにより、個々のタスクの実行方法に対して、より的を絞った改善が可能になります。その重要性付加価値のある作業の期間を待機時間から切り離し、特定のプロセスステップ内の非効率性を特定するのに役立ちます。取得元これはデータ変換プロセス中に「EndTime」-「StartTime」として計算されます。両方のフィールドが利用可能で意味がある場合にのみ計算できます。例 8640036000
	国 Country	請求書に関連する顧客の国。
説明この属性は、顧客が所在する国を特定します。これにより、与信および回収プロセスの地理的セグメンテーションが可能になります。国別データを分析することで、支払い行動、回収戦略の有効性、および一般的な紛争理由における地域差を明らかにすることができます。この情報は、地域政策の調整やグローバル組織における高レベルの経営報告に不可欠です。その重要性地理的分析を可能にし、支払い行動における地域的な傾向を明らかにし、それに応じて債権回収戦略を調整するのに役立ちます。取得元この情報は顧客マスターデータの一部であり、通常HighRadiusで利用可能か、ソースERPから同期されます。例米国ドイツブラジル
	延滞日数 DaysOverdue	請求書が期日を過ぎてからの日数。請求書がまだ期日でないか、または期日内に支払われた場合はゼロです。
説明「期日超過日数」は、現在の日付（未払い請求書の場合）または支払い日（支払い済み請求書の場合）と請求書の期日との差を測定する計算指標です。これは支払い延滞の主要な指標となります。この属性は、「請求書支払いステータスと滞留分析」ダッシュボードの基盤であり、売掛金を滞留期間（例：1～30日、31～60日）にグループ分けするために使用されます。また、売掛金回収期間（DSO）計算の構成要素でもあり、最も延滞しているアカウントに対する回収業務を優先するのに役立ちます。その重要性この指標は支払いの遅延を直接定量化するため、滞留分析、回収の優先順位付け、およびDSOの計算に不可欠です。取得元これは保存されたフィールドではありません。データ変換中に期日と支払日または現在の日付を使用して計算されます。例 1545092
	支払い確約日 PromiseToPayDate	顧客が延滞請求書の支払いを約束した日付。
説明回収担当者が顧客に連絡した際、「支払い約束」を取り付けることがあります。これは、顧客が特定の日付までに支払うというコミットメントです。この属性はその約束日を記録します。このデータを分析することは、顧客の約束の信頼性と、回収担当者が確固たる約束を確保する上での有効性を評価するために重要です。回収チームの主要業績評価指標である「約束遵守率」を追跡するために使用できます。その重要性これは債権回収活動の主要な成果を捉え、フォローアップの有効性および顧客の約束の信頼性を測定するために使用されます。取得元この日付は、「支払い約束」活動がHighRadiusコレクションモジュールに記録された際に記録されます。例 2023-06-152023-07-012023-06-25
	終了日時 EndTime	アクティビティの完了時刻を示すタイムスタンプ。
説明終了時刻は、活動の完了を示します。回収における多くの活動は、開始時刻と終了時刻が同じ瞬間的なイベントですが、「紛争解決」のような一部の活動は明確な期間を持つ場合があります。この属性は、利用可能な場合、開始時刻とともに個々のアクティビティの処理時間を計算するために使用されます。これにより、活動間の空白期間だけでなく、どの具体的なステップが最も時間とリソースを消費しているかを特定するのに役立ちます。その重要性個々のアクティビティ期間の正確な測定を可能にし、プロセス内で時間がどこに費やされているかをより詳細に把握できます。取得元 HighRadiusのドキュメントを参照してください。これは、開始状態と終了状態を持つ特定のログに記録されたアクティビティで利用できる場合があります。例 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	自動化 IsAutomated	アクティビティがシステムによって自動的に実行されたか、ユーザーによって手動で実行されたかを示すブールフラグです。
説明この計算属性は、システム生成イベント（例：自動督促実行による「延滞督促通知送信済み」）と人間主導の行動（例：「督促電話記録」）を区別します。このフラグは、「自動回収活動率」KPIの計算に不可欠です。回収プロセスにおける自動化のレベルを測定し、さらなる自動化の機会を特定し、自動化された接触と手動による接触の相対的な有効性を分析するのに役立ちます。その重要性プロセスの自動化の度合いを測定するのに役立ち、自動化されたシステムと手動の作業の効率性および有効性の分析を可能にします。取得元これはデータ変換中に導出されます。特定の活動名をビジネス知識に基づいて自動化されたものとしてフラグ付けするマッピングを作成する必要があります。例 truefalse
	通貨 Currency	請求金額の通貨コード。
説明この属性は、USD、EUR、JPYなど、請求書の通貨を特定します。請求金額のようなあらゆる金銭的価値に不可欠なコンテキストを提供します。多国籍企業において、このフィールドは正確な財務分析のために不可欠です。金銭的価値が正しく解釈されることを保証し、グローバルレポートのためにデータを集計する際に適切な通貨換算を可能にします。その重要性すべての金額の正しい解釈に不可欠であり、多通貨環境での不正確な財務計算と報告を防ぎます。取得元これは請求書レコードの標準フィールドであり、通常は請求金額の隣に位置しています。例 USDEURGBP

必須推奨任意

与信管理・債権回収アクティビティ

これらは、債権管理・回収プロセスを正確に発見・分析するために、イベントログで捕捉すべき主要なプロセスステップとマイルストーンです。

7 推奨 8 任意

	アクティビティ	説明
	入金確認済み	この活動は、顧客からの支払受領を示し、多くの場合、銀行取引明細書やロックボックスファイルから記録されます。これは、資金が受領されたものの、特定の請求書にはまだ適用されていないことを意味します。
その重要性これは、回収活動の時計を止めることが多い重要なマイルストーンです。支払受領から計上までの遅延KPIを測定する出発点であり、現金適用の遅延を浮き彫りにします。取得元これはHighRadiusのCash Application Cloudにおける支払い記録から捕捉されます。銀行ファイルからの各支払いバッチまたは取引には受領日が含まれます。取得支払いレコードが現金適用モジュールにインポートまたは入力された際のタイムスタンプから取得されます。イベントタイプ explicit
	支払い期日経過	現在のシステム日付が請求書の支払い期日を超過したときに発生する計算イベントです。このアクティビティはユーザーまたはシステムのアクションを表すものではありませんが、債権回収プロセスをトリガーする重要な状態変化です。
その重要性この活動は、その後のすべての督促および回収活動の主要なトリガーとなります。これにより、期日通りの請求書と延滞請求書を区別し、回収戦略の有効性を分析することが可能になります。取得元このイベントは直接保存されるものではなく、請求書の期日フィールドと他のイベントのタイムスタンプを比較することで計算されます。プロセスマイニングのデータ変換中に導出されます。取得請求書の`due_date`を現在の日付またはイベントタイムスタンプ（Timestamp > Due Date）と比較して計算されます。イベントタイプ calculated
	異議登録済	この活動は、顧客が請求書に対して紛争または控除を提起し、それがHighRadiusに正式に記録された時点を示します。これにより、紛争中の金額に対する標準的な回収プロセスが一時停止されます。
その重要性これは、平均紛争解決時間を測定するための開始イベントです。いつ、なぜ紛争が提起されるのかを特定することは、請求エラーや配送問題などの根本原因に対処するための鍵となります。取得元このイベントは、ユーザーがHighRadius Deductions Cloudで請求書にリンクされた紛争ケースを作成したときに捕捉されます。このアクションにより、タイムスタンプ付きの紛争記録が作成されます。取得請求書に関連する異議申し立てケースレコードの作成タイムスタンプから取得されます。イベントタイプ explicit
	紛争解決済み	紛争管理プロセスの終了を表し、問題が調査され、解決策が合意に達した状態です。請求書は支払いまたは償却に進むことができます。
その重要性これは、平均紛争解決時間を測定するための終了イベントです。ここでの長いサイクルは、現金回収を大幅に遅らせ、プロセス非効率性を示す可能性があります。取得元これは、紛争ケースのステータスが「解決済み」、「クローズ済み」、または類似の最終状態に変更されたときに捕捉されます。このステータス変更のタイムスタンプが活動に使用されます。取得異議申し立てケースのステータスが最終的な「解決済み」状態に更新された際のタイムスタンプから推測されます。イベントタイプ inferred
	請求書の精算完了	この活動は、請求書が全額支払い済みでクローズされた、請求書ライフサイクルの成功裏の終了を示します。これはプロセスにとって望ましい最終状態です。
その重要性これは、プロセスにおける主要な「ハッピーパス」の終了イベントとして機能します。この結果に至る経路を分析することで、ベストプラクティスと成功した回収戦略を特定するのに役立ちます。取得元これは通常、明示的なイベントではなく、請求書ステータスが「クローズ済み」または「クリア済み」になり、残高がゼロになったことから推測されます。最終的な支払計上のタイムスタンプがイベント時刻として機能することがよくあります。取得請求書のステータスが「クローズ済み」に変更された時点、または請求書残高フィールドがゼロになった時点から推測されます。イベントタイプ inferred
	請求書償却済み	請求書ライフサイクルの代替的な終了を表し、債務が回収不能と判断され、不良債権として償却されます。これは望ましくない結果です。
その重要性償却を追跡することは、請求書償却率の計算と財務損失の根本原因の分析に不可欠です。与信審査や回収努力における失敗を特定するのに役立ちます。取得元このイベントは、請求書残高を償却するための特定の取引が計上されたとき、または請求書ステータスが「償却済み」に変更されたときに捕捉されます。取得ステータスが「償却済み」に変更された時点、または請求書に対して特定の償却取引タイプが記帳された時点から推測されます。イベントタイプ inferred
	請求書生成済み	これは、回収プロセスにおける請求書のライフサイクルの出発点です。ERPシステムで請求書が作成され、売掛金管理のためにHighRadiusにインポートされたことを示します。
その重要性この活動は、請求書から現金化プロセス分析の主要な開始イベントとして機能します。売上債権回転日数（DSO）などのすべてのサイクルタイムは、通常この時点から測定されます。取得元これは、HighRadius内の請求書レコードの作成日から捕捉される明示的なイベントであり、通常はSAPやOracleのようなソースERPシステムから同期されます。取得売掛金データにおける請求書レコードの作成タイムスタンプから取得されます。イベントタイプ explicit
	与信限度額承認	顧客に与信限度額が正式に付与される、与信審査プロセスの成功裏の完了を表します。このイベントは、与信管理者がHighRadiusプラットフォーム内で申請を承認した際に捕捉されます。
その重要性これは、販売プロセスを解除する重要なマイルストーンです。この活動を追跡することは、総与信承認サイクルタイムKPIを計算するために不可欠です。取得元このイベントは通常、与信限度額申請のステータスが「承認済み」に変わった際に捕捉されます。システム監査ログにおける明示的なイベントである場合もあります。取得与信申請のステータスが「承認済み」に変更された時点、または承認タイムスタンプフィールドから推測されます。イベントタイプ inferred
	与信限度額申請	この活動は、顧客に対する与信審査の開始を示します。通常、販売注文が確定される前にトリガーされ、新規または更新された与信限度額の申請がシステムに入力された際に捕捉されます。
その重要性申請から承認までの時間を分析することで、顧客オンボーディングや販売サイクルにおけるボトルネックを特定できます。これは、与信管理チームの効率性を測定するための重要な出発点となります。取得元このイベントは、顧客の与信プロファイルのステータス変更から、またはHighRadiusの与信管理モジュールにおける与信限度額申請レコードの作成日から推測される可能性があります。取得与信限度額申請オブジェクトの作成タイムスタンプ、またはステータスが「承認待ち」に変更された時点から推測されます。イベントタイプ inferred
	回収コール記録済み	回収担当者が延滞請求書に関して顧客に行った手動による回収電話を表します。担当者は通話の詳細と結果をHighRadiusに直接記録します。
その重要性この活動は、回収電話の成功率と回収活動の効率性を評価するために不可欠です。自動化された回収努力と手動の回収努力を区別するのに役立ちます。取得元これは、回収担当者がHighRadiusインターフェースで請求書または顧客口座に対して「通話記録」または「活動追加」機能を使用したときに作成される明示的なイベントです。エントリにはタイムスタンプが含まれます。取得債権回収担当者が手動アクションを記録するアクティビティログテーブルから取得されます。イベントタイプ explicit
	延滞督促通知送信済み	延滞請求書に関して顧客に送信された自動または手動の通知を表します。HighRadiusは督促戦略の一環としてこれを自動化し、連絡履歴を作成します。
その重要性この活動は、督促の有効性を測定するための基本です。支払いが受領されるまでにいくつの通知が必要かを分析することを可能にします。取得元これは、HighRadius Collections Cloud内の請求書のアクティビティまたは対応ログに記録される明示的なイベントです。送信された各通知には、対応するエントリとタイムスタンプがあります。取得請求書に関連するタイムスタンプ付きのコミュニケーションログから取得されます。イベントタイプ explicit
	支払い確約作成済み	この活動は、顧客が将来の特定の日付までに請求書を支払うことを約束し、回収担当者がこの約束をシステムに記録した際に発生します。これは肯定的な中間結果です。
その重要性支払い約束を追跡することは、キャッシュフローの予測と回収担当者の有効性を評価するのに役立ちます。また、約束された期日までに支払いが受領されなかった「破られた約束」の分析も可能にします。取得元これは、担当者が請求書にリンクされた「支払い約束」記録を作成したときにHighRadiusに記録される明示的なイベントです。この記録には独自の作成タイムスタンプがあります。取得 HighRadiusの「支払約束」オブジェクトの作成タイムスタンプから取得されます。イベントタイプ explicit
	支払い計上	受領した支払いが特定の請求書に正常に照合され適用され、未決済残高がクリアされた現金適用プロセスの完了を表します。
その重要性この活動は支払い処理サイクルを完了させます。「支払受領」から「支払計上」までの時間は、現金適用プロセスの効率性を明らかにします。取得元このイベントは、請求書レコードの計上日またはクリアリング日付フィールドから捕捉されます。現金適用が確定されたときに、このタイムスタンプが記録されます。取得請求書の会計明細項目にある「転記日」または「決済日」のタイムスタンプから取得されます。イベントタイプ explicit
	督促手続き開始	この活動は、延滞請求書に対する正式な督促プロセス、またはそのプロセス内の特定のレベルの開始を示します。これは単一のリマインダーよりも体系的なステップを表します。
その重要性督促手続きの開始を追跡することは、支払いを促す上での異なる回収戦略と督促レベルの有効性を分析するのに役立ちます。取得元このイベントは通常、HighRadiusの請求書レコードに関連付けられた「督促レベル」または「回収戦略」フィールドの変更から推測されます。取得請求書の督促レベル属性の変更から推測され、変更ログまたはタイムスタンプ付き履歴を介して取得されます。イベントタイプ inferred
	顧客へ請求書送付済み	この活動は、請求書が顧客に（通常はメールまたは顧客ポータル経由で）配信された時点を示します。HighRadiusは、この連絡イベントを自動化し、ログに記録することができます。
その重要性これを追跡することは、顧客が請求書を迅速に受け取っていることを確認するのに役立ちます。請求書生成と送信の間の遅延は、支払い時間とDSOに直接影響を与える可能性があります。取得元これは多くの場合、Collections Cloudモジュール内の請求書に関連する連絡履歴または活動履歴に明示的に記録されます。また、自動連絡ジョブのステータスから推測されることもあります。取得請求書のメールまたはポータル配信が実行された際、その連絡履歴に記録されます。イベントタイプ explicit

推奨任意

抽出ガイド

HighRadiusから`データ`を取得する方法

ステップ

レポートおよび分析モジュールにアクセスする: HighRadiusインスタンスに、カスタムレポートの作成と実行に必要な権限を持つユーザーでログインします。メインダッシュボードまたはアプリケーションメニューから「レポートと分析」セクションに移動します。
新規カスタムレポートを作成する: 新しいレポートを作成するプロセスを開始します。InvoicesまたはOpen A/Rオブジェクトなど、データの主要なアンカーとなるベースオブジェクトを選択します。レポートにProcessMind_Credit_Collections_Logのような分かりやすい名前を付けます。
主要な請求書属性を定義する: 請求書の主要フィールドをレポートレイアウトに追加します。これには、InvoiceNumber、CustomerId、InvoiceAmount、PaymentTerms、DueDate、PaymentStatusが含まれます。これらがすべてのイベントの基本列となります。
関連オブジェクトからのデータ（イベント）を追加する: これは最も重要なステップです。必要な15のアクティビティすべてを捕捉するために、HighRadiusの様々なオブジェクトからデータを結合またはユニオンする必要があります。レポートビルダーの機能を使用して、関連データソースを追加します。各アクティビティについて、イベント詳細を表す列のセットを作成します。
レポートをイベントログ形式に構造化する: 各イベントにつき1行を生成するようにレポートを設定します。これは通常、異なるデータブロックを列として結合するのではなく、ユニオンすることを含みます。ユニオンされた各ブロックについて、関連する日付フィールドを共通のEventTime列にマッピングし、対応するActivityNameをハードコードします。
「支払い期日超過」イベントを設定する: このイベントは条件付きです。DueDateが過去で、かつPaymentStatusが依然として「Open」または「Overdue」である請求書について、レポート内に特定のデータブロックを作成します。これらのレコードに対して、ActivityNameを「Payment Due Date Passed」に設定し、DueDate自体をEventTimeとして使用します。
債権回収担当者と異議情報を追加する: 債権回収および異議モジュールからのデータを含めることを確認します。CollectorNotesまたはActivityHistoryなどのオブジェクトを結合してCollectorNameを取得します。該当する場合、Disputesオブジェクトを結合してDisputeReasonを取得します。
レポートフィルターを設定する: 抽出の範囲を定義するためにフィルターを適用します。データセットを管理しやすい状態に保つため、EventTimeに対して過去6ヶ月間などの特定の日付範囲を設定します。組織構造によっては、特定の会社コードや事業単位でフィルターをかける必要がある場合もあります。
レポートを実行しプレビューする: レポートを実行してデータをプレビューします。構造が必須のイベントログ形式（アクティビティごとに1行、InvoiceNumber、ActivityName、EventTime、およびその他の属性の列）と一致していることを確認します。
レポートデータをエクスポートする: プレビューに満足したら、完全なレポートをエクスポートします。プロセスマイニングツールで簡単に取り込めるCSVをエクスポート形式として選択します。文字化けを防ぐため、エクスポート設定でUTF-8エンコーディングを使用していることを確認してください。
最終データレビュー: エクスポートされたCSVファイルをスプレッドシートアプリケーションで開きます。ProcessMindにアップロードする前に、15すべてのアクティビティが存在し、タイムスタンプが正しくフォーマットされ、主要な属性が期待どおりに入力されていることを最終確認します。

設定

レポートタイプ: 複数のモジュールのデータを組み合わせたカスタムレポートです。特定のHighRadiusバージョンによっては、「結合レポート」と呼ばれたり、複数のデータ「ブロック」を結合する必要がある場合があります。
プライマリデータオブジェクト: レポートのベースとして、InvoicesまたはAccounts Receivableオブジェクトから開始します。
セカンダリデータオブジェクト: CreditRequests、CustomerCommunications、DunningHistory、CollectorActivityLog、PromiseToPay、DisputeCase、CashApplicationなどの追加オブジェクトにリンクする必要があります。
日付範囲フィルター: プライマリイベントタイムスタンプフィールドにフィルターを適用します。詳細とパフォーマンスのバランスを取るために、3〜6ヶ月間のデータを抽出することをお勧めします。例えば、EventTimeが過去180日以内などです。
ステータスフィルター: 分析したいプロセスの一部でない限り、「Cancelled」や「Draft」などの関連性の低い請求書ステータスを除外することを検討してください。
権限: レポートを実行するユーザーアカウントは、完全なデータセットが抽出されるように、与信、債権回収、異議、現金適用を含むすべての関連モジュールへの読み取りアクセス権限を持っている必要があります。

a クエリ例 config

/*
 This is a configuration model for a HighRadius custom report. 
 It is not an executable SQL script but a blueprint for building the report in the UI.
 The report should be configured to UNION the following data blocks to create a single event log.
*/

// Report Name: ProcessMind_Credit_Collections_Log
// Report Output Format: CSV

// === BLOCK 1: Credit Limit Requested ===
{
  "ActivityName": "Credit Limit Requested",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Requested",
    "EventTime": "CreditRequests.RequestTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 2: Credit Limit Approved ===
{
  "ActivityName": "Credit Limit Approved",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Approved",
    "EventTime": "CreditRequests.ApprovalTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 3: Invoice Generated ===
{
  "ActivityName": "Invoice Generated",
  "Source Object": "Invoices",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Generated",
    "EventTime": "Invoices.CreationTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 4: Invoice Sent to Customer ===
{
  "ActivityName": "Invoice Sent to Customer",
  "Source Object": "CustomerCommunications",
  "Filter": "CustomerCommunications.Type = 'Invoice Delivery'",
  "Columns": {
    "InvoiceNumber": "CustomerCommunications.InvoiceNumber",
    "ActivityName": "Invoice Sent to Customer",
    "EventTime": "CustomerCommunications.SentTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 5: Payment Due Date Passed ===
{
  "ActivityName": "Payment Due Date Passed",
  "Source Object": "Invoices",
  "Filter": "Invoices.DueDate < CURRENT_DATE AND Invoices.PaymentStatus = 'Open'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Payment Due Date Passed",
    "EventTime": "Invoices.DueDate",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 6: Overdue Reminder Sent ===
{
  "ActivityName": "Overdue Reminder Sent",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Reminder'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Overdue Reminder Sent",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 7: Dunning Procedure Initiated ===
{
  "ActivityName": "Dunning Procedure Initiated",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Dunning Level 1'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Dunning Procedure Initiated",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 8: Collection Call Logged ===
{
  "ActivityName": "Collection Call Logged",
  "Source Object": "CollectorActivityLog",
  "Filter": "CollectorActivityLog.Type = 'Call'",
  "Columns": {
    "InvoiceNumber": "CollectorActivityLog.InvoiceNumber",
    "ActivityName": "Collection Call Logged",
    "EventTime": "CollectorActivityLog.ActivityTimestamp",
    "CollectorName": "CollectorActivityLog.CollectorName",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 9: Promise to Pay Created ===
{
  "ActivityName": "Promise to Pay Created",
  "Source Object": "PromiseToPay",
  "Columns": {
    "InvoiceNumber": "PromiseToPay.InvoiceNumber",
    "ActivityName": "Promise to Pay Created",
    "EventTime": "PromiseToPay.CreationTimestamp",
    "CollectorName": "PromiseToPay.CreatedByCollector",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 10: Dispute Registered ===
{
  "ActivityName": "Dispute Registered",
  "Source Object": "DisputeCase",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Registered",
    "EventTime": "DisputeCase.CreationTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "Disputed",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 11: Dispute Resolved ===
{
  "ActivityName": "Dispute Resolved",
  "Source Object": "DisputeCase",
  "Filter": "DisputeCase.Status = 'Closed' OR DisputeCase.Status = 'Resolved'",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Resolved",
    "EventTime": "DisputeCase.ResolutionTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 12: Payment Received ===
{
  "ActivityName": "Payment Received",
  "Source Object": "CashApplication.Payments",
  "Columns": {
    "InvoiceNumber": null, // Often matched later
    "ActivityName": "Payment Received",
    "EventTime": "CashApplication.Payments.PaymentDate",
    "CollectorName": null,
    "CustomerId": "CashApplication.Payments.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 13: Payment Posted ===
{
  "ActivityName": "Payment Posted",
  "Source Object": "CashApplication.AppliedPayments",
  "Columns": {
    "InvoiceNumber": "CashApplication.AppliedPayments.InvoiceNumber",
    "ActivityName": "Payment Posted",
    "EventTime": "CashApplication.AppliedPayments.ApplicationTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 14: Invoice Settled ===
{
  "ActivityName": "Invoice Settled",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Paid'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Settled",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Paid",
    "DisputeReason": null
  }
}

// === BLOCK 15: Invoice Written Off ===
{
  "ActivityName": "Invoice Written Off",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Write-Off'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Written Off",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Written Off",
    "DisputeReason": null
  }
}

ステップ

前提条件: Python 3.6+とpandasおよびrequestsライブラリがインストールされていることを確認してください。これらはpipでインストールできます: pip install pandas requests。また、HighRadius管理者からAPIクレデンシャル（Client IDとClient Secret）を取得し、請求書、債権回収、異議、支払いなどの必要なデータオブジェクトへの読み取りアクセス権限を持っている必要があります。
スクリプトの初期化: 新しいPythonスクリプトファイル（例：extract_hr_data.py）を作成します。必要なライブラリ（requests、pandas、datetime）をインポートし、HighRadius APIのベースURL、クライアントクレデンシャル、抽出に必要な日付範囲のプレースホルダー定数を定義します。
認証の実装: 認証を処理する関数を作成します。この関数は、Client IDとSecretを受け取り、HighRadius認証エンドポイント（例：/auth/v1/token）にPOSTリクエストを行い、ベアラートークンを取得します。このトークンは、その後のすべてのデータリクエストのヘッダーで使用されます。
主要請求書データを取得する: メインの請求書エンドポイント（例：/invoices/v1/search）をクエリする関数を開発します。この関数は、指定された日付範囲内のすべてのレコードが取得されるようにページネーションを処理する必要があります。APIを繰り返し呼び出し、ページがなくなるまで請求書データを収集します。この主要請求書データを辞書のリストとして保存します。
関連オブジェクトデータを取得する: 異議、債権回収メモ、支払いなどの各コアデータエンティティについて、個別のデータ取得関数を作成します。これらの関数は、それぞれのエンドポイント（例：/disputes/v1/search、/collections/v1/notes、/cashapp/v1/payments）をクエリし、指定された期間のすべての関連データを効率的に取得するように設計する必要があります。多くの場合、1つの請求書を一度にクエリするよりも、これらのデータセットを一括で取得する方が最適です。
イベントログの構造化: すべてのイベントログ行を保持する空のリストを初期化します。スクリプトは取得したデータを反復処理し、関連する各アクションまたはステータス変更を、単一のイベント行を表す標準化された辞書に変換します。各辞書には、InvoiceNumber、ActivityName、EventTime、およびその他すべての必須属性のキーが含まれている必要があります。
請求書ライフサイクルイベントを生成する: 主要な請求書のリストを反復処理します。各請求書について、作成日、対応ログ、終了日、ステータスフィールドに基づいて、「Invoice Generated」、「Invoice Sent to Customer」、「Invoice Settled」、「Invoice Written Off」のイベントを作成します。これらをイベント辞書として保存します。
「支払い期日超過」を計算する: 同じ請求書ループ内で、「Payment Due Date Passed」イベントを作成するロジックを追加します。これは計算されたイベントです。このロジックは、請求書の期日が過ぎているか、請求書がまだ支払われていないか、そして「Payment Due Date Passed」イベントがまだ生成されていないかをチェックする必要があります。このアクティビティのEventTimeは期日自体であるべきです。
債権回収と異議イベントを生成する: 債権回収および異議エンドポイントから取得したデータを処理します。各メモ、支払約束、督促アクション、または異議レコードに対して、対応するイベントログ行（「Overdue Reminder Sent」、「Collection Call Logged」、「Promise to Pay Created」、「Dispute Registered」、「Dispute Resolved」）を作成します。CollectorNameやDisputeReasonなどの関連詳細をイベントレコードにマッピングします。
支払いイベントを生成する: 現金適用モジュールからの支払いデータを処理します。支払い作成日または銀行取引明細書の日付に基づいて「Payment Received」イベントを作成し、支払いが請求書に正常に適用された日付に基づいて「Payment Posted」イベントを作成します。
データを統合しフォーマットする: すべてのデータソースを処理し、イベントを生成した後、イベント辞書のリストをpandas DataFrameに変換します。これにより、簡単にソートや最終的なデータ型変換を行うことができます。EventTime列がYYYY-MM-DD HH:MI:SSの一貫したタイムスタンプ形式であることを確認してください。
CSVとしてエクスポートする: pandasのto_csv関数を使用して、最終的なDataFrameをCSVファイルにエクスポートします。例えば、highradius_event_log.csvのように分かりやすいファイル名を付けます。DataFrameのインデックスが列として書き込まれないように、パラメータindex=Falseを設定します。このファイルはProcessMindへのアップロード準備が整いました。

設定

APIクレデンシャル: 専用のAPIユーザー（Client IDとClient Secretが必要）が必要です。このユーザーは、請求書、顧客、債権回収活動、異議、現金適用など、関連するすべてのAPIエンドポイントに対する読み取り権限を持っている必要があります。
日付範囲: PythonスクリプトにはSTART_DATEとEND_DATE変数が含まれています。データ量を制限し、スクリプトの実行時間が長くなりすぎないように、3～6ヶ月といった特定の妥当な日付範囲を設定することが重要です。請求書作成日や修正日など、インデックス化された日付フィールドに基づいてフィルタリングしてください。
エンドポイントURL: 特定のAPIエンドポイントパス（例：/invoices/v1/search）はプレースホルダーです。組織のHighRadius APIドキュメントで正しいエンドポイントURLを確認する必要があります。
ページネーションパラメータ: スクリプトは、APIのページネーションメカニズムを正しく処理する必要があります。これは通常、limitとoffsetパラメータを使用するか、カーソルベースのアプローチを含みます。ページサイズは100～500が一般的に良い出発点となります。
実行環境: スクリプトは、特に大規模な抽出の場合、データフレームを処理するのに十分なメモリを持つ安定した環境で実行する必要があります。本番規模の抽出では、ローカルマシンよりもサーバーで実行することが推奨されます。
カスタムフィールド: プロセスがHighRadius内のカスタムフィールドに依存している場合、スクリプトはこれらのフィールドをクエリし、出力に含めるように変更する必要があります。

a クエリ例 python

import requests
import pandas as pd
from datetime import datetime, time

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
HIGH RADIUS_BASE_URL = class="hl-string">"https://[your-highradius-instance].highradius.com/api"
CLIENT_ID = class="hl-string">"[Your_Client_ID]"
CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def get_auth_token():
    class="hl-string">"""Authenticates with HighRadius and returns a bearer token."""
    auth_url = fclass="hl-string">"{HIGH RADIUS_BASE_URL}/auth/v1/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    response = requests.post(auth_url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

def fetch_paginated_data(endpoint, params, headers):
    class="hl-string">"""Fetches all pages of data from a given HighRadius endpoint."""
    all_data = []
    page = 0
    limit = 200 class=class="hl-string">"hl-comment"># Records per page
    while True:
        params[class="hl-string">'offset'] = page * limit
        params[class="hl-string">'limit'] = limit
        response = requests.get(fclass="hl-string">"{HIGH RADIUS_BASE_URL}{endpoint}", headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        records = data.get(class="hl-string">'data', []) class=class="hl-string">"hl-comment"># Adjust based on actual API response structure
        if not records:
            break
        all_data.extend(records)
        page += 1
    return all_data

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    class="hl-string">"""Main function to extract, transform, and save the event log."""
    print(class="hl-string">"Starting HighRadius data extraction...")
    auth_token = get_auth_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {auth_token}'}
    events = []

    class=class="hl-string">"hl-comment"># 1. Fetch all relevant invoices in the date range
    print(class="hl-string">"Fetching invoice data...")
    invoice_params = {class="hl-string">'creationDate_gte': START_DATE, class="hl-string">'creationDate_lte': END_DATE}
    invoices = fetch_paginated_data(class="hl-string">"/invoices/v1/search", invoice_params, headers)

    class=class="hl-string">"hl-comment"># Fetch related data in bulk to reduce API calls
    invoice_ids = [inv[class="hl-string">'invoiceNumber'] for inv in invoices]
    print(fclass="hl-string">"Fetching related data for {len(invoice_ids)} invoices...")

    notes = fetch_paginated_data(class="hl-string">"/collections/v1/notes", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    disputes = fetch_paginated_data(class="hl-string">"/disputes/v1/search", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    payments = fetch_paginated_data(class="hl-string">"/cashapp/v1/applications", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    credit_requests = fetch_paginated_data(class="hl-string">"/credit/v1/requests", {class="hl-string">'requestDate_gte': START_DATE, class="hl-string">'requestDate_lte': END_DATE}, headers)

    class=class="hl-string">"hl-comment"># Create dictionaries for quick lookups
    notes_by_invoice = {k: [n for n in notes if n[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    disputes_by_invoice = {k: [d for d in disputes if d[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    payments_by_invoice = {k: [p for p in payments if p[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    
    class=class="hl-string">"hl-comment"># Process each invoice to create events
    print(class="hl-string">"Transforming data into event log...")
    for invoice in invoices:
        common_attrs = {
            class="hl-string">'InvoiceNumber': invoice.get(class="hl-string">'invoiceNumber'),
            class="hl-string">'CustomerId': invoice.get(class="hl-string">'customer', {}).get(class="hl-string">'id'),
            class="hl-string">'InvoiceAmount': invoice.get(class="hl-string">'invoiceAmount'),
            class="hl-string">'PaymentTerms': invoice.get(class="hl-string">'paymentTerms'),
            class="hl-string">'DueDate': invoice.get(class="hl-string">'dueDate'),
            class="hl-string">'PaymentStatus': invoice.get(class="hl-string">'paymentStatus'),
            class="hl-string">'CollectorName': invoice.get(class="hl-string">'collector', {}).get(class="hl-string">'name'),
            class="hl-string">'DisputeReason': None
        }

        class=class="hl-string">"hl-comment"># Invoice Generated
        events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Generated', class="hl-string">'EventTime': invoice.get(class="hl-string">'creationDate')})
        
        class=class="hl-string">"hl-comment"># Invoice Sent to Customer (example from correspondence log)
        if invoice.get(class="hl-string">'sentDate'):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Sent to Customer', class="hl-string">'EventTime': invoice.get(class="hl-string">'sentDate')})

        class=class="hl-string">"hl-comment"># Payment Due Date Passed (calculated)
        due_date_obj = datetime.strptime(invoice.get(class="hl-string">'dueDate'), class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ').date()
        if due_date_obj < datetime.today().date() and invoice.get(class="hl-string">'paymentStatus') not in [class="hl-string">'PAID', class="hl-string">'CLOSED']:
            event_time_at_due_date = datetime.combine(due_date_obj, time(23, 59, 59)).isoformat()
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Due Date Passed', class="hl-string">'EventTime': event_time_at_due_date})

        class=class="hl-string">"hl-comment"># Invoice Settled / Written Off
        if invoice.get(class="hl-string">'closeDate'):
            if invoice.get(class="hl-string">'paymentStatus') == class="hl-string">'PAID':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Settled', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})
            elif invoice.get(class="hl-string">'statusReason') == class="hl-string">'WRITTEN_OFF':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Written Off', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})

        class=class="hl-string">"hl-comment"># Process related notes for this invoice
        for note in notes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            activity_map = {
                class="hl-string">'REMINDER_SENT': class="hl-string">'Overdue Reminder Sent',
                class="hl-string">'DUNNING_STARTED': class="hl-string">'Dunning Procedure Initiated',
                class="hl-string">'COLLECTION_CALL': class="hl-string">'Collection Call Logged',
                class="hl-string">'PROMISE_TO_PAY': class="hl-string">'Promise to Pay Created'
            }
            activity_name = activity_map.get(note.get(class="hl-string">'noteType'))
            if activity_name:
                events.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': note.get(class="hl-string">'creationDate'), class="hl-string">'CollectorName': note.get(class="hl-string">'createdBy')})

        class=class="hl-string">"hl-comment"># Process related disputes for this invoice
        for dispute in disputes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Registered', class="hl-string">'EventTime': dispute.get(class="hl-string">'creationDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
            if dispute.get(class="hl-string">'resolutionDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Resolved', class="hl-string">'EventTime': dispute.get(class="hl-string">'resolutionDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
        
        class=class="hl-string">"hl-comment"># Process related payments for this invoice
        for payment in payments_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            if payment.get(class="hl-string">'paymentReceivedDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Received', class="hl-string">'EventTime': payment.get(class="hl-string">'paymentReceivedDate')})
            if payment.get(class="hl-string">'applicationDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Posted', class="hl-string">'EventTime': payment.get(class="hl-string">'applicationDate')})

    class=class="hl-string">"hl-comment"># Process credit requests (linked by customer ID)
    for request in credit_requests:
        class=class="hl-string">"hl-comment"># Note: Linking to a specific invoice is often not possible. Here we create a case-level event.
        class=class="hl-string">"hl-comment"># A more advanced logic could try to link based on customer and time proximity to an invoice.
        credit_attrs = {**common_attrs, class="hl-string">'InvoiceNumber': fclass="hl-string">"CREDIT-{request.get('customerId')}", class="hl-string">'CustomerId': request.get(class="hl-string">'customerId')}
        events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Requested', class="hl-string">'EventTime': request.get(class="hl-string">'requestDate')})
        if request.get(class="hl-string">'status') == class="hl-string">'APPROVED' and request.get(class="hl-string">'approvalDate'):
            events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Approved', class="hl-string">'EventTime': request.get(class="hl-string">'approvalDate')})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    if not events:
        print(class="hl-string">"No events found for the specified criteria.")
        return

    df = pd.DataFrame(events)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'], errors=class="hl-string">'coerce')
    df.dropna(subset=[class="hl-string">'InvoiceNumber', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'highradius_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

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

債権管理・回収データテンプレート

債権管理・回収データテンプレート

与信管理・債権回収属性

与信管理・債権回収アクティビティ

抽出ガイド

HighRadiusレポートおよび分析モジュールからのエクスポート

ステップ

設定

a クエリ例 config

HighRadius REST API経由のPythonスクリプトによるデータ抽出

ステップ

設定

a クエリ例 python

今すぐ始めますか？

債権管理・回収の最適化を始めましょう

債権管理・回収データテンプレート

債権管理・回収データテンプレート

与信管理・債権回収属性

与信管理・債権回収アクティビティ

抽出ガイド

HighRadiusレポートおよび分析モジュールからのエクスポート

ステップ

設定

a クエリ例 config

HighRadius REST API経由のPythonスクリプトによるデータ抽出

ステップ

設定

a クエリ例 python

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

今すぐ始めますか？

債権管理・回収の最適化を始めましょう