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

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

NetSuite

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

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

このテンプレートでは、信用管理・回収プロセスを分析するために必要なデータを収集する方法を詳しく説明します。必須の属性とアクティビティに加え、抽出方法の実務的な指針も示しているため、すぐに準備を始められます。これらの推奨事項に従うことで、プロセス分析と改善に適したデータを整備できます。

収集を推奨する属性
追跡すべき主要アクティビティ
NetSuiteからの抽出方法

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

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

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

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

3 必須 5 推奨 13 任意

	名前	説明
	アクティビティ名 ActivityName	特定の時点で発生した業務アクティビティの名称です。
説明この属性は、「Invoice Generated」「Payment Received」「Dispute Registered」など、与信・回収プロセスにおける特定のステップまたはイベントを示します。これらのアクティビティの順序と頻度を分析することがプロセスマイニングの中心であり、実際のプロセスフロー、逸脱、ボトルネックを明らかにします。重要な理由この属性はプロセスマップの基盤となり、プロセスフローの可視化と分析を可能にします。入手先通常、トランザクションレコード（Invoice、Customer Paymentなど）のステータス変更、またはシステムノート、回収アクティビティ用のカスタムレコード、CRMタスクなどの関連レコードから生成します。例請求書発行延滞通知送信入金請求書貸倒償却
	イベント時刻 EventTime	アクティビティが発生した時点を示すタイムスタンプです。
説明プロセス内の各アクティビティが発生した正確な日時を記録する属性です。サイクルタイム、所要時間、ステップ間の待機時間など、時間に基づくすべての分析の基礎となります。NetSuiteでは通常、関連レコードまたはシステムノートの作成日、あるいは最終更新日がこのタイムスタンプになります。重要な理由サイクルタイムやボトルネックなど、効率分析に欠かせない時間関連のパフォーマンス指標を算出できます。入手先さまざまなレコードの日付フィールドから取得します。たとえば「Invoice Generated」にはInvoiceレコードの「Date Created」を、ステータス変更にはSystem Noteのタイムスタンプを使用します。例 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	請求書番号 InvoiceNumber	各顧客請求書を一意に識別する番号です。
説明 Invoice Numberは、特定の売上債権に関連するすべてのアクティビティを一意に紐付ける主要なケース識別子です。これにより、請求書の作成、以降の与信管理アクション、回収活動による最終的な入金または解決まで、ライフサイクル全体を詳細に分析できます。NetSuiteでは通常、トランザクションタイプが「Invoice」の場合のTransaction IDに該当します。重要な理由請求書の発行から決済までの経過を追跡するための基本キーであり、エンドツーエンドのプロセス分析を可能にします。入手先通常、NetSuiteのInvoiceレコードにある「Transaction ID」（内部ID：tranid）フィールドです。例 INV0012345INV0054321INV0098765
	支払期日 DueDate	請求書の支払い期限となる日付です。
説明 Due Dateは、契約上合意された支払日です。支払いが期日どおりか延滞しているかを判断する基準となります。「On-Time Payment Rate」などのKPIを算出し、期日経過時に督促アクティビティを開始するために欠かせない属性です。重要な理由支払の適時性を測定する主要な基準となり、延滞日数の算出や支払条件のコンプライアンス監視に欠かせません。入手先 Invoiceトランザクションレコードの「Due Date」（内部ID：duedate）フィールドです。例 2023-02-142023-03-312023-04-15
	請求書ステータス InvoiceStatus	ライフサイクルにおける請求書の現在のステータスです。
説明「Open」「Paid In Full」「Overdue」など、請求書の現在の状態を示します。現在処理中または問題のある請求書だけを絞り込み、分析する際に役立ちます。「Overdue Invoices Aging and Status」ダッシュボードでは、この属性を使って未回収債権の状況を把握します。重要な理由請求書ライフサイクルの特定の段階（未決済、延滞、紛争中など）に対象を絞って分析できます。入手先 Invoiceトランザクションレコードの「Status」（内部ID：status）フィールドに該当します。例未処理全額支払済み支払期限超過
	請求書金額 InvoiceAmount	請求書の合計金額です。
説明請求書の支払総額を示します。支払い遅延の財務的影響の特定や、高額請求書の貸倒償却分析など、ほぼすべての分析で使用する重要な財務属性です。回収施策の優先順位付けにも必要な情報を提供します。重要な理由プロセスに金額面の背景情報を加え、高額な延滞請求書の回収を優先するなど、金額に基づく分析を可能にします。入手先 Invoiceトランザクションレコードの「Amount（Total）」（内部ID：total）フィールドです。例 1500.00250.5012500.75
	顧客ID CustomerId	請求書に関連付けられた顧客を一意に識別するIDです。
説明この属性は、NetSuite上の特定の顧客エンティティと請求書を紐付けます。顧客別または顧客グループ別にプロセスパフォーマンスを分析するためのセグメント化に欠かせません。たとえば、戦略顧客と中小企業の支払行動や紛争率を比較できます。重要な理由顧客を軸とした分析を可能にし、支払いが頻繁に遅れる顧客、紛争を申し立てる顧客、標準外のプロセスをたどる顧客を特定できます。入手先 Invoiceトランザクションレコードの「Customer」（内部ID：entity）フィールドです。例 CUST001CUST002CUST003
	顧客セグメント CustomerSegment	規模、業種、地域などによる顧客の分類です。
説明 Customer Segmentは、顧客を「Enterprise」「SMB」「Public Sector」などの意味のあるグループに分類します。この属性は「Collection Strategy Performance by Segment」ダッシュボードに欠かせません。セグメントごとに異なる回収方法の効果を比較し、各グループの行動特性に合わせて戦略を調整できます。重要な理由特定のプロセス上の問題や支払行動が、特定の顧客グループに集中しているかを調べる対象を絞った分析が可能になります。入手先通常、NetSuiteのCustomerレコードにあるカスタムフィールドです。CustomerレコードからInvoiceトランザクションへデータを結合する必要があります。例大企業中堅企業SMB
	ソースシステム SourceSystem	データの抽出元となるシステムです。
説明イベントデータの発生元システムを識別します。このプロセスビューでは値は常に「NetSuite」ですが、データガバナンスのため、また複数システム環境でデータソースを区別するために必須の属性です。重要な理由データの系譜と追跡可能性を確保します。複数の統合システムがある環境では、データ検証とガバナンスのために特に重要です。入手先データ変換処理中に追加される固定値（「NetSuite」）です。例 NetSuite
	ユーザーID UserId	アクティビティを実行したユーザーの識別子です。
説明入金計上や回収電話など、特定のアクティビティを担当した従業員またはシステムユーザーを識別します。作業量の分布やチームパフォーマンスを分析し、トレーニングの必要性を特定できます。自動化されたアクティビティでは、システムユーザーIDが設定される場合があります。重要な理由ユーザーまたはチーム別のパフォーマンス分析を可能にし、作業量の分布や手動介入が発生している箇所を把握できます。入手先トランザクションまたは関連レコード（回収電話のPhone Callレコードなど）にある「Created By」「Modified By」「Owner」などのフィールドから取得します。例 j.doea.smithSYSTEM
	事業部門 BusinessUnit	トランザクションに関連付けられた事業部門または子会社です。
説明請求書を発行した事業部門、部署、または子会社を示します。NetSuite OneWorldアカウントでは通常、「Subsidiary」フィールドに該当します。組織内の各部門に分けてプロセスを分析し、パフォーマンスを比較するとともに、部門固有の問題を特定できます。重要な理由異なる組織単位間でプロセスパフォーマンスを比較でき、異なる管理方法が必要なばらつきを明らかにします。入手先 NetSuite OneWorldでは「Subsidiary」フィールドです。その他のアカウントでは、設定に応じて「Department」または「Class」の場合があります。例米国西部EMEAサービスAPAC製品
	最終データ更新 LastDataUpdate	ソースシステムから最後にデータを更新した時点のタイムスタンプです。
説明この属性は、対象プロセスのデータがプロセスマイニングツールに最後に抽出・更新された時点を示します。分析対象データの鮮度を把握し、最新情報に基づいて意思決定できるようにします。重要な理由データの最新性を明確にし、プロセス分析がどの程度最新の状態かを把握できるようにします。入手先データ抽出時に生成され、データセットに付与される値です。例 2023-10-27T02:00:00Z
	回収担当者名 CollectorName	請求書を担当する回収担当者の名前です。
説明延滞請求書の管理を担当する回収担当者またはリソースを識別します。回収チームのパフォーマンスを比較し、担当者ごとの作業量と効果を把握できます。「Collections Contact Success Rate」などのKPIにも利用できます。重要な理由回収チームのパフォーマンス測定と作業量の平準化を可能にし、回収アクティビティを担当者に紐付けます。入手先通常、CustomerまたはInvoiceレコードのカスタムフィールドです。回収向けのNetSuiteバンドルでこの機能が追加される場合もあります。例 Alice JohnsonRobert Williams未割り当て
	国 Country	顧客の請求先住所の国です。
説明請求書の顧客請求先住所に関連付けられた国を示します。地域による支払行動、回収効果、紛争率の違いを分析するために使用します。地域ごとに回収戦略を調整し、現地の経済状況の影響を把握するのに役立ちます。重要な理由プロセスを地理的にセグメント化でき、支払行動やプロセス効率における地域差を明らかにします。入手先 Invoiceトランザクションの「Billing Address」詳細から取得します。通常はCustomerレコードから引き継がれます。例 USAドイツ日本
	延滞日数 DaysOverdue	請求書が支払期日を過ぎている日数です。
説明請求書の支払期日と現在日（未決済請求書の場合）、または入金日との日数差を測定する計算指標です。回収における基本的なKPIであり、「Overdue Invoices Aging and Status」ダッシュボードで回収施策の分類と優先順位付けに使用します。値が0以下の場合、請求書は延滞していません。重要な理由支払いの遅延度合いを直接測定する指標であり、経過日数レポートの作成と回収アクティビティの優先順位付けに役立ちます。入手先データ変換中に、（現在日または支払日）－支払期日として計算されます。例 1532090
	支払期日内かどうか IsOnTimePayment	支払期日までに支払いを受領したかどうかを示すフラグです。
説明この計算済みのブール型属性は、「支払受領」アクティビティが請求書の「支払期日」以前に発生したかどうかを確認します。「期日内支払率」KPIの計算を簡単にし、期日内の支払いと遅延した支払いを容易にフィルタリングして分析できます。支払状況を明確な二値で示します。重要な理由支払条件のコンプライアンスを評価するためのシンプルな二値指標です。「期日内支払率」の計算とベンチマークを簡単に行えます。入手先データ変換中に、（支払日 <= 支払期日）の場合はTRUE、それ以外の場合はFALSEとして計算されます。例 truefalse
	支払条件 PaymentTerms	請求書について顧客と合意した支払条件です。
説明顧客が請求書を支払う条件を指定する属性で、「Net 30」や「Net 60」などがあります。請求書のDue Dateを算出する基礎となり、顧客が合意した条件を守っているかを分析する「Payment Terms Compliance and Deviations」ダッシュボードに欠かせません。重要な理由支払スケジュールの契約上の基礎となり、コンプライアンスの分析やキャッシュフローに影響する逸脱の特定に欠かせません。入手先 Invoiceトランザクションレコードの「Terms」（内部ID：terms）フィールドです。例 30日後払い60日後払い受領時払い
	支払計上遅延 PaymentPostingLag	支払いを受領してから、システムに計上するまでの時間です。
説明この計算済み期間は、「支払受領」アクティビティ（資金を受領した時点）から「支払計上」アクティビティ（NetSuiteで請求書に支払いを適用した時点）までの遅延を測定します。「支払計上遅延分析」ダッシュボードの主要指標であり、入金消込における社内の非効率性がキャッシュの可視性に与える影響を明らかにします。重要な理由入金消込における社内処理の遅延を明らかにし、財務報告の正確性や顧客アカウントのステータスに与える影響を把握できます。入手先プロセスマイニングツールで次のように計算されます：Timestamp('Payment Posted') - Timestamp('Payment Received')。例 1日4時間3日
	紛争理由 DisputeReason	顧客が請求書について申し立てた紛争の理由です。
説明顧客が請求書に異議を申し立てた際、その理由として「Incorrect Pricing」「Damaged Goods」「Duplicate Billing」などを記録します。「Invoice Dispute Resolution Time」や「Invoice Write-Off Root Cause Analysis」ダッシュボードで紛争の発生理由を把握し、将来の問題を防ぐために対処すべきパターンを特定するうえで重要です。重要な理由顧客紛争の根本原因を特定し、受注処理や請求精度など、上流プロセスの改善に必要な情報を提供します。入手先 Invoiceレコードまたは紛争案件の追跡に使用する関連カスタムレコードのカスタムフィールドと考えられます。NetSuiteの標準フィールドではありません。例数量誤り価格差異商品破損
	自動実行かどうか IsAutomated	アクティビティがシステムによって自動実行されたかどうかを示すフラグです。
説明この真偽値属性は、アクティビティが自動化されたワークフローによって実行されたか、人が実行したかを示します。たとえば、「Overdue Reminder Sent」は自動化できますが、「Collection Call Made」は手動です。「Manual Activity Frequency and Impact」ダッシュボードで自動化の度合いを測定し、さらなる自動化の機会を特定するために欠かせません。重要な理由プロセスの自動化レベルを測定し、手作業の削減と効率向上の取り組みを支援します。入手先アクティビティの種類または実行ユーザーに基づく派生属性です。たとえば、ユーザーが指定された「SYSTEM」ユーザーである場合、アクティビティを自動実行として登録します。例 truefalse
	請求書から入金までのサイクルタイム InvoiceToCashCycleTime	請求書の発行から最終決済までの合計時間です。
説明この計算済み指標は、「請求書発行」アクティビティから「請求書決済」アクティビティまでの合計期間を測定します。信用管理・回収プロセス全体のエンドツーエンドのパフォーマンスを示します。このKPIを分析することで、全体的な遅延を特定し、キャッシュフローの速度を把握できます。重要な理由請求書から入金までのプロセス全体の効率を測定する、重要な上位レベルのKPIです。入手先プロセスマイニングツールでケース単位に計算されます：Timestamp('Invoice Settled') - Timestamp('Invoice Generated')。例 32日45日91日

必須推奨任意

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

債権回収ワークフローを正確にディスカバリー・最適化するために、イベントログに記録すべき重要なプロセス手順とマイルストーンです。

5 推奨 8 任意

	アクティビティ	説明
	入金	顧客からの入金が作成され、請求書に適用された時点を示します。NetSuiteのCustomer Paymentトランザクションレコードから直接取得する重要な節目です。
重要な理由 DSOと入金期日遵守率を算出するうえで欠かせないアクティビティです。現金の受領を示し、回収成功を測る主要な指標となります。入手先「Customer Payment」トランザクションレコードの作成日から取得します。このレコードの「Apply」サブリストにより、入金と1件以上の請求書が紐付けられます。取得 Customer Paymentレコードのトランザクション日を使用します。イベントタイプ explicit
	支払期日超過	請求書が全額支払われないまま現在日が支払期日を過ぎたときに発生する計算イベントです。請求書のステータスが「current」から「overdue」に移行したことを示します。
重要な理由このイベントは、すべての回収アクティビティを開始する重要なトリガーです。このイベント後の経過時間を分析することは、回収効率と督促効果を把握するうえで重要です。入手先計算イベントです。Invoiceトランザクションレコードの「Due Date」フィールドと現在日を比較して算出します。イベントのタイムスタンプにはDue Date自体を使用します。取得請求書の「Due Date」フィールドの値をタイムスタンプとして使用します。イベントタイプ calculated
	請求書決済	入金および適用されたクレジットによって未払残高がゼロになり、請求書ライフサイクルが正常に完了した状態です。請求書のステータスが「Paid In Full」に変更された時点から推定します。
重要な理由プロセスが正常に完了したことを示す主要な終了イベントです。エンドツーエンドのInvoice-to-Cashサイクルタイムを算出する際の最終データポイントとなります。入手先 Invoiceトランザクションの「Status」フィールドが「Paid In Full」に変更されたことから推定します。タイムスタンプには、請求書を決済した最終入金またはCredit Memoの日付を使用できます。取得ステータスを「Paid In Full」に変更した最後の入金適用時点のタイムスタンプです。イベントタイプ inferred
	請求書発行	システム上で請求書レコードが正式に作成されたことを示します。このイベントは、NetSuiteのInvoiceトランザクションの作成日から取得され、請求書ライフサイクルの開始点となります。
重要な理由 Invoice-to-Cashプロセスの主要な開始イベントです。売上債権回転日数（DSO）やInvoice-to-Cashサイクルタイム全体などの主要指標を算出するために欠かせません。入手先 NetSuiteのInvoiceトランザクションレコード（Typeが「Invoice」であるTransactionテーブル）の作成日から取得する明示的なイベントです。取得請求書トランザクションレコードの作成タイムスタンプを使用します。イベントタイプ explicit
	請求書貸倒償却	債権が回収不能と判断され、売上債権から除外される、請求書ライフサイクルの不成功の終了です。不良債権に関する仕訳が請求書に適用された時点で取得します。
重要な理由重大な失敗の終了点です。貸倒償却に至る経路を分析すると、与信方針と回収戦略の弱点を特定でき、最終的に不良債権を削減できます。入手先不良債権の貸倒償却を目的とする「Journal Entry」が請求書に適用されたことから推定します。カスタムステータスを使用する場合もあります。取得請求書に適用された貸倒償却用Journal Entryの日付を使用します。イベントタイプ inferred
	Credit Memo発行	請求書に適用されるCredit Memoの作成を示します。多くの場合、誤りの訂正や紛争解決の一環として発行されます。NetSuite上の明示的なトランザクションです。
重要な理由 Credit Memoの発行が頻繁な場合、価格設定の誤りや配送上の問題など、組織的な問題を示している可能性があります。発生状況を分析すると、収益流出の根本原因を特定できます。入手先元の請求書にリンクされたCredit Memoトランザクションレコードの作成日から取得する明示的なイベントです。取得 Credit Memoトランザクションの作成タイムスタンプを使用します。イベントタイプ explicit
	入金計上	入金による財務上の影響が総勘定元帳に正式に記録された日付を示します。Customer Paymentトランザクションの計上日から取得します。
重要な理由「Payment Received」から「Payment Posted」までの時間により、事務処理上の遅延が分かります。この遅延を分析することは、正確かつタイムリーな財務報告を実現するうえで重要です。入手先「Customer Payment」トランザクションの総勘定元帳への影響にある「Posting Period」またはトランザクション日から取得します。取得 Customer PaymentトランザクションのGL計上日を使用します。イベントタイプ explicit
	回収電話実施	回収担当者が電話で顧客に連絡する手動の回収アクティビティです。NetSuiteのCRMモジュールでユーザーが作成したPhone Callアクティビティレコードから取得します。
重要な理由このアクティビティにより、回収プロセスにおける手動作業の量を把握できます。頻度と成功率を分析することは、リソース配分と自動化を最適化するうえで重要です。入手先関連レコードが顧客であり、メッセージに請求書番号が記載された「Phone Call」アクティビティレコードの作成日から取得します。取得 Phone Call CRMアクティビティレコードのタイムスタンプを使用します。イベントタイプ explicit
	延滞通知送信	延滞している請求書について、初回の、多くの場合は自動化された通知を顧客に送信します。このアクティビティは通常、NetSuiteの督促モジュールで作成された督促状、または記録された通信イベントから取得します。
重要な理由このアクティビティは督促プロセスの最初のステップです。頻度と入金への影響を分析することで、初期の回収施策の効果を評価できます。入手先 NetSuite Dunning SuiteAppによって生成された、請求書に関連付けられた「Dunning Letter」レコードの作成日から取得します。取得 Dunning Letterレコードの作成タイムスタンプを使用します。イベントタイプ explicit
	督促手続き開始	延滞請求書に対する正式な督促または回収プロセスの開始を示します。複数のステップで構成される場合があります。請求書に特定の督促レベルが割り当てられた時点で取得します。
重要な理由正式な督促の開始を追跡すると、督促の遵守状況と効果を測定できます。異なる督促戦略が支払い行動に与える影響を分析するための重要な節目です。入手先請求書または顧客レコードの「Dunning Level」が、初めてゼロ以外または初期督促状態に設定された日付から推定します。取得 Dunning Levelフィールドが変更された時点のタイムスタンプを特定します。イベントタイプ inferred
	紛争登録	顧客が請求書に対して正式に異議を申し立て、通常の回収プロセスが停止されたことを示します。通常は、請求書のステータスフィールドが「Disputed」に変更されたことから推定します。
重要な理由紛争解決時間を測定する際の開始点となるイベントです。紛争が頻発している場合、請求または販売プロセスに潜む問題を明らかにできます。入手先システムログ、またはカスタムの「Invoice Status」フィールドが「Disputed」や「In Dispute」などの値に変更された時点のタイムスタンプから推定します。取得紛争を反映するようステータスフィールドが更新された時点のタイムスタンプです。イベントタイプ inferred
	紛争解決	顧客の紛争が解決され、回収プロセスを再開できる状態、または請求書を決済できる状態になったことを示します。請求書のステータスが「Disputed」からアクティブな状態に戻った時点から推定します。
重要な理由紛争解決サイクルタイムを測定する際の終了点です。効率的な紛争解決は、顧客満足度を維持し、キャッシュフローを改善するうえで重要です。入手先システムログ、またはカスタムの「Invoice Status」フィールドが「Disputed」から「Open」や「Resolved」などの値に変更された時点のタイムスタンプから推定します。取得解決済みであることを示すようステータスフィールドが更新された時点のタイムスタンプです。イベントタイプ inferred
	顧客への請求書送付	請求書の内容が顧客に通知された時点を示します。通常はメールで送付されます。このイベントは、請求書トランザクションに関する送信通信を記録するシステムログから推定されることが多いです。
重要な理由このアクティビティを追跡すると、請求書の作成から顧客への通知までの遅延を特定できます。こうした遅延は支払い期間に影響する可能性があります。また、請求に関する通知プロセスの効率も把握できます。入手先 InvoiceトランザクションのCommunication > Messagesサブタブにある、請求書レコードから送信されたメールの日付から推定します。取得請求書にリンクされた「Message」レコードのタイムスタンプを使用します。イベントタイプ inferred

推奨任意

抽出ガイド

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

ステップ

NetSuiteにログイン：保存検索の作成・実行権限と、必要な取引・アクティビティレコード（請求書、顧客支払、電話など）の閲覧権限を持つロールでNetSuiteアカウントにアクセスします。
保存検索へ移動：レポート > 保存検索 > すべての保存検索 > 新規の順に移動します。イベントの種類ごとに複数の検索を作成するため、この手順を繰り返します。
基本となる請求書検索を作成：「請求書発行」イベントの検索から始めます。検索タイプとして「取引」を選択します。この検索で請求書の作成を取得します。
検索条件を定義：「条件」サブタブで、次のフィルターを設定します：
- Type は Invoice。
- Main Line は true。これにより、明細行ごとではなく請求書ごとに1件のレコードを取得できます。
- Date Created は、分析対象期間内（例：過去6か月）。
検索結果を定義：「結果」サブタブで、イベントログに必要な列を追加します。必要な属性名（例：InvoiceNumber）に合わせてカスタムラベルを使用します。ActivityNameフィールドには数式を設定します。詳細なフィールド対応はクエリセクションに記載されています。
他のイベントの検索を作成：クエリセクションの設定に従い、支払い、クレジットメモ、回収電話、ステータス変更などのアクティビティごとに保存検索を作成します。これらでは「電話」など別のレコードタイプを使用したり、「システムノート」を検索したりする場合があります。
検索を実行してエクスポート：各保存検索を個別に実行します。結果ページで「エクスポート - CSV」アイコンをクリックしてデータをダウンロードします。各ファイルには、invoice_generated.csv、payment_received.csvなど、内容が分かる名前を付けます。
「支払期日経過」イベントを生成：このイベントは直接エクスポートできません。データのエクスポート後に計算する必要があります。Python、Power Query、ETLツールなど任意のデータ加工ツールで、全額支払済みでない各請求書について、ActivityNameを「支払期日経過」、EventTimeをDueDateの1日後として行を作成します。
エクスポートしたファイルを結合：外部ツールを使って、エクスポートしたすべてのCSVファイルを1つのマスターファイルにまとめます。結合前に、すべてのファイルで列見出しが一致していることを確認します。
最終的なデータ形式を確認：結合したCSVファイルを確認します。EventTimeが一貫したタイムスタンプ形式（例：YYYY-MM-DD HH:MI:SS）になっていること、すべての行に必須列（InvoiceNumber、ActivityName、EventTime）があることを確認します。
ProcessMindにアップロード：結合済みの最終CSVファイルをイベントログとしてアップロードできます。

設定

前提条件：Saved Searchesを作成、編集、エクスポートできる権限を持つユーザーロールが必要です。次のレコード種別へのアクセスも必要です：取引（請求書、支払い、クレジットメモ用）、Phone Call（またはその他のCRMアクティビティレコード）、System Notes。
レコード種別：これらの検索で主に使用するレコード種別は取引とPhone Callです。System Noteレコードは、直接の取引レコードがない場合に、ステータス変更やコミュニケーションイベントを取得するためにも使用します。
日付範囲のフィルタリング：パフォーマンスを確保し、データ量を管理するため、すべての保存検索に日付フィルター（例：Date CreatedまたはLast Modified Date）を一貫して適用します。初期分析では、3～6か月分のデータを推奨します。
Main Lineフィルター：取引レコードを検索する際は、Main Line is true条件を使用してヘッダーレベルの情報に絞り込みます。これにより、請求書や支払いの明細行ごとにイベントが重複することを防げます。
数式の使用：NetSuiteの数式は、標準化されたActivityName列を作成するために欠かせません。Formula (Text)フィールドで各検索のアクティビティ名を固定値として設定し、必要に応じてFormula (Date/Time)でタイムスタンプフィールドを標準化できます。
エクスポート上限：NetSuiteのUIベースのCSVエクスポートは、通常、検索1件あたり100,000行に制限されます。データセットが大きい場合は、日付範囲を小さく分けて検索を実行するか、結果をFile Cabinetに配信するスケジュール済み検索を使用する必要があります。

a サンプルクエリ sql

/*
This configuration outlines the setup for multiple NetSuite Saved Searches. 
Each search is designed to extract a specific activity for the event log.
Create one Saved Search in the NetSuite UI for each block defined below.
*/

// Saved Search 1: Invoice Generated
{
  "SavedSearchName": "ProcessMind - Invoice Generated",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Generated'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 2: Invoice Sent to Customer
{
  "SavedSearchName": "ProcessMind - Invoice Sent",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "E-mailed"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Sent to Customer'"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Note: 'Payment Due Date Passed' is a calculated event, generated post-export.

// Saved Search 3: Overdue Reminder Sent & Dunning Procedure Initiated
{
  "SavedSearchName": "ProcessMind - Dunning Events",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "[Your Dunning Status Field]"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} = '[Your First Dunning Level]' THEN 'Dunning Procedure Initiated' ELSE 'Overdue Reminder Sent' END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 4: Collection Call Made
{
  "SavedSearchName": "ProcessMind - Collection Calls",
  "RecordType": "Phone Call",
  "Criteria": [
    {"Field": "Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Collection Call Made'"},
    {"Column": "EventTime", "Field": "Completed Date"},
    {"Column": "InvoiceNumber", "Field": "Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Company : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Company : Category"},
    {"Column": "InvoiceAmount", "Field": "Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Transaction : Status"}
  ]
}

// Saved Search 5: Dispute Registered & Resolved
{
  "SavedSearchName": "ProcessMind - Dispute Status",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "Status"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} LIKE '%Disputed%' THEN 'Dispute Registered' WHEN {systemnotes.oldvalue} LIKE '%Disputed%' THEN 'Dispute Resolved' ELSE NULL END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 6: Credit Memo Issued
{
  "SavedSearchName": "ProcessMind - Credit Memos",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Credit Memo"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Applied To Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Credit Memo Issued'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 7: Payment Received & Posted
{
  "SavedSearchName": "ProcessMind - Payments",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Customer Payment"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    // For 'Payment Received'
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Received'"},
    {"Column": "EventTime", "Field": "Date Created"},
    // For 'Payment Posted'
    // {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Posted'"},
    // {"Column": "EventTime", "Field": "[Your GL Posting Date Field]"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 8: Invoice Settled
{
  "SavedSearchName": "ProcessMind - Invoice Settled",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Status", "Operator": "anyof", "Value": "Paid In Full"},
    {"Field": "Date Closed", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Settled'"},
    {"Column": "EventTime", "Field": "Date Closed"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 9: Invoice Written Off
{
  "SavedSearchName": "ProcessMind - Invoice Written Off",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Journal Entry"},
    {"Field": "Main Line", "Operator": "is", "Value": "false"},
    {"Field": "Account", "Operator": "is", "Value": "[Your Bad Debt Expense Account]"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Written Off'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Created From : Document Number"},
    {"Column": "CustomerId", "Field": "Created From : Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Created From : Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Created From : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Created From : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Created From : Status"}
  ]
}

ステップ

前提条件：システムにPython 3.6以降がインストールされていることを確認します。また、NetSuite SuiteTalkの認証情報、具体的にはトークンベース認証（TBA）に必要なアカウントID、コンシューマーキー、コンシューマーシークレット、トークンID、トークンシークレットが必要です。関連付けられたNetSuiteロールには、取引（請求書、支払い、クレジットメモ）、CRMアクティビティ（電話）、顧客レコードなど、必要なすべてのレコードへのアクセス権が必要です。
Pythonライブラリをインストール：コマンドラインまたはターミナルを開き、必要なPythonライブラリをインストールします。主なライブラリは、データ加工用のpandas、API呼び出し用のrequestsとrequests_oauthlib、または専用のNetSuiteライブラリです。 pip install pandas requests requests_oauthlib
認証を設定：提供されたPythonスクリプトで、認証情報のセクションを探します。指定されたプレースホルダー変数に、NetSuiteのアカウントID、コンシューマーキー、コンシューマーシークレット、トークンID、トークンシークレットを安全に入力します。これらの認証情報を直接ハードコードするのではなく、環境変数または安全な保管庫で管理することを強く推奨します。
抽出パラメーターを設定：スクリプト内でstart_dateとend_date変数を定義し、データ抽出の期間を指定します。特定のNetSuite子会社に限定する必要がある場合は、subsidiary_idフィルターも調整できます。
スクリプトのロジックを理解：スクリプトは、必要な13種類のアクティビティをそれぞれ個別に検索する構成です。各検索は、NetSuite REST APIエンドポイントに送信する独立したSuiteQL文です。スクリプトはAPIのページネーションを自動処理し、各検索の全レコードを取得します。
Pythonスクリプトを実行：ターミナルで次のコマンドを実行します：python your_netsuite_extraction_script.py。スクリプトはNetSuiteに接続し、一連のクエリを実行して、各アクティビティのデータを取得する進捗状況をコンソールに表示します。
データを結合して変換：各アクティビティの生のデータを取得した後、スクリプトはpandasライブラリを使って個別の結果を1つの統合DataFrameに連結します。このDataFrameがイベントログになります。
イベントログを確認して保存：スクリプトは最終的なDataFrameをnetsuite_collections_event_log.csvというCSVファイルに保存します。このファイルを開き、データの完全性と正確性を確認します。
アップロードの準備：最終CSVファイルに、必須列InvoiceNumber、ActivityName、EventTimeと、推奨される属性が含まれていることを確認します。これでProcessMindにアップロードできます。

設定

認証：スクリプトはNetSuiteのトークンベース認証（TBA）を使用します。アカウントID、コンシューマーキー、コンシューマーシークレット、トークンID、トークンシークレットを指定する必要があります。トークンに関連付けられたロールには、取引、顧客、電話、メッセージレコードへの読み取りアクセス権が必要です。
日付範囲：スクリプトのstart_dateとend_date変数で抽出期間を指定します。初回分析には、データ量とパフォーマンスのバランスを取りやすい3～6か月分を推奨します。
子会社フィルター：特定の事業単位にデータを絞り込むため、subsidiary_id変数が用意されています。単一子会社の環境では省略できます。
APIエンドポイント：スクリプトはNetSuite SuiteQL REST APIエンドポイントを対象とします。アカウントで/services/rest/query/v1/suiteqlが有効になっていることを確認してください。
ページネーション処理：スクリプトには、ページ分割されたAPIレスポンスを自動処理する関数が含まれています。必要なAPI呼び出し回数を減らすため、page_sizeはAPIで許可される最大値の1000に設定されています。
カスタムフィールド：「紛争登録」と「紛争解決」の抽出では、カスタムフィールド（custbody_dispute_date、custbody_dispute_resolved_date）を使用する前提です。NetSuite環境で実際に使用しているフィールドIDに合わせて、スクリプトを更新してください。

a サンプルクエリ python

import pandas as pd
import requests
from requests_oauthlib import OAuth1
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Best practice: Use environment variables instead of hardcoding credentials.
NS_ACCOUNT = os.getenv(class="hl-string">'NS_ACCOUNT', class="hl-string">'[Your NetSuite Account ID]')
NS_CONSUMER_KEY = os.getenv(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'[Your Consumer Key]')
NS_CONSUMER_SECRET = os.getenv(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'[Your Consumer Secret]')
NS_TOKEN_ID = os.getenv(class="hl-string">'NS_TOKEN_ID', class="hl-string">'[Your Token ID]')
NS_TOKEN_SECRET = os.getenv(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'[Your Token Secret]')

class=class="hl-string">"hl-comment"># The base URL for the SuiteQL API endpoint
BASE_URL = fclass="hl-string">"https://{NS_ACCOUNT.replace('_', '-')}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'
SUBSIDIARY_ID = class="hl-string">'[Your Subsidiary ID]' class=class="hl-string">"hl-comment"># Optional: filter by subsidiary

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query and handles pagination."""
    all_results = []
    offset = 0
    limit = 1000

    oauth = OAuth1(
        client_key=NS_CONSUMER_KEY,
        client_secret=NS_CONSUMER_SECRET,
        resource_owner_key=NS_TOKEN_ID,
        resource_owner_secret=NS_TOKEN_SECRET,
        realm=NS_ACCOUNT,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(BASE_URL, headers=headers, data=payload, auth=oauth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()
            
            if not data.get(class="hl-string">'items'):
                break

            all_results.extend(data[class="hl-string">'items'])
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            print(fclass="hl-string">"Response body: {response.text if 'response' in locals() else 'No response'}")
            return None

    return all_results

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    all_events = []
    
    class=class="hl-string">"hl-comment"># Common WHERE clause for filtering by date and subsidiary
    common_filter = fclass="hl-string">"WHERE T.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD') AND T.subsidiary = {SUBSIDIARY_ID}"

    class=class="hl-string">"hl-comment"># --- Define SuiteQL Queries for Each Activity ---
    queries = {
        class="hl-string">'Invoice Generated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Generated' AS ActivityName,
                TO_CHAR(T.createdDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.createdDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Sent to Customer': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Sent to Customer' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND M.emailed = 'T' AND M.messageDate IS NOT NULL
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Payment Due Date Passed': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Payment Due Date Passed' AS ActivityName,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD"T"23:59:59"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status NOT IN ('CustInvc:B', 'CustInvc:A') -- Not Paid In Full or Pending Approval
                AND T.dueDate < CURRENT_DATE
                AND T.dueDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Overdue Reminder Sent': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Overdue Reminder Sent' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND (M.subject LIKE '%Overdue%' OR M.subject LIKE '%Reminder%')
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dunning Procedure Initiated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dunning Procedure Initiated' AS ActivityName,
                TO_CHAR(SL.systemNoteDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
                INNER JOIN SystemNote AS SL ON T.id = SL.recordId
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND SL.field = 'custbody_dunning_level' AND SL.oldValue IS NULL -- Assumes a custom dunning level field
                AND SL.systemNoteDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Collection Call Made': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Collection Call Made' AS ActivityName,
                TO_CHAR(PC.completedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                PhoneCall AS PC
                INNER JOIN Transaction AS T ON PC.transaction = T.id
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND PC.title LIKE '%Collection%'
                AND PC.completedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dispute Registered': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Registered' AS ActivityName,
                TO_CHAR(T.custbody_dispute_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_date IS NOT NULL -- Assumes a custom dispute date field
                AND T.custbody_dispute_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Dispute Resolved': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Resolved' AS ActivityName,
                TO_CHAR(T.custbody_dispute_resolved_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_resolved_date IS NOT NULL -- Assumes a custom dispute resolved date field
                AND T.custbody_dispute_resolved_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Credit Memo Issued': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Credit Memo Issued' AS ActivityName,
                TO_CHAR(CM.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                CM.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS CM
                INNER JOIN TransactionLine AS CML ON CM.id = CML.transaction
                INNER JOIN Transaction AS AppliedTo ON CML.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON CM.entity = C.id
            WHERE
                CM.type = 'CustCred' AND CM.voided = 'F' AND CM.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND CM.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Received': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Received' AS ActivityName,
                TO_CHAR(P.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND P.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Posted': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Posted' AS ActivityName,
                TO_CHAR(P.postingdate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc' AND P.posting = 'T'
                AND P.postingdate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Invoice Settled': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Settled' AS ActivityName,
                TO_CHAR(T.lastModifiedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status = 'CustInvc:B' -- Paid In Full
                AND T.lastModifiedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Written Off': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Invoice Written Off' AS ActivityName,
                TO_CHAR(JE.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                JE.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS JE
                INNER JOIN TransactionLine AS JEL ON JE.id = JEL.transaction
                INNER JOIN Transaction AS AppliedTo ON JEL.entity = AppliedTo.entity -- A best-effort link via customer
                INNER JOIN Customer AS C ON JE.entity = C.id
            WHERE
                JE.type = 'Journal' AND JE.voided = 'F' AND JE.subsidiary = {SUBSIDIARY_ID}
                AND JEL.account = [Your Bad Debt Expense Account ID] -- Must configure your specific bad debt account
                AND AppliedTo.type = 'CustInvc'
                AND JE.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
                AND (JEL.memo LIKE '%' || AppliedTo.tranid || '%' OR JE.memo LIKE '%' || AppliedTo.tranid || '%') -- Best-effort link by checking memo field for invoice number
        """
    }

    for activity, query in queries.items():
        print(fclass="hl-string">"Fetching data for: {activity}...")
        results = execute_suiteql(query)
        if results:
            all_events.extend(results)
            print(fclass="hl-string">"  ...found {len(results)} events.")
        else:
            print(fclass="hl-string">"  ...no events found or an error occurred.")

    if not all_events:
        print(class="hl-string">"No data extracted. Exiting.")
        return

    class=class="hl-string">"hl-comment"># Convert to pandas DataFrame
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Data Cleaning and Formatting
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
    df.rename(columns=lambda c: class="hl-string">''.join(c.split()).capitalize(), inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'netsuite_collections_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"\nEvent log successfully saved to {output_file}")

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

準備はできましたか？

このテンプレートを使ってデータ準備を効率化し、信用管理・回収プロセスを詳しく把握してください。キャッシュフロー改善に向けた取り組みを、今日から始められます。

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

今日から信用管理・回収の最適化を開始

非効率性を発見し、サイクルタイムを30％短縮して、キャッシュフローを迅速に改善します。

無料トライアルを開始

クレジットカードは不要で、数分で設定できます。

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

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

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

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

抽出ガイド

NetSuiteの保存検索とレポートからのデータエクスポート

ステップ

設定

a サンプルクエリ sql

NetSuite SuiteTalk Web ServicesによるPython抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

今日から信用管理・回収の最適化を開始

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

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

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

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

抽出ガイド

NetSuiteの保存検索とレポートからのデータエクスポート

ステップ

設定

a サンプルクエリ sql

NetSuite SuiteTalk Web ServicesによるPython抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

今日から信用管理・回収の最適化を開始

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