> 継続的なプロセス改善 > 売掛金 > HighRadius > データテンプレート

売掛金管理データテンプレート

HighRadius

売掛金管理データテンプレート

このテンプレートでは、HighRadiusの請求ワークフローを分析するために必要な要素を整理しています。必要なデータ項目、プロセス上の節目、詳細なイベントログを作成するための技術的な手順を体系的に確認できます。このガイドに沿って進めることで、回収サイクルを正確にマッピングし、キャッシュフロー改善の機会を特定できます。

プロセスに固有のデータ属性
標準化されたアクティビティの節目
HighRadiusからのデータ抽出手順

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

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

売掛金の属性

この表では、請求書管理と債権回収のパフォーマンスを分析するための詳細なイベントログを作成する際に必要となる、推奨データ項目を示します。

3 必須 6 推奨 10 任意

	名前	説明
	アクティビティ ActivityName	請求書に対して実行されたイベントまたはアクションの名称です。
説明この属性は、売上債権回収ライフサイクルで発生した具体的なステップまたはアクションを記録します。請求書の作成、自動通知、回収担当者による電話、紛争の記録、支払いの適用などのイベントを取得します。アナリストはこのフィールドを使ってプロセスフローを再構築し、ステップの順序を可視化します。アクティビティの順序の違いから、プロセス逸脱、やり直しのループ、コンプライアンス違反の行動を特定できます。重要な理由プロセスのステップを定義し、プロセスディスカバリーとバリアント分析に欠かせません。入手先 HighRadiusアクティビティログ、メモ履歴、または取引履歴テーブル例請求書作成支払いリマインダー送信紛争案件の開始全額支払い受領
	イベントタイムスタンプ EventDateTime	アクティビティが発生した具体的な日付と時刻です。
説明この属性は、HighRadiusシステム内でイベントが発生した正確な時点を示します。アクティビティの順序付けや、プロセスステップ間の所要時間の計算に必要な時間情報を提供します。分析では、売上債権回転日数（DSO）や紛争解決時間などのサイクル時間を計算するためにタイムスタンプを使います。また、特定の期間における処理量やリソース利用状況の分析も可能にします。重要な理由期間ベースのすべてのKPIを計算し、イベントを正しい順序に並べるには、正確な時刻情報が必要です。入手先 HighRadius取引ログのタイムスタンプ列例 2023-10-01T08:30:00Z2023-10-15T14:22:10Z2023-11-05T09:15:00Z
	請求書番号 InvoiceNumber	請求書伝票を一意に識別する番号であり、ケースIDとして機能します。
説明請求書番号は、財務上の債務を作成から最終決済まで追跡するための中心的な識別子です。紛争、支払い約束、支払いなど、関連するすべてのアクティビティを1つのケース履歴に紐づけます。分析では、この属性を使ってイベントログを個別のプロセスインスタンスにグループ化します。請求書ごとのサイクル時間を計算できるほか、HighRadius環境または元のERPにある他のマスターデータテーブルとプロセスデータを結合する際の主キーになります。重要な理由一意のケースを識別し、すべてのイベントが特定の財務取引に正しく関連付けられていることを保証します。入手先 HighRadius請求書データ／ヘッダーテーブルまたは元のERP（例：SAP VBAK、Oracle Headers）例 INV-2023-001900123456US-102938550002931
	回収担当者名 CollectorName	回収活動を担当するエージェントまたはユーザーの名称です。
説明この属性は、電話の記録、個別メールの送信、紛争の確認など、手動アクティビティを実行したHighRadiusのユーザーまたは担当者を特定します。「回収担当者の生産性ベンチマーク」ダッシュボードで、個人のパフォーマンスや業務量の配分を評価するために使います。管理者は、トレーニングの必要性を特定したり、回収チーム内で担当ポートフォリオを再配分したりできます。重要な理由リソース単位でパフォーマンスを分析できます。入手先アクティビティログ／ユーザーテーブル例 John DoeJane Smithシステム管理者CollectionAgent_01
	支払期日 DueDate	顧客が契約上、支払う義務を負う日付です。
説明支払期日は、請求書の作成日に適用された支払条件によって決まります。回収プロセスの目標期限になります。全額支払い受領日とこの属性を比較することで、支払条件コンプライアンス率を計算できます。支払いが期日どおりか、遅延しているか、早期かを判断するうえで欠かせません。重要な理由支払いの遅延を判断し、売上債権回転日数（DSO）を計算するための基準点です。入手先請求書ヘッダーテーブル（Due Dateフィールド）例 2023-11-302023-12-15
	支払条件差異 PaymentTermVariance	支払期日から支払日までの日数です。
説明この計算属性は、合意した支払条件からの差異を測定します。正の値は支払いの遅延を、負の値は期日前の支払いを示します。支払条件コンプライアンス監査で直接使用する指標です。この差異を集計することで、恒常的に支払いが遅れる顧客を特定し、与信条件や回収戦略を適切に見直せます。重要な理由顧客が契約条件を遵守しているかを直接測定します。入手先支払期日と支払日から算出例 5日-2日0日
	自動実行 IsAutomated	アクティビティが人手を介さずにシステムによって実行されたかどうかを示すフラグです。
説明このブール属性は、HighRadiusの自動化エンジンが実行したステップ（自動通知や入金照合など）と、ユーザーが手動で行ったステップを区別します。「入金消込自動化トラッカー」や「人手を介さない請求書率」KPIに欠かせません。自動化の投資対効果を測定し、依然として多くの手作業を必要とするプロセスステップを特定できます。重要な理由 HighRadius導入の効率を測定します。入手先アクティビティログ（システムユーザーと人間ユーザーの判定）例 truefalse
	請求書金額 InvoiceAmount	請求書の金銭的な総額です。
説明この属性は、顧客に請求した当初の総額を表します。未回収残高の計算や、紛争・遅延による財務的影響の評価における基準になります。プロセスマイニング分析では、このフィールドを使ってケースを金額で重み付けします。たとえば、「少額紛争件数」KPIで、高額の優先回収案件と少額の事務的なノイズを区別できます。重要な理由案件数だけでなく、財務的な影響に基づいて分析に重みを付けられます。入手先請求書ヘッダーテーブル（Amountフィールド）例 1500.00250.5010000.00
	顧客名 CustomerName	請求書に関連付けられた顧客アカウントの名称です。
説明この属性は、請求書の支払い責任を負う企業または個人を識別します。HighRadiusでは、債務者のマスターデータレコードに紐づきます。顧客名ごとにプロセスのパフォーマンスを分析すると、個別の回収戦略が必要なアカウントや、支払い遅延が常態化しているアカウントを特定できます。「顧客リスクと滞留マトリクス」ダッシュボードを支えます。重要な理由アカウント別に分析を分け、問題のある顧客を見つけるために欠かせません。入手先顧客マスターデータまたは請求書ヘッダー例 Acme CorpGlobal IndustriesTechStart IncRetail Giant Ltd
	ソースシステム SourceSystem	データの発生元となったシステムの名称です。
説明この属性は、データポイントがHighRadiusプラットフォームのモジュール（Collections CloudやCash Application Cloudなど）で直接生成されたものか、外部ERPシステム（SAPやOracleなど）から取り込まれたものかを示します。データの系譜や検証に役立ちます。プロセス上の摩擦を分析する際、ソースシステムを把握することで、遅延が連携の遅れによるものか、システム固有の処理時間によるものかを特定できます。重要な理由複数のERPからHighRadiusにデータを供給する環境で、データの発生元に関する背景を提供します。入手先システム設定または抽出ロジックに基づくハードコード値例 HighRadiusSAP ECCOracle NetSuiteMicrosoft Dynamics
	事業部門 BusinessUnit	請求書を発行した社内の部門または子会社です。
説明この属性は、「北米営業」、「EMEAサービス」、特定の製品部門など、組織構造に基づいてデータを分類します。「支払条件コンプライアンス監査」で、組織内の各部門のパフォーマンスを比較できます。回収上の問題が組織全体に共通するのか、特定の業務慣行に限られるのかを切り分けるのに役立ちます。重要な理由組織内の異なる事業領域を比較分析できます。入手先請求書ヘッダー／ERPマッピング例家電産業部品ソフトウェアサービスNA-West
	信用格付け CreditRating	顧客に付与された信用力スコアまたは格付けです。
説明この属性は顧客のリスク水準を示し、信用調査機関やHighRadius Credit Cloudの社内スコアリングから取得されることがよくあります。「顧客リスクと滞留マトリクス」の分析軸です。滞留状況を信用格付けと照合することで、格付けが低い顧客に多額の未回収残高がある高エクスポージャーのリスクを特定できます。重要な理由リスク管理と回収の優先順位付けに欠かせません。入手先与信管理モジュール／顧客マスター例 AAAB+高リスク低リスク
	最終データ更新 LastDataUpdate	マイニングモデル内のデータが最後に更新された時点のタイムスタンプです。
説明この属性は、レコードが抽出された時点、またはプロセスマイニングデータセットが最後に更新された時点を記録します。アナリストがデータの最新性やレポート上の潜在的な遅延を把握できるようにします。リアルタイムデータを見ているのか、前日のスナップショットを見ているのかを確認する必要がある、継続監視用ダッシュボードで特に重要です。重要な理由 KPIに使うデータの最新性を透明性のある形で確認できます。入手先 ETLタイムスタンプ例 2023-12-01T00:00:00Z2023-12-02T06:00:00Z
	地域 Region	請求書または顧客に関連付けられた地理的地域です。
説明この属性は、取引に関連する「北米」「EMEA」「APAC」などの地理的地域を定義します。地域別のベンチマークや、文化・規制の違いが支払行動や回収速度に与える影響の把握に役立ちます。経営層向けの概要レポートにも適しています。重要な理由地域別のパフォーマンス分析を支援します。入手先顧客マスターデータまたは請求書ヘッダー例 NAEMEALATAMAPAC
	支払い約束日 PromiseToPayDate	顧客が支払いを行うと約束した日付です。
説明この属性は、回収対応の中で顧客が提示した支払い約束日を記録します。HighRadius Collections Cloudの主要機能です。「支払い約束信頼性指数」では、この日付と実際の支払日を比較し、顧客が約束を守ったかどうかを判断します。約束の確度や、回収担当者の交渉の有効性を評価できます。重要な理由キャッシュフローの予測と顧客の信頼性の測定に欠かせません。入手先 Collectionsモジュール／P2P取引テーブル例 2023-12-102023-12-20
	未決済残高 OpenAmount	請求書に残っている未払い残高です。
説明この属性は、顧客が現在も支払う必要のある金額を追跡します。一部入金が計上されると更新されます。一部入金の複雑性分析に欠かせません。全額未決済の請求書と一部入金済みの請求書を絞り込み、高額な未決済項目を優先して回収できます。重要な理由現在の未回収リスクと一部回収の成果を判断するうえで重要です。入手先請求書ヘッダー／未決済項目テーブル例 0.00500.0012000.00
	紛争理由コード DisputeReasonCode	紛争案件に割り当てられたカテゴリコードです。
説明この属性は、「価格の誤り」、「商品の破損」、「書類不足」など、顧客が支払いを拒否した理由を分類します。HighRadius Deductions Cloudでは、標準コードが使われます。これらのコードを分析することで、未払いの根本原因を特定できます。データを集計すれば、下流の回収遅延を引き起こしている営業や物流など、上流の問題を解決できます。重要な理由支払い遅延の根本原因分析に欠かせません。入手先紛争／控除管理モジュール例 P01（価格）Q02（品質）S03（不足）管理上のエラー
	通貨コード CurrencyCode	請求金額に使用するISO通貨コードです。
説明この属性は、請求書が発行された通貨を指定します（例：USD、EUR、GBP）。グローバルなプロセスを分析する際、請求金額と未決済残高を正しく解釈するために必要です。通常はレポート通貨に換算して集計することで、正確な分析が可能になります。重要な理由複数通貨環境で正確に財務集計するために必要です。入手先請求書ヘッダー例 USDEURGBPJPY
	顧客セグメント CustomerSegment	規模、業種、戦略上の価値などに基づく顧客の分類です。
説明この属性は、顧客を「戦略顧客」、「中堅市場」、「中小企業」、「高リスク」などの層に分類します。「紛争解決パフォーマンス」ダッシュボードで、セグメントごとにサービス水準が異なるかを確認するために使います。回収プロセスで高価値の顧客に適切な対応が行われていることを確認できます。重要な理由事業戦略やサービスレベル合意に沿ってセグメント分析を行えます。入手先顧客マスターデータ例戦略的主要顧客卸売小売政府

必須推奨任意

売掛金のアクティビティ

請求書の一連の流れを可視化するために取得すべき、重要なプロセス手順と取引上の節目です。

8 推奨 5 任意

	アクティビティ	説明
	全額支払い受領	債務を全額消滅させる入金です。滞留期間の計算では、この支払いの効力発生日になります。
重要な理由「支払い約束履行率」および実績キャッシュフローと予測キャッシュフローの計算に使います。入手先最終消込伝票に紐づく支払い取引日です。取得消込支払いの取引日を記録イベントタイプ explicit
	支払いリマインダー送信	Collectionsモジュールを通じて顧客に送信される自動通知（メールまたは書面）です。督促戦略の実行状況を追跡します。
重要な理由通知によって実際に支払いが促されたかを測定する「回収リマインダー効果」ダッシュボードに欠かせません。入手先請求書IDに紐づく通知履歴タブまたはコミュニケーションログです。取得督促戦略がアクションを実行した時点で記録イベントタイプ explicit
	支払い約束の作成	顧客が特定の金額を特定の日付までに支払うと約束した内容を、システムに正式に記録したものです。
重要な理由キャッシュフローの予測や顧客の信頼性の測定に使う「支払い約束信頼性指数」に欠かせません。入手先請求書に紐づくP2P（Promise to Pay）モジュール／タブです。取得 P2Pレコードが作成された時点で記録イベントタイプ explicit
	紛争案件の開始	請求書に紐づく控除または紛争案件の作成です。顧客が残高の一部または全額の支払いを拒否したことを示します。
重要な理由「紛争解決パフォーマンス」分析を開始し、紛争対象額について通常の督促を一時停止します。入手先控除／紛争モジュール。請求書に紐づく案件IDの作成タイムスタンプです。取得紛争案件が生成された時点で記録イベントタイプ explicit
	紛争解決	紛争調査の完了であり、有効な控除や無効な請求などの判断に至った状態です。
重要な理由「紛争解決サイクル時間」の計測を停止するイベントです。ここでの遅延は滞留期間に直接影響します。入手先控除モジュール。ステータスが「クローズ」、「解決済み」、または「承認済み」に変更された記録です。取得変更前後のステータスフィールドを比較イベントタイプ inferred
	請求書作成	ERPシステムからHighRadiusプラットフォームに請求書が最初に作成または取り込まれた状態です。回収ライフサイクルの開始点になります。
重要な理由滞留期間の計算と売上債権回転日数（DSO）指標の基準となるタイムスタンプを設定します。入手先請求書番号が最初に表示される未決済請求書テーブルまたはデータ連携ログです。取得請求書ヘッダーテーブルにレコードが挿入された時点で記録イベントタイプ explicit
	請求書消込	請求書残高がゼロになり、システム上でクローズされた最終ステータス変更です。
重要な理由「平均売上債権回転日数」の終了タイムスタンプです。プロセスの完了を示します。入手先請求書ヘッダーテーブル。Status = 「Closed」または「Cleared」。取得変更前後のステータスフィールドを比較イベントタイプ inferred
	銀行取引明細の照合	入金消込エンジンまたはユーザーが、銀行取引明細の明細行をこの請求書に正常に紐づけた状態です。
重要な理由「自動入金消込率」の主要指標です。資金の受領と資金の消込を区別します。入手先入金消込モジュール。照合レコードの作成です。取得照合ルールが実行された時点で記録イベントタイプ explicit
	回収電話記録	回収担当者がこの請求書について記録した手動メモまたは対応履歴です。プロセスに人手が介入したことを示します。
重要な理由「回収担当者の生産性ベンチマーク」を支え、自動回収と手動回収の取り組みを区別できます。入手先 Collectionsモジュール内のメモ／履歴タブです。取得ユーザーが電話メモを保存した時点で記録イベントタイプ explicit
	支払期日超過	請求書が合意された支払条件の期日を過ぎても未決済のままであることを示す計算イベントです。
重要な理由「支払条件コンプライアンス監査」に欠かせません。未経過から期日超過への移行を示します。入手先請求書の支払期日と現在日（未決済の場合）または支払日（決済済みの場合）を比較して計算します。取得期日フィールドとアクティビティ日を比較して導出イベントタイプ calculated
	紛争の調査中	紛争案件が「新規」から調査中のステータスに移行した状態です。アナリストによる実際の作業の開始を示します。
重要な理由「紛争ワークフローのボトルネック検出」で、案件作成から実作業開始までの遅延を測定するために使います。入手先控除モジュールの監査ログ。ステータスが「進行中」または「調査中」に変更された記録です。取得変更前後のステータスフィールドを比較イベントタイプ inferred
	貸方メモ発行	請求書残高を相殺するために貸方メモが生成された状態です。有効な紛争解決や返品がきっかけになることがよくあります。
重要な理由「貸方メモ処理効率」と、紛争解決から財務計上までの時間差を追跡します。入手先元の請求書IDに紐づくERP同期ログまたは貸方メモテーブルです。取得 CMドキュメントが請求書に紐づいた時点で記録イベントタイプ explicit
	部分支払い計上	請求書総額の一部だけを支払う入金が適用され、残高が残っている状態です。
重要な理由「部分支払いの複雑性分析」にデータを提供し、入金消込における摩擦の可能性を示します。入手先入金消込モジュール。Payment Amount < Open Amountとなる、請求書に紐づく支払い取引です。取得支払いが適用されたものの、ステータスが未決済のままの時点で記録イベントタイプ explicit

推奨任意

抽出ガイド

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

ステップ

HighRadius Integrated Receivablesプラットフォームにログインし、AnalyticsまたはReportsモジュールに移動します。
Transaction HistoryまたはOpen Itemsのレポートテンプレートを探します。ライフサイクル全体を取得するには、Invoice Header Data、Collection Activities、Dispute/Deduction Historyの3つのエクスポートを個別に設定する必要がある場合があります。
Invoice Header Exportを設定します。Invoice Number、Customer Name、Invoice Amount、Invoice Date、Due Date、Clear Date、Final Statusの列を選択します。対象のCompany Codeと、プロセスマイニングの対象期間をカバーする作成日範囲でフィルターします。
Collection Activities Exportを設定します。Invoice Number、Activity Type（Call、Email、Note）、Activity Date、Collector Name、Promise to Payの詳細を選択します。自動化されたシステムアクションと手動ユーザーログの両方を含めてください。
Dispute History Exportを設定します。Invoice Number、Dispute Case ID、Dispute Amount、Status Change Date、Reason Code、Resolution Dateの列を選択します。これにより、控除のライフサイクルを取得できます。
Payment/Cash App Exportを設定します。Invoice Number、Payment Reference、Payment Date、Payment Amount、Payment Type（Partial、Full、Credit Memo）の列を選択します。
これらのレポートを実行し、結果をCSV形式でエクスポートします。
これらのCSVファイルをステージングデータベースまたはデータ変換ツール（Python／PandasやSQLデータベースなど）に取り込み、統合処理を行います。
Queryセクションに記載された変換スクリプトを実行し、列名を標準化し、派生イベント（Due Date Passedなど）を計算し、異なるソースを1つのイベントログに統合します。
日付形式が統一されていること（ISO 8601を推奨）、またすべてのファイルでInvoice Numberの形式が同一であることを確認します。形式が異なる場合は、先頭ゼロを削除するなどの調整を行います。
最終結果を1つのCSVファイルとしてエクスポートします。
最終CSVをProcessMindにアップロードし、InvoiceNumberをCase ID、EventDateTimeをTimestamp、ActivityNameをActivityにマッピングします。

設定

日付範囲：ライフサイクル全体を取得できるよう、Invoice Creation Dateを基準に、過去12か月などの移動期間を選択します。
データソース：Collections、Cash Application、Deductionsモジュールへのアクセスが必要です。
粒度：レポートはAccountレベルやSummaryレベルではなく、Invoiceレベルで生成します。
ユーザー権限：抽出を行うユーザーには、過去のアクティビティログにアクセスするためのReportingまたはAnalytics Admin権限が必要です。
システムアクション：ActivityログにSystemまたはAutomated Userのアクションを含めるフィルターを明示的に有効にし、自動送信された連絡を取得します。
必要なマッピング：HighRadiusのアクティビティタイプは、標準的なプロセスマイニングのアクティビティ名にマッピングする必要がある場合があります。例：Dunning LetterをPayment Reminder Sentにマッピングします。

a サンプルクエリ sql

/* 
Title: HighRadius Event Log Transformation Script
Description: This script assumes the raw CSV exports from HighRadius have been loaded into four staging tables:
1. STG_INVOICES (Header data)
2. STG_ACTIVITIES (Collections notes, calls, correspondence)
3. STG_DISPUTES (Deduction and dispute lifecycle)
4. STG_PAYMENTS (Cash application details)
*/

/* 1. Invoice Created */
SELECT 
    InvoiceNumber AS InvoiceNumber,
    'Invoice Created' AS ActivityName,
    InvoiceDate AS EventDateTime,
    CustomerName AS CustomerName,
    InvoiceAmount AS InvoiceAmount,
    DueDate AS DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL AS PaymentTermVariance,
    0 AS DaysSalesOutstanding
FROM STG_INVOICES

UNION ALL

/* 2. Payment Reminder Sent */
SELECT 
    InvoiceNumber,
    'Payment Reminder Sent',
    ActivityDate,
    CustomerName,
    NULL,
    NULL,
    UserName AS CollectorName,
    CASE WHEN UserName = 'System' THEN 'True' ELSE 'False' END,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType IN ('Dunning', 'Correspondence', 'Email Sent')

UNION ALL

/* 3. Collection Call Logged */
SELECT 
    InvoiceNumber,
    'Collection Call Logged',
    ActivityDate,
    CustomerName,
    NULL,
    NULL,
    UserName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType IN ('Call', 'Outbound Call')

UNION ALL

/* 4. Promise to Pay Created */
SELECT 
    InvoiceNumber,
    'Promise to Pay Created',
    PromiseDate,
    CustomerName,
    PromiseAmount,
    NULL,
    UserName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType = 'Promise to Pay' AND PromiseDate IS NOT NULL

UNION ALL

/* 5. Dispute Case Opened */
SELECT 
    InvoiceNumber,
    'Dispute Case Opened',
    CreateDate,
    CustomerName,
    DisputeAmount,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES

UNION ALL

/* 6. Dispute Under Review */
SELECT 
    InvoiceNumber,
    'Dispute Under Review',
    StatusDate,
    CustomerName,
    NULL,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES
WHERE Status = 'In Review'

UNION ALL

/* 7. Dispute Resolved */
SELECT 
    InvoiceNumber,
    'Dispute Resolved',
    ResolutionDate,
    CustomerName,
    NULL,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES
WHERE Status IN ('Closed', 'Resolved', 'Denied', 'Approved')

UNION ALL

/* 8. Credit Memo Issued */
SELECT 
    InvoiceNumber,
    'Credit Memo Issued',
    PaymentDate,
    CustomerName,
    PaymentAmount,
    NULL,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    NULL
FROM STG_PAYMENTS
WHERE PaymentType = 'Credit Memo'

UNION ALL

/* 9. Partial Payment Posted */
SELECT 
    P.InvoiceNumber,
    'Partial Payment Posted',
    P.PaymentDate,
    I.CustomerName,
    P.PaymentAmount,
    I.DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, I.DueDate, P.PaymentDate) AS PaymentTermVariance,
    DATEDIFF(day, I.InvoiceDate, P.PaymentDate) AS DaysSalesOutstanding
FROM STG_PAYMENTS P
JOIN STG_INVOICES I ON P.InvoiceNumber = I.InvoiceNumber
WHERE P.PaymentType = 'Payment' AND P.PaymentAmount < I.InvoiceAmount

UNION ALL

/* 10. Bank Statement Matched */
SELECT 
    InvoiceNumber,
    'Bank Statement Matched',
    MatchDate,
    CustomerName,
    NULL,
    NULL,
    'CashApp System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    NULL
FROM STG_PAYMENTS
WHERE MatchDate IS NOT NULL

UNION ALL

/* 11. Full Payment Received */
SELECT 
    P.InvoiceNumber,
    'Full Payment Received',
    P.PaymentDate,
    I.CustomerName,
    P.PaymentAmount,
    I.DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, I.DueDate, P.PaymentDate) AS PaymentTermVariance,
    DATEDIFF(day, I.InvoiceDate, P.PaymentDate) AS DaysSalesOutstanding
FROM STG_PAYMENTS P
JOIN STG_INVOICES I ON P.InvoiceNumber = I.InvoiceNumber
WHERE P.PaymentType = 'Payment' AND P.PaymentAmount >= I.InvoiceAmount

UNION ALL

/* 12. Due Date Passed */
SELECT 
    InvoiceNumber,
    'Due Date Passed',
    DueDate,
    CustomerName,
    InvoiceAmount,
    DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    DATEDIFF(day, InvoiceDate, DueDate) AS DaysSalesOutstanding
FROM STG_INVOICES
WHERE DueDate < GETDATE() AND (ClearDate IS NULL OR ClearDate > DueDate)

UNION ALL

/* 13. Invoice Cleared */
SELECT 
    InvoiceNumber,
    'Invoice Cleared',
    ClearDate,
    CustomerName,
    InvoiceAmount,
    DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, DueDate, ClearDate) AS PaymentTermVariance,
    DATEDIFF(day, InvoiceDate, ClearDate) AS DaysSalesOutstanding
FROM STG_INVOICES
WHERE ClearDate IS NOT NULL

ステップ

前提条件と環境設定 Python 3.8以降がインストールされていることを確認します。requestsとpandasライブラリが必要です。インストールされていない場合は、pipでインストールします。HighRadiusのAPI Client ID、Client Secret、Base URLをシステム管理者から取得します。通常はHighRadiusのAdministrationまたはDeveloper Portalセクションで確認できます。
API接続情報の設定 提供されたPythonスクリプトを開きます。先頭にある設定セクションを探し、CLIENT_ID、CLIENT_SECRET、BASE_URLのプレースホルダーを置き換えます。これらの接続情報に関連付けられたユーザーが、Collections、Cash Application、Deductionsモジュールにアクセスできることを確認します。
データ抽出パラメーターの設定 スクリプトでSTART_DATEとEND_DATEの変数を定義します。タイムアウトを避けるため、月単位または四半期単位でデータを抽出することを推奨します。スクリプトは標準のISO 8601日付形式（YYYY-MM-DD）を想定しています。
スクリプト実行：認証 スクリプトはまずOAuth2フローを実行し、ベアラートークンを取得します。このトークンの有効期間は限られており、通常は1時間です。初回のトークン取得はスクリプトが自動的に処理します。
スクリプト実行：データ取得 スクリプトは特定のエンドポイントに順番にクエリを送信します。まずヘッダーレベルの請求書データを取得し、その後、必要に応じてInvoice Numberを参照キーとして、Activities（Notes）、Promises to Pay、Disputes、Payment Historyの関連エンドポイントを順に処理します。
データ変換とアクティビティマッピング スクリプトは生のJSONレスポンスを、フラット化したイベントログ構造に変換します。HighRadius固有のコードを、必要なActivity Nameにマッピングします。たとえば、invoice_balanceとtotal_amountを比較し、Partial Payment PostedとFull Payment Receivedを区別します。また、Due Date Passedイベントを、期限日と消込日または現在日付の比較によって計算します。
ページネーションの処理 HighRadius APIでは通常、結果がページ分割されます。提供されたスクリプトには、追加のレコードがなくなるまで全ページを取得するループ処理が含まれています。この処理中は、ネットワーク接続が安定していることを確認します。
データの統合 抽出したすべてのリスト（Invoices、Activities、Disputes、Payments）を1つのPandas DataFrameに統合します。イベントの流れが時系列になるよう、InvoiceNumberとEventDateTimeでDataFrameを並べ替えます。
検証と品質確認 確定する前に、抽出された一意のアクティビティの概要をスクリプトに出力させます。件数が業務上の処理量と比べて妥当であることを確認します。EventDateTime列がYYYY-MM-DD HH:MM:SS形式で正しく設定されていることも確認します。
CSVへのエクスポート 最終DataFrameをHighRadius_EventLog.csvというファイル名でエクスポートします。このファイルには、ProcessMindに必要な列が設定されています。
最終確認 CSVファイルを開きます。InvoiceNumberまたはActivityNameにNULL値がないことを確認します。Due Dateなど予定された期限日を示す場合を除き、日付が未来になっていないことを確認します。EventDateTimeは常に過去または現在である必要があります。
ProcessMindへのアップロード 生成したCSVファイルをProcessMindにインポートします。InvoiceNumberをCase ID、ActivityNameをActivity、EventDateTimeをTimestampにマッピングします。

設定

**API Base URL：**Production環境とSandbox環境のどちらに接続するかを確認します。通常、URL構造が異なります。例：https://[client].highradius.com/apiとhttps://[client]-sandbox.highradius.com/api。
**クライアントの対象範囲：**API ClientにradiusOne、collections、deductions、cashAppの各スコープへのreadアクセスがあることを確認します。
**日付範囲：**トランザクション量が多い場合（1か月あたり10万件を超える請求書）、1回の実行で抽出する期間を3か月以下にします。
**ページネーション上限：**スクリプトの既定値は1ページあたり1,000件です。サーバーでタイムアウトエラーが発生する場合は、API呼び出しのlimitパラメーターを調整します。
**スロットリング／レート制限：**HighRadiusではレート制限が適用される場合があります。HTTP 429エラーが発生した場合は、ページネーションループ内にtime.sleep(1)を追加します。

a サンプルクエリ python

import requests
import pandas as pd
import json
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
BASE_URL = class="hl-string">"https://[Your Instance].highradius.com/api/v1"
TOKEN_URL = class="hl-string">"https://[Your Instance].highradius.com/oauth/token"
CLIENT_ID = class="hl-string">"[Your Client ID]"
CLIENT_SECRET = class="hl-string">"[Your Client Secret]"
SCOPE = class="hl-string">"read_write"

class=class="hl-string">"hl-comment"># Extraction Window
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-01-31"

class=class="hl-string">"hl-comment"># Global container for event log rows
event_log = []

def get_access_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,
        class="hl-string">'scope': SCOPE
    }
    try:
        response = requests.post(TOKEN_URL, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except Exception as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return None

def fetch_paged_data(endpoint, token, params={}):
    headers = {class="hl-string">"Authorization": fclass="hl-string">"Bearer {token}", class="hl-string">"Content-Type": class="hl-string">"application/json"}
    all_records = []
    page = 1
    while True:
        params[class="hl-string">'page'] = page
        params[class="hl-string">'limit'] = 1000
        try:
            resp = requests.get(fclass="hl-string">"{BASE_URL}/{endpoint}", headers=headers, params=params)
            if resp.status_code != 200:
                break
            data = resp.json()
            records = data.get(class="hl-string">'data', [])
            if not records:
                break
            all_records.extend(records)
            page += 1
        except Exception:
            break
    return all_records

def process_extraction():
    token = get_access_token()
    if not token:
        return

    class=class="hl-string">"hl-comment"># 1. Fetch Invoices (Header Data)
    print(class="hl-string">"Fetching Invoices...")
    invoices = fetch_paged_data(class="hl-string">"invoices", token, {class="hl-string">"filter_date_from": START_DATE, class="hl-string">"filter_date_to": END_DATE})
    
    class=class="hl-string">"hl-comment"># Process Invoice Headers and Derived Events
    invoice_ids = []
    for inv in invoices:
        inv_num = str(inv.get(class="hl-string">'invoice_number', class="hl-string">''))
        cust_name = inv.get(class="hl-string">'customer_name', class="hl-string">'')
        amount = float(inv.get(class="hl-string">'amount', 0.0))
        create_date = inv.get(class="hl-string">'create_date')  class=class="hl-string">"hl-comment"># YYYY-MM-DD
        due_date = inv.get(class="hl-string">'due_date')
        clear_date = inv.get(class="hl-string">'clear_date')
        status = inv.get(class="hl-string">'status', class="hl-string">'Open')
        
        invoice_ids.append(inv_num)
        
        class=class="hl-string">"hl-comment"># Event: Invoice Created
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": class="hl-string">"Invoice Created",
            class="hl-string">"EventDateTime": fclass="hl-string">"{create_date} 00:00:00",
            class="hl-string">"CustomerName": cust_name,
            class="hl-string">"InvoiceAmount": amount,
            class="hl-string">"DueDate": due_date,
            class="hl-string">"IsAutomated": True
        })
        
        class=class="hl-string">"hl-comment"># Event: Invoice Cleared
        if status.lower() in [class="hl-string">'closed', class="hl-string">'cleared'] and clear_date:
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Invoice Cleared",
                class="hl-string">"EventDateTime": fclass="hl-string">"{clear_date} 23:59:59",
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })
             
        class=class="hl-string">"hl-comment"># Event: Due Date Passed (Calculated)
        class=class="hl-string">"hl-comment"># Logic: If closed and cleared after due date OR if open and today is after due date
        d_due = datetime.strptime(due_date, class="hl-string">"%Y-%m-%d")
        limit_date = datetime.strptime(clear_date, class="hl-string">"%Y-%m-%d") if clear_date else datetime.now()
        
        if limit_date > d_due:
            overdue_ts = d_due + timedelta(days=1)
            event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Due Date Passed",
                class="hl-string">"EventDateTime": overdue_ts.strftime(class="hl-string">"%Y-%m-%d %H:%M:%S"),
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })

        class=class="hl-string">"hl-comment"># Event: Credit Memo Issued
        if inv.get(class="hl-string">'document_type', class="hl-string">'').lower() == class="hl-string">'credit_memo':
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Credit Memo Issued",
                class="hl-string">"EventDateTime": fclass="hl-string">"{create_date} 12:00:00",
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })

    class=class="hl-string">"hl-comment"># 2. Fetch Activities / Notes (Calls, Reminders)
    print(class="hl-string">"Fetching Activities...")
    class=class="hl-string">"hl-comment"># In a real scenario, you might iterate invoice_ids in chunks if the API requires filtering by ID
    class=class="hl-string">"hl-comment"># Here we assume an endpoint allowing date filtering similar to invoices
    activities = fetch_paged_data(class="hl-string">"activities", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    
    for act in activities:
        inv_num = str(act.get(class="hl-string">'invoice_number', class="hl-string">''))
        act_type = act.get(class="hl-string">'activity_type', class="hl-string">'').lower()
        act_date = act.get(class="hl-string">'activity_date') class=class="hl-string">"hl-comment"># Assume valid timestamp
        user = act.get(class="hl-string">'performed_by', class="hl-string">'System')
        
        activity_name = None
        if class="hl-string">'email' in act_type or class="hl-string">'letter' in act_type or class="hl-string">'reminder' in act_type:
            activity_name = class="hl-string">"Payment Reminder Sent"
        elif class="hl-string">'call' in act_type:
            activity_name = class="hl-string">"Collection Call Logged"
            
        if activity_name:
            event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": activity_name,
                class="hl-string">"EventDateTime": act_date,
                class="hl-string">"CollectorName": user,
                class="hl-string">"IsAutomated": user == class="hl-string">'System'
            })

    class=class="hl-string">"hl-comment"># 3. Fetch Promises to Pay
    print(class="hl-string">"Fetching Promises to Pay...")
    ptps = fetch_paged_data(class="hl-string">"promises", token, {class="hl-string">"created_from": START_DATE, class="hl-string">"created_to": END_DATE})
    for ptp in ptps:
        event_log.append({
            class="hl-string">"InvoiceNumber": str(ptp.get(class="hl-string">'invoice_number', class="hl-string">'')),
            class="hl-string">"ActivityName": class="hl-string">"Promise to Pay Created",
            class="hl-string">"EventDateTime": ptp.get(class="hl-string">'created_at'),
            class="hl-string">"CollectorName": ptp.get(class="hl-string">'created_by'),
            class="hl-string">"IsAutomated": False
        })

    class=class="hl-string">"hl-comment"># 4. Fetch Disputes
    print(class="hl-string">"Fetching Disputes...")
    disputes = fetch_paged_data(class="hl-string">"disputes", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    for disp in disputes:
        inv_num = str(disp.get(class="hl-string">'invoice_number', class="hl-string">''))
        create_ts = disp.get(class="hl-string">'create_date')
        status_history = disp.get(class="hl-string">'status_history', [])
        
        class=class="hl-string">"hl-comment"># Event: Dispute Case Opened
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": class="hl-string">"Dispute Case Opened",
            class="hl-string">"EventDateTime": create_ts,
            class="hl-string">"IsAutomated": False
        })
        
        class=class="hl-string">"hl-comment"># Process Audit Trail for Status Changes
        for history in status_history:
            status = history.get(class="hl-string">'status', class="hl-string">'').lower()
            hist_date = history.get(class="hl-string">'date')
            
            if status == class="hl-string">'in_review' or status == class="hl-string">'investigation':
                event_log.append({
                    class="hl-string">"InvoiceNumber": inv_num,
                    class="hl-string">"ActivityName": class="hl-string">"Dispute Under Review",
                    class="hl-string">"EventDateTime": hist_date,
                    class="hl-string">"IsAutomated": False
                })
            elif status == class="hl-string">'resolved' or status == class="hl-string">'closed':
                 event_log.append({
                    class="hl-string">"InvoiceNumber": inv_num,
                    class="hl-string">"ActivityName": class="hl-string">"Dispute Resolved",
                    class="hl-string">"EventDateTime": hist_date,
                    class="hl-string">"IsAutomated": False
                })

    class=class="hl-string">"hl-comment"># 5. Fetch Payments
    print(class="hl-string">"Fetching Payments...")
    payments = fetch_paged_data(class="hl-string">"payments", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    for pay in payments:
        inv_num = str(pay.get(class="hl-string">'invoice_number', class="hl-string">''))
        pay_date = pay.get(class="hl-string">'payment_date')
        pay_amount = float(pay.get(class="hl-string">'payment_amount', 0.0))
        inv_total = float(pay.get(class="hl-string">'invoice_total_amount', 0.0))
        is_matched = pay.get(class="hl-string">'is_matched', False)
        
        class=class="hl-string">"hl-comment"># Determine Partial vs Full
        class=class="hl-string">"hl-comment"># Note: logic simplified; usually compare accumulated payments
        if pay_amount < inv_total:
            act_name = class="hl-string">"Partial Payment Posted"
        else:
            act_name = class="hl-string">"Full Payment Received"
            
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": act_name,
            class="hl-string">"EventDateTime": pay_date,
            class="hl-string">"InvoiceAmount": inv_total,
            class="hl-string">"IsAutomated": True
        })
        
        class=class="hl-string">"hl-comment"># Event: Bank Statement Matched
        class=class="hl-string">"hl-comment"># Trigger if the system flags this payment as successfully matched to bank line
        if is_matched:
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Bank Statement Matched",
                class="hl-string">"EventDateTime": pay_date, class=class="hl-string">"hl-comment"># Often same time as posting
                class="hl-string">"IsAutomated": True
            })

    class=class="hl-string">"hl-comment"># Export
    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Ensure required columns exist even if empty
    required_cols = [class="hl-string">"InvoiceNumber", class="hl-string">"ActivityName", class="hl-string">"EventDateTime"]
    for col in required_cols:
        if col not in df.columns:
            df[col] = None
            
    class=class="hl-string">"hl-comment"># Fill recommended cols with None if missing
    recommended_cols = [class="hl-string">"CustomerName", class="hl-string">"InvoiceAmount", class="hl-string">"DueDate", class="hl-string">"CollectorName", class="hl-string">"IsAutomated"]
    for col in recommended_cols:
        if col not in df.columns:
            df[col] = None

    df.dropna(subset=[class="hl-string">"InvoiceNumber", class="hl-string">"ActivityName", class="hl-string">"EventDateTime"], inplace=True)
    df.sort_values(by=[class="hl-string">"InvoiceNumber", class="hl-string">"EventDateTime"], inplace=True)
    
    output_file = class="hl-string">"HighRadius_EventLog.csv"
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"Extraction Complete. {len(df)} rows saved to {output_file}")

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

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

請求書のライフサイクルのマッピングを今日から始め、流動性を高め、売上債権回転日数を短縮しましょう。技術導入の各段階で、当社チームがサポートします。

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

売掛金管理を最適化し、今すぐキャッシュフローを回復

自動化されたプロセス分析により、売上債権回転日数を15～20日短縮

無料トライアルを開始

クレジットカード不要……数分でセットアップ

売掛金管理データテンプレート

売掛金管理データテンプレート

売掛金の属性

売掛金のアクティビティ

抽出ガイド

HighRadiusの分析・レポートデータのエクスポート

ステップ

設定

a サンプルクエリ sql

HighRadius REST APIによるデータ抽出

ステップ

設定

a サンプルクエリ python

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

売掛金管理を最適化し、今すぐキャッシュフローを回復

売掛金管理データテンプレート

売掛金管理データテンプレート

売掛金の属性

売掛金のアクティビティ

抽出ガイド

HighRadiusの分析・レポートデータのエクスポート

ステップ

設定

a サンプルクエリ sql

HighRadius REST APIによるデータ抽出

ステップ

設定

a サンプルクエリ python

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

売掛金管理を最適化し、今すぐキャッシュフローを回復

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