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

与信管理と回収のデータテンプレート

NetSuite

与信管理と回収の属性(21) 与信管理と回収のアクティビティ(13) データ抽出ガイド(2)

与信管理と回収のデータテンプレート

このテンプレートでは、与信管理と回収のプロセス分析に必要なデータを収集する方法をご案内します。必須の属性とアクティビティに加え、データの抽出方法も説明しているため、すぐに準備を始められます。推奨事項に沿ってデータを整えることで、プロセスの分析と改善に役立てられます。

収集を推奨する属性
追跡する主なアクティビティ
NetSuiteからのデータ抽出ガイド

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

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

与信管理と回収の属性

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

3 必須 5 推奨 13 任意

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

必須推奨任意

与信管理と回収のアクティビティ

回収ワークフローを正確に把握し、改善するためにイベントログに記録する、重要なプロセスのステップと節目です。

5 推奨 8 任意

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

推奨任意

データ抽出ガイド

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

ステップ

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

設定

前提条件：保存検索の作成、編集、エクスポートの権限を持つユーザーロールが必要です。次のレコードタイプへのアクセス権も必要です：取引（請求書、支払い、クレジットメモ用）、Phone Call（またはその他のCRMアクティビティレコード）、System Notes。
レコードタイプ：検索で主に使用するレコードタイプはTransactionと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の画面からCSVにエクスポートする場合、通常、検索ごとに最大100,000行までです。データ量が多い場合は、日付を細かく区切って検索を実行するか、結果をFile Cabinetに送るスケジュール検索を使用してください。

クエリの例 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の認証情報が必要です。具体的には、アカウントID、コンシューマーキー、コンシューマーシークレット、トークンID、トークンシークレットを含むトークンベース認証（TBA）の情報を用意します。関連付けられた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種類のアクティビティを個別に検索する構成です。各検索は独立したSuiteQL文としてNetSuite REST APIエンドポイントに送信されます。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変数を用意しています。子会社が1つの環境では、この変数を省略できます。
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に合わせて、スクリプトを更新してください。

クエリの例 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の保存検索とレポートからデータをエクスポート

ステップ

設定

クエリの例 sql

NetSuite SuiteTalk Web Servicesを使ったPythonでのデータ抽出

ステップ

設定

クエリの例 python

始める準備はできましたか？

今すぐ与信管理と回収の改善を始めましょう。