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

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

HighRadius

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

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

このテンプレートでは、信用管理・債権回収プロセスを分析するために必要なデータを収集する手順を整理しています。取得すべき主要な属性、追跡すべき重要なアクティビティ、HighRadiusシステムからこれらの情報を抽出する方法を説明します。このテンプレートを使うことで、プロセスマイニングに必要なデータを効率よく準備できます。

収集を推奨する属性
プロセスの可視化に必要な主要アクティビティ
HighRadius向けデータ抽出ガイド

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

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

与信管理・債権回収の属性

与信管理・債権回収プロセスを詳細に分析するために、イベントログに含めることを推奨するデータ項目です。

3 必須 7 推奨 11 任意

	名前	説明
	アクティビティ名 ActivityName	請求書について、ある時点で発生した特定の業務イベントの名称です。
説明アクティビティ名は、「請求書を生成」「延滞リマインダーを送信」「入金を受領」など、クレジットおよび回収プロセスのステップを表します。これらのアクティビティの順序が、各ケースのプロセスフローを形成します。この属性を分析すると、実際のプロセスマップを発見して可視化できます。ボトルネック、標準手順からの逸脱、手戻りループの特定にも役立ちます。「回収電話を記録」や「異議申し立てを登録」などのアクティビティの頻度と順序は、プロセス効率を理解するうえで重要です。重要な理由この属性によってプロセスのステップを定義し、請求書ごとのプロセスフローを再構築して分析できます。入手先通常は、イベントログ、ステータス変更、またはHighRadiusプラットフォームの各モジュールにある特定の操作記録から導出します。例請求書を顧客へ送信督促手続きを開始入金を受領異議申し立てを解決
	イベント時刻 EventTime	アクティビティが発生した日時を示すタイムスタンプです。日付と時刻が含まれます。
説明イベント時刻は、プロセス内の各アクティビティが発生した正確な日時を示します。この時系列データはプロセスマイニングの基盤であり、イベントを正しい順序に並べ、イベント間の期間を算出できます。この属性は、異議申し立ての解決、与信承認、入金計上のサイクル時間など、時間に基づくすべてのKPIの算出に使われます。また、時間の経過に伴うプロセスパフォーマンスの分析、遅延を引き起こすアクティビティの特定、サービスレベル合意の遵守状況の測定にも利用します。重要な理由すべてのアクティビティに時系列の文脈を与えます。サイクル時間の算出、ボトルネックの発見、プロセスの動態の把握に欠かせません。入手先 HighRadiusのすべての取引レコードまたはイベントログには、通常「作成日」や「タイムスタンプ」と呼ばれる対応するタイムスタンプフィールドが必要です。例 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	請求書番号 InvoiceNumber	各請求書を一意に識別する番号で、リードから入金までのプロセスにおける主要なケース識別子です。
説明請求書番号は、単一の売掛金取引に関連するすべてのアクティビティを結び付ける中心的なキーです。請求書の生成から、さまざまなクレジット管理・回収アクティビティ、最終的な決済または貸倒処理まで、ライフサイクル全体を追跡できます。プロセスマイニング分析では、関連するすべてのイベントを1つのケースにまとめるために欠かせない属性です。これにより、プロセス全体のフローを可視化し、売上債権回転日数（DSO）などのケース期間を算出し、異議申し立ての解決や督促手続きなど、請求書がたどるさまざまな経路を分析できます。重要な理由すべてのプロセスステップを結び付ける基本的な識別子であり、請求書の作成からクローズまでの全体の流れを分析できます。入手先 HighRadiusの主要フィールドで、通常は中核となる請求書または債権データオブジェクトに含まれています。例 INV-2023-001239876543210SI-55482
	回収担当者名 CollectorName	コレクション業務のアクティビティを実行したユーザーまたはエージェントの名前です。
説明この属性は、「Collection Call Logged」や「Dispute Resolved」などの手動アクティビティを実行したコレクション担当者、クレジットアナリスト、その他のユーザーを識別します。分析では、コレクション担当者やチーム間のパフォーマンスを比較できます。業務量の分布を把握し、個人ごとの戦略の有効性（例：担当者別のCollection Call Success Rate）を評価するとともに、コーチングの機会を特定する際にも役立ちます。また、リソース管理やキャパシティプランニングにも欠かせません。重要な理由プロセスのアクティビティを特定の担当者に関連付けることで、チームのパフォーマンス、業務量、手動介入の有効性を分析できます。入手先通常、この情報はHighRadiusのCollectionsモジュール内にあるアクティビティログまたはユーザー操作記録に保存されています。例 John SmithJane DoeEmily Jones
	支払期日 DueDate	請求書の支払期限となる計算上の日付です。
説明 Due Dateは、請求書が期限超過と見なされないために支払う必要がある具体的な暦日です。通常、請求書の日付と支払条件から計算します。すべての期限超過分析の基礎となる属性です。「Days Overdue」の計算、督促手続きの開始、「Payment Terms Adherence Rate」KPIの測定に使われます。また、請求書のエイジングや督促の有効性に関するダッシュボードを直接支えます。重要な理由請求書が期限内か期限超過かを判断する基準日であり、その後のコレクション活動やKPIを開始する起点となります。入手先 HighRadiusの請求書レコードにある標準フィールドです。連携元ERPから取り込む場合と、HighRadius内で計算する場合があります。例 2023-04-142023-05-312023-06-20
	支払条件 PaymentTerms	顧客が請求書を支払う期限を定めた合意済みの支払条件です。
説明 Payment Termsは、「Net 30」「Net 60」「Due on Receipt」などの支払条件を示します。この属性を基に、請求書の支払期日を計算します。「Payment Terms Adherence」ダッシュボードとKPIの主要な属性です。分析することで、標準条件が一貫して適用されているか、またどの支払条件で支払い遅延が多いかを特定できます。この情報は、与信方針や顧客との交渉に役立ちます。重要な理由支払い予定の基準となるため、支払期日の計算や、顧客が支払条件を守っているかの測定に欠かせません。入手先通常、HighRadiusまたは連携元ERPの請求書ヘッダーや顧客マスターデータにあります。例 30日後払い60日後払い受領時払い
	支払状況 PaymentStatus	Open、Paid、Overdue、Disputedなど、請求書の現在の財務ステータスです。
説明 Payment Statusは、請求書がライフサイクルのどの段階にあるかを示します。支払い待ちか、全額または一部が支払済みか、支払期日を過ぎているか、異議申し立てのため調査中かを確認できます。「Invoice Payment Status & Aging」ダッシュボードの中心となる属性です。売掛金ポートフォリオをすばやく分類し、全体的な財務状況を把握するとともに、期限超過または異議申し立て中の項目に対するコレクション業務の優先順位を付けられます。重要な理由請求書を対応可能なグループに分類し、売掛金の状態をすぐに把握できるようにするとともに、コレクション業務の優先順位付けを支援します。入手先 HighRadiusの請求書または売掛金レコードにある主要なステータスフィールドです。例未処理支払済み支払期限超過異議申立て中償却済み
	紛争理由 DisputeReason	顧客が請求書に異議を申し立てた際に入力する理由コードまたは説明です。
説明顧客が異議を申し立てる際には、通常、「Incorrect Pricing」「Damaged Goods」「Duplicate Invoice」などの理由を提示します。この属性は、その理由を記録します。 Dispute Reasonの分析は、「Invoice Dispute Resolution Time」ダッシュボードに欠かせません。異議申し立ての根本原因を特定し、価格設定、配送、請求における構造的な問題への対応に役立ちます。発生源で異議申し立てを減らすことで、キャッシュフローを大幅に改善できます。重要な理由支払い遅延の根本原因を把握し、将来の異議申し立てを防ぐための的を絞ったプロセス改善につなげられます。入手先通常、HighRadiusの異議申し立て管理または控除モジュールで、異議申し立てを記録した際に取得されます。例数量誤り価格差異商品破損請求重複
	請求書金額 InvoiceAmount	請求書の金額合計です。
説明この属性は、請求書の支払総額を表します。各ケースに関連する金額を把握するための重要な財務指標です。プロセスマイニングでは、たとえば金額の大きい期限超過請求書を優先するなど、コレクション業務の優先順位付けにInvoice Amountを使います。Days Sales Outstanding（DSO）などの財務KPIの基礎となるほか、Invoice Write-Off Analysisダッシュボードで貸倒れによる財務影響を定量化する際にも使われます。重要な理由各ケースの財務的な背景を示し、金額に基づく分析や業務の優先順位付け、償却などの財務影響の定量化を可能にします。入手先 HighRadiusの請求書ヘッダーデータにある標準フィールドです。例 5000.001250.7525000.50
	顧客ID CustomerId	請求書に関連付けられた顧客を一意に識別するIDです。
説明 Customer IDにより、請求書を特定の顧客エンティティに関連付けます。これにより、顧客を軸にプロセスデータを集計・分析できます。この属性は、顧客ごと、または顧客セグメントごとの支払い行動を分析するうえで欠かせません。「支払いが頻繁に遅れる顧客はどこか」「最も多くの異議申し立てを行う顧客はどこか」といった問いに答えられます。また、Payment Terms Adherenceなどのダッシュボードを支え、顧客別にKPIを分類できます。重要な理由顧客単位で支払い行動、異議申し立ての頻度、プロセス全体との関わりを分析できるため、コレクション戦略を顧客に合わせて調整できます。入手先 HighRadiusの請求書ヘッダーまたは顧客アカウントデータにある標準フィールドです。例 CUST-001ACME-CORPGLOBEX-US
	ソースシステム SourceSystem	データの取得元となるシステムです。
説明イベントデータが生成されたソースシステムを識別する属性です。このプロセスビューでは、通常「HighRadius」が設定されます。複数のシステムを利用する環境では、データの系譜を把握し、情報の起点まで追跡するために欠かせません。ERPや専用の回収ツールなど、異なるプラットフォームにまたがるプロセスを区別できます。重要な理由データの出所を明確にします。データガバナンス、検証、プロセスを支える技術環境の把握に重要です。入手先通常は、データ抽出・変換処理の際にデータセットを識別するために追加する固定値です。例 HighRadiusHighRadius-CollectionsHighRadius-CashApp
	事業部門 BusinessUnit	販売または請求書に責任を持つ社内の事業部門または部門です。
説明 Business Unit属性は、請求書を「Retail」「Wholesale」「Services」など、組織内の特定の部門に割り当てます。これにより、異なる事業セグメントごとにパフォーマンスを分析できます。経営層は、事業部門間でDSO、異議申し立て率、償却などのKPIを比較し、優れた領域や改善が必要な領域を特定できます。また、組織内の各部門が売掛金のパフォーマンスに責任を持つうえでも役立ちます。重要な理由組織内の各部門のパフォーマンスを比較でき、与信から入金までのプロセスが最も効果的な部門を特定できます。入手先組織データであり、通常は請求書に記録されているか、HighRadiusまたはERPの関連する販売注文や顧客アカウントから取得します。例 BU-北米サービス部門製造
	償却理由 WriteOffReason	請求書を貸倒れとして償却した理由コードまたは説明です。
説明請求書を回収不能と判断した場合、その請求書を償却します。この属性は、「Customer Bankruptcy」「Unresolved Dispute」「Small Balance Write-Off」など、償却の理由を記録します。「Invoice Write-Off Analysis」ダッシュボードに欠かせない属性です。財務損失の根本原因分析に役立ち、与信方針の見直し、異議申し立て対応の改善、将来の償却を抑えるためのコレクション戦略の調整につながる情報を提供します。重要な理由収益損失の理由を明らかにし、与信リスク評価やコレクション方針の改善に必要なフィードバックを提供します。入手先通常、HighRadiusの財務またはコレクションモジュールで「Invoice Written Off」アクティビティを処理した際に記録されます。例破産消滅時効成立回収費用が債務額を超過
	最終データ更新 LastDataUpdate	このレコードのデータがソースシステムから最後に更新された日時を示すタイムスタンプです。
説明この属性は、データの新しさを示します。HighRadiusから最後にデータを抽出または更新した日時を記録します。分析では、分析結果がどの時点の情報に基づくものかを確認するために使います。ダッシュボードやレポートに情報の最新性を表示し、最新のデータに基づいて意思決定できるようにするうえで欠かせません。重要な理由データの適時性を明確にし、分析結果への信頼を高め、十分な情報に基づく意思決定を支えます。入手先抽出処理中にデータ取り込みパイプラインが各レコードに生成・追加するタイムスタンプです。例 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	国 Country	請求書に関連付けられた顧客の国です。
説明この属性は、顧客が所在する国を示します。与信・コレクションプロセスを地域別に分類できます。国別にデータを分析することで、支払い行動、コレクション戦略の有効性、よくある異議申し立ての理由における地域差を把握できます。グローバルに事業を展開する組織において、地域ごとの方針の調整や経営層向けレポートに役立つ情報です。重要な理由地域別の分析を可能にし、支払い行動の傾向を明らかにするとともに、それに応じたコレクション戦略の調整を支援します。入手先顧客マスターデータの一部であり、通常はHighRadiusで利用できるほか、連携元ERPから同期されます。例 USAドイツブラジル
	延滞日数 DaysOverdue	請求書が支払期日を過ぎている日数です。まだ支払期日前である場合、または期限内に支払済みの場合は0になります。
説明 Days Overdueは、期限超過の度合いを測る計算指標です。未払いの請求書では現在の日付、支払済みの請求書では支払日と、請求書の支払期日との差を計算します。支払い遅延を示す主要な指標です。「Invoice Payment Status & Aging」ダッシュボードの基礎となる属性で、売掛金をエイジング区分（例：1～30日、31～60日）に分類するために使われます。また、Days Sales Outstanding（DSO）の計算要素であり、期限超過日数が最も多い顧客へのコレクション業務の優先順位付けにも役立ちます。重要な理由支払い遅延を直接定量化できるため、エイジング分析、コレクション業務の優先順位付け、DSOの計算に欠かせません。入手先保存されるフィールドではありません。データ変換時に、Due DateとPayment Dateまたは現在の日付を使って計算します。例 1545092
	支払約束日 PromiseToPayDate	顧客が期限超過請求書の支払いを約束した日付です。
説明コレクション担当者が顧客に連絡した際、顧客から特定の日までに支払うという「Promise to Pay」を取り付ける場合があります。この属性は、その約束日を記録します。このデータは、顧客の約束の信頼性や、コレクション担当者が確実な約束を取り付ける能力を評価するうえで重要です。「約束履行率」の追跡にも使え、コレクションチームの主要なパフォーマンス指標となります。重要な理由コレクション活動の重要な成果を記録し、フォローアップの有効性や顧客の約束の信頼性を測定するために使われます。入手先 HighRadiusのCollectionsモジュールで「Promise to Pay」アクティビティを記録した際に入力されます。例 2023-06-152023-07-012023-06-25
	督促レベル DunningLevel	期限超過請求書に対する自動督促プロセスが到達した段階またはレベルです。
説明 Dunning Levelは、コレクション活動の強度を示し、通常は顧客に送信した自動リマインダーや通知の順序に対応します。たとえば、Level 1は穏やかなリマインダー、Level 3は最終通知を表します。「Dunning Strategy Effectiveness」ダッシュボードに欠かせない属性です。どの督促レベルで支払いにつながることが多いかを分析することで、顧客との関係を損なうほど強硬にならず、効果を発揮するよう督促ワークフローを改善できます。重要な理由コレクション活動のエスカレーション状況を追跡し、支払いを促すうえで最も効果的な督促戦略を分析できます。入手先 HighRadiusの自動コレクションまたは督促ワークフローエンジンが管理するステータスフィールドです。例 123：最終通知法的回収
	終了時刻 EndTime	アクティビティが完了した日時を示すタイムスタンプです。
説明 End Timeは、アクティビティの終了時点を示します。コレクション業務の多くは、Start TimeとEnd Timeが同じ瞬時のイベントですが、「Dispute Resolution」のように、明確な所要時間を持つアクティビティもあります。この属性が利用できる場合は、Start Timeと組み合わせて、個々のアクティビティのProcessing Timeを計算します。これにより、アクティビティ間の空白時間だけでなく、具体的にどのステップが最も多くの時間とリソースを消費しているかを特定できます。重要な理由個々のアクティビティの所要時間を正確に測定できるため、プロセス内のどこに時間が費やされているかを、より詳細に把握できます。入手先 HighRadiusのドキュメントをご確認ください。開始状態と終了状態を持つ一部の記録対象アクティビティで利用できる場合があります。例 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	自動処理かどうか IsAutomated	アクティビティがシステムによって自動実行されたか、ユーザーによって手動実行されたかを示すブール型フラグです。
説明この計算属性は、「Overdue Reminder Sent」のように自動督促の実行でシステムが生成したイベントと、「Collection Call Logged」のように人が実行したアクションを区別します。「Automated Collection Activity Rate」KPIの計算に欠かせないフラグです。コレクションプロセスの自動化レベルを測定し、さらなる自動化の機会を特定するとともに、自動対応と手動対応の相対的な有効性を分析できます。重要な理由プロセスの自動化の度合いを測定し、自動システムと手動作業の効率や有効性を分析できます。入手先データ変換時に生成されます。業務知識に基づき、特定のActivity Namesを自動実行として識別するマッピングを作成する必要があります。例 truefalse
	通貨 Currency	請求書金額の通貨コードです。
説明この属性は、USD、EUR、JPYなど、請求書の通貨を示します。Invoice Amountなどの金額を解釈するために必要な情報です。多国籍企業では、正確な財務分析に欠かせないフィールドです。金額を正しく解釈できるようにし、グローバルレポート用にデータを集計する際の適切な通貨換算を可能にします。重要な理由すべての金額を正しく解釈するために必要であり、複数通貨環境における不正確な財務計算やレポートを防ぎます。入手先請求書レコードにある標準フィールドで、通常はInvoice Amountの隣に配置されています。例 USDEURGBP

必須推奨任意

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

与信管理・債権回収プロセスを正確にディスカバリー・分析するために、イベントログに記録すべき主要なプロセス手順とマイルストーンです。

7 推奨 8 任意

	アクティビティ	説明
	入金を受領	顧客からの入金を受け取ったことを示します。通常は銀行明細またはロックボックスファイルから記録されます。資金は受領済みですが、特定の請求書にはまだ消し込まれていない状態です。
重要な理由回収の計測を止める重要なマイルストーンです。入金から計上までの遅延KPIを測定する開始点となり、入金消込の遅延を明らかにします。入手先 HighRadiusのCash Application Cloudにある入金レコードから取得します。銀行ファイルから取り込まれた各入金バッチまたは取引に、受領日が記録されます。取得入金消込モジュールに入金レコードを取り込んだ、または入力した時点のタイムスタンプから取得します。イベントタイプ explicit
	支払期日を超過	現在の日付が請求書の支払期日を過ぎた時点で発生する計算イベントです。ユーザーやシステムの操作を示すものではありませんが、回収プロセスを開始する重要な状態変更です。
重要な理由後続するすべての督促および回収アクティビティの主なトリガーです。期日どおりの請求書と延滞した請求書を区別し、回収戦略の効果を分析できます。入手先このイベントは直接保存されません。請求書の支払期日フィールドと他のイベントのタイムスタンプを比較して算出し、プロセスマイニング用のデータ変換時に導出します。取得請求書のdue_dateと現在の日付またはイベントタイムスタンプを比較して算出します（Timestamp > Due Date）。イベントタイプ calculated
	異議申し立てを登録	顧客が請求書に対する異議申し立てまたは控除を申し立て、それがHighRadiusに正式に記録された時点を示します。申し立て対象額について、通常の回収プロセスが一時停止します。
重要な理由平均異議申し立て解決時間を測定するための開始イベントです。請求ミスや出荷上の問題など、異議申し立てがいつ、なぜ発生するのかを把握することは、根本原因への対応に役立ちます。入手先ユーザーがHighRadius Deductions Cloudで請求書に関連付けられた異議申し立てケースを作成した時点で取得します。この操作により、タイムスタンプ付きの異議申し立てレコードが作成されます。取得請求書に関連付けられた異議申し立てケースレコードの作成タイムスタンプから取得します。イベントタイプ explicit
	異議申し立てを解決	異議申し立て管理プロセスが完了し、問題の調査と解決が終わったことを示します。請求書は支払いまたは貸倒処理へ進められます。
重要な理由平均異議申し立て解決時間を測定するための終了イベントです。ここでの長期化は入金を大幅に遅らせ、プロセスの非効率を示す可能性があります。入手先異議申し立てケースのステータスが「解決済み」「クローズ」などの最終状態に変更された時点で取得します。このステータス変更のタイムスタンプがアクティビティの時刻になります。取得異議申し立てケースのステータスが最終的な「解決済み」に更新された時点のタイムスタンプから推定します。イベントタイプ inferred
	請求書を決済	請求書のライフサイクルが正常に終了し、全額支払われてクローズされたことを示します。プロセスで目指す最終状態です。
重要な理由プロセスにおける主要な「正常経路」の終了イベントです。この結果に至る経路を分析すると、ベストプラクティスや成功している回収戦略を特定できます。入手先通常は明示的なイベントではありません。請求書のステータスが「クローズ」または「消込済み」に変わり、残高がゼロになったことから推定します。最終入金計上のタイムスタンプがイベント時刻になることが多いです。取得請求書のステータスが「クローズ」に変わった時点、または請求書残高フィールドがゼロになった時点から推定します。イベントタイプ inferred
	請求書を生成	回収プロセスにおける請求書ライフサイクルの開始点です。ERPシステムで請求書が作成され、債権管理のためにHighRadiusへ取り込まれたことを示します。
重要な理由請求書から入金までのプロセス分析における主要な開始イベントです。売上債権回転日数（DSO）などのサイクル時間は、通常この時点から測定します。入手先通常は、HighRadius内の請求書レコードの作成日から取得する明示的なイベントです。SAPやOracleなどの基幹ERPシステムから同期されます。取得債権データに含まれる請求書レコードの作成タイムスタンプから取得します。イベントタイプ explicit
	請求書を貸倒処理	請求書のライフサイクルにおける別の終了を示します。債権が回収不能と判断され、貸倒損失として処理された状態です。望ましくない結果です。
重要な理由貸倒処理を追跡することは、請求書貸倒率の算出と財務損失の根本原因分析に欠かせません。与信審査や回収活動の問題を特定するのに役立ちます。入手先請求書残高を貸倒処理する取引が計上された時点、または請求書のステータスが「貸倒処理済み」に変更された時点で取得します。取得ステータスが「貸倒処理済み」に変更されたこと、または請求書に対して特定の貸倒処理取引タイプが計上されたことから推定します。イベントタイプ inferred
	与信限度額を承認	与信審査が完了し、顧客に与信限度額が正式に付与されたことを示します。HighRadiusプラットフォーム内で与信管理者が申請を承認した時点で記録されます。
重要な理由販売プロセスを次の段階へ進める重要なマイルストーンです。このアクティビティを追跡することで、与信承認サイクル全体の時間KPIを正確に算出できます。入手先通常は、与信限度額申請のステータスが「承認済み」に変更された時点から取得します。システムの監査ログに明示的なイベントとして記録される場合もあります。取得与信申請のステータスが「承認済み」に変更された時点、または承認タイムスタンプから推定されます。イベントタイプ inferred
	与信限度額を申請	このアクティビティは、顧客の与信審査が始まったことを示します。通常は販売注文の確定前に開始され、新規または更新された与信限度額の申請がシステムに入力された時点で記録されます。
重要な理由申請から承認までの時間を分析すると、顧客のオンボーディングや販売サイクルにおけるボトルネックを特定できます。与信管理チームの効率を測定するうえで重要な開始点です。入手先このイベントは、顧客の与信プロファイルのステータス変更、またはHighRadiusのCredit Managementモジュールで与信限度額申請レコードが作成された日時から推定される可能性があります。取得与信限度額申請オブジェクトの作成タイムスタンプ、またはステータスが「承認待ち」に変更された時点から推定されます。イベントタイプ inferred
	入金を計上	入金消込プロセスが完了し、受領した入金が特定の請求書に正常に照合・適用され、未決済残高が消し込まれたことを示します。
重要な理由入金処理サイクルを完了するアクティビティです。「入金を受領」から「入金を計上」までの時間によって、入金消込プロセスの効率が分かります。入手先請求書レコードの計上日または消込日フィールドから取得します。入金消込が完了した時点で、このタイムスタンプが記録されます。取得請求書の会計明細にある「計上日」または「消込日」のタイムスタンプから取得します。イベントタイプ explicit
	回収電話を記録	回収担当者が延滞した請求書について顧客に電話し、その内容を手動で記録したことを示します。担当者は電話の詳細と結果をHighRadiusに直接入力します。
重要な理由回収電話成功率と回収アクティビティ効率を評価するうえで重要なアクティビティです。自動化された回収活動と手動の回収活動を区別できます。入手先回収担当者がHighRadiusの請求書または顧客アカウントで「電話を記録」または「アクティビティを追加」機能を使うと作成される明示的なイベントです。タイムスタンプも記録されます。取得回収担当者が手動操作を記録するアクティビティログテーブルから取得します。イベントタイプ explicit
	延滞リマインダーを送信	延滞した請求書について、顧客に自動または手動でリマインダーを送信したことを示します。HighRadiusでは督促戦略の一環として自動化され、通信履歴が作成されます。
重要な理由督促効果率を測定するうえで欠かせないアクティビティです。支払いを受け取るまでに必要なリマインダーの回数を分析できます。入手先通常は、HighRadius Collections Cloud内の請求書に関するアクティビティログまたは通信ログに記録されます。送信したリマインダーごとに、対応する記録とタイムスタンプが残ります。取得請求書に関連付けられたタイムスタンプ付き通信ログから取得します。イベントタイプ explicit
	支払約束を登録	顧客が将来の日付に請求書を支払う約束をし、回収担当者がその約束をシステムに記録した時点で発生します。回収プロセスにおける前向きな中間成果です。
重要な理由支払約束を追跡すると、キャッシュフローを予測し、回収担当者の効果を評価できます。約束した日までに支払いが行われない、約束不履行の分析にも役立ちます。入手先担当者が請求書に関連付けられた「支払約束」レコードをHighRadiusで作成した時点に記録される明示的なイベントです。このレコードには独自の作成タイムスタンプがあります。取得 HighRadiusの「支払約束」オブジェクトの作成タイムスタンプから取得します。イベントタイプ 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を固定値として設定します。
「Payment Due Date Passed」イベントを設定：このイベントは条件付きです。DueDateが過去の日付で、PaymentStatusが「Open」または「Overdue」のままになっている請求書を対象とするデータブロックを作成します。該当レコードのActivityNameには「Payment Due Date Passed」を設定し、EventTimeにはDueDate自体を使用します。
回収担当者と紛争情報を追加：CollectionsモジュールとDisputesモジュールのデータを含めます。CollectorNotesやActivityHistoryなどのオブジェクトを結合してCollectorNameを取得します。該当する場合は、Disputesオブジェクトを結合してDisputeReasonを取得します。
レポートのフィルターを設定：抽出範囲を定義するフィルターを適用します。データ量を管理しやすくするため、EventTimeに直近6か月などの期間を設定します。組織構造によっては、特定の会社コードや事業部門による絞り込みも必要です。
レポートを実行してプレビュー：レポートを実行し、データをプレビューします。アクティビティごとに1行があり、InvoiceNumber、ActivityName、EventTimeなどの列が含まれる、必要なイベントログ形式になっていることを確認します。
レポートデータをエクスポート：プレビューに問題がなければ、レポート全体をエクスポートします。プロセスマイニングツールに取り込みやすいCSV形式を選択します。文字化けを防ぐため、エクスポート設定でUTF-8エンコーディングを指定します。
最終データ確認：エクスポートしたCSVファイルを表計算アプリケーションで開きます。15種類のアクティビティがすべて含まれていること、タイムスタンプが正しく整形されていること、主要な属性に想定どおり値が入っていることを確認してから、ProcessMindへアップロードします。

設定

レポート種別：複数のモジュールのデータを組み合わせたカスタムレポートです。HighRadiusのバージョンによっては、Joined Reportと呼ばれる場合や、統合する複数のデータBlocksが必要になる場合があります。
主要データオブジェクト：レポートのベースとして、請求書またはAccounts Receivableオブジェクトから始めます。
二次データオブジェクト：CreditRequests、CustomerCommunications、DunningHistory、CollectorActivityLog、PromiseToPay、DisputeCase、CashApplicationなどの追加オブジェクトにリンクする必要があります。
日付範囲フィルター：主要なイベントタイムスタンプフィールドにフィルターを適用します。詳細度とパフォーマンスのバランスを取るため、3～6か月分のデータを抽出することを推奨します。たとえば、EventTimeを過去180日以内に設定します。
ステータスフィルター：分析対象のプロセスに含める必要がない場合は、CancelledやDraftなど、関係のない請求書ステータスを除外することを検討してください。
権限：レポートを実行するユーザーアカウントには、完全なデータセットを抽出できるよう、Credit、Collections、異議申し立て、Cash Applicationなど、関連するすべてのモジュールへの読み取りアクセス権が必要です。

a サンプルクエリ sql

/*
 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 install pandas requestsでインストールできます。また、請求書、Collections、Disputes、Paymentsなど必要なデータオブジェクトへの読み取り権限を持つHighRadius管理者から、API認証情報（Client IDとClient Secret）を取得します。
スクリプトを初期化：たとえばextract_hr_data.pyという新しいPythonスクリプトファイルを作成します。必要なライブラリ（requests、pandas、datetime）をインポートし、HighRadius APIのベースURL、クライアント認証情報、抽出対象期間を指定するプレースホルダー定数を定義します。
認証を実装：認証を処理する関数を作成します。この関数では、Client IDとSecretを使ってHighRadiusの認証エンドポイント（例：/auth/v1/token）へPOSTリクエストを送り、ベアラートークンを取得します。このトークンを、その後のすべてのデータリクエストのヘッダーで使用します。
主要な請求書データを取得：主要な請求書エンドポイント（例：/invoices/v1/search）を検索する関数を作成します。指定期間内のすべてのレコードを取得できるよう、ページネーションを処理します。ページがなくなるまでAPIを繰り返し呼び出し、請求書データを収集します。取得した主要な請求書データは辞書のリストに保存します。
関連オブジェクトのデータを取得：Disputes、Collection Notes、Paymentsなど、各主要データエンティティについて個別の取得関数を作成します。これらの関数では、それぞれのエンドポイント（例：/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には支払期日自体を設定します。
Collections・Disputesイベントを生成：CollectionsとDisputesのエンドポイントから取得したデータを処理します。各メモ、支払約束、督促アクション、紛争レコードについて、対応するイベントログ行（「Overdue Reminder Sent」「Collection Call Logged」「Promise to Pay Created」「Dispute Registered」「Dispute Resolved」）を作成します。CollectorNameやDisputeReasonなどの関連情報をイベントレコードに割り当てます。
支払いイベントを生成：Cash Applicationモジュールの支払いデータを処理します。支払いの作成日または銀行明細日付に基づいて「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認証情報：Client IDとClient Secretを持つ専用APIユーザーが必要です。このユーザーには、請求書、顧客、Collectionsアクティビティ、Disputes、Cash Applicationなど、関連するすべてのAPIエンドポイントへの読み取り権限が必要です。
期間：PythonスクリプトにはSTART_DATEとEND_DATEの変数が含まれています。データ量を抑え、スクリプトの実行時間が過度に長くならないよう、3～6か月など、具体的で適切な期間を設定することが重要です。請求書の作成日や更新日など、インデックスが設定された日付フィールドで絞り込みます。
エンドポイントURL：/invoices/v1/searchなどのAPIエンドポイントパスはプレースホルダーです。組織のHighRadius APIドキュメントで正しいエンドポイントURLを確認してください。
ページネーションパラメーター：スクリプトでは、APIのページネーション方式を正しく処理する必要があります。通常はlimitとoffsetパラメーター、またはカーソル方式を使用します。ページサイズは100～500から始めるとよいでしょう。
実行環境：特に大規模な抽出では、DataFrameを処理できる十分なメモリを備えた安定した環境でスクリプトを実行します。本番規模の抽出では、ローカルマシンよりサーバーでの実行が適しています。
カスタムフィールド：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の業務を最適化し、キャッシュフローを改善しましょう。

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

信用管理・債権回収の最適化を開始

ボトルネックを解消し、処理時間を30％短縮して、業務効率を高めます。

無料トライアルを開始

クレジットカードは不要です。数分で始められます。

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

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

与信管理・債権回収の属性

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

抽出ガイド

HighRadiusのレポーティング・分析モジュールからのエクスポート

ステップ

設定

a サンプルクエリ sql

HighRadius REST APIを使ったPythonスクリプトによる抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

信用管理・債権回収の最適化を開始

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

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

与信管理・債権回収の属性

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

抽出ガイド

HighRadiusのレポーティング・分析モジュールからのエクスポート

ステップ

設定

a サンプルクエリ sql

HighRadius REST APIを使ったPythonスクリプトによる抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

信用管理・債権回収の最適化を開始

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