> 継続的なプロセス改善 > 買掛金支払い処理 > NetSuite > データテンプレート

買掛金支払処理用データテンプレート

NetSuite

← 改善ガイドに戻る

買掛金支払い処理の属性 (21) 買掛金支払い処理のアクティビティ (14) 抽出ガイド (3)

買掛金支払処理用データテンプレート

このテンプレートは、NetSuiteの買掛金ワークフローをマッピングするためのフレームワークです。分析の正確性と改善へのつなげやすさを高めるため、必要なデータ属性、主要なプロセスアクティビティ、専用の抽出手順を詳しくまとめています。

詳細な分析に推奨される属性
追跡すべき主要なプロセス上の節目
NetSuite固有の抽出手順

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

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

買掛金支払い処理の属性

NetSuite環境で買掛金支払い処理を詳細に分析するため、イベントログに含める推奨データ項目です。

5 必須 10 推奨 6 任意

	名前	説明
	アクティビティ Activity	実行されたプロセスステップまたはイベントの名称です。
説明この属性は、特定の時点で発生したアクションまたは状態変更を記録します。例として、「Invoice Created」、「Approval Status Changed」、「Payment Processed」などがあります。このデータは、プロセスフローマップを再構成するために欠かせません。請求書番号ごとにアクティビティを時系列に並べることで、プロセスマイニングツールは実際のワークフローを可視化し、ループ、手戻り、想定経路からの逸脱を特定します。重要な理由プロセスマップのステップを定義する項目であり、プロセスマイニング分析には必須です。入手先 System NotesまたはWorkflow Historyのログ例請求書作成請求書を承認支払いをスケジュール支払いを決済
	イベント時刻 EventTime	アクティビティが発生した時点のタイムスタンプです。
説明アクティビティが発生した正確な日時です。イベントを順番に並べ、ステップ間の所要時間を計算するために使用します。正確なタイムスタンプは、ボトルネックを特定するうえで重要です。承認にかかった時間や、請求書がブロック状態にとどまった期間など、サイクルタイムを計算できます。重要な理由イベントの順序付けと、時間に基づくすべてのKPIの計算に必須です。入手先 System Notesの「date」フィールド例 2023-10-01T14:30:00Z2023-10-02T09:15:00Z
	ソースシステム SourceSystem	データの取得元となったシステムの名称です。
説明イベントデータを抽出したソフトウェアアプリケーションを識別します。この場合、通常は「NetSuite」のような固定値です。この属性は、複数のシステムを利用する環境でデータの系譜を追跡する際に役立ちます。このビューではNetSuiteを対象としていますが、この項目を保持することで、全社的なデータモデルとの互換性を確保できます。重要な理由データの系譜を追跡し、複数システム環境でデータを区別するために必須です。入手先抽出時にハードコード例 NetSuiteNetSuite OneWorld
	最終データ更新 LastDataUpdate	データを抽出または更新した時点のタイムスタンプです。
説明ソースシステムからプロセスマイニングプラットフォームへ、データが最後に取り込まれた時点を示します。分析対象データの最新性を把握するのに役立ちます。ダッシュボードに表示されるデータがリアルタイムの状態なのか、過去の期間のスナップショットなのかを判断するために使用します。「期限超過日数」の計算結果を信頼するうえでも重要です。重要な理由データの最新性と同期状態を把握するために必須です。入手先 ETLタイムスタンプ例 2023-11-01T00:00:00Z
	請求書番号 InvoiceNumber	仕入先請求書を一意に識別する番号です。
説明この属性は、NetSuite内で仕入先請求書に割り当てられた一意の参照番号を表します。買掛金プロセスにおける確定的なケース識別子として、特定の支払義務に関連するすべてのアクティビティをまとめます。分析では、この項目がプロセスインスタンスの主キーとして機能します。請求書の受領・記録から最終支払の消込完了まで、債務のライフサイクル全体を追跡できます。この識別子に基づいてバリアントを集約し、一般的なプロセス経路を特定します。重要な理由すべてのイベントを結び付けて1つのプロセスケースを形成する、必須のケースIDです。入手先 Transactionテーブルの、typeが「Vendor Bill」である「tranid」フィールド例 INV-2023-001VB-99822ACME-10299982311
	ユーザー User	アクティビティを実行した従業員です。
説明請求書の承認や支払ブロックの解除など、特定のイベントを担当した個人を識別します。「承認ワークフローのボトルネック監視」で、担当者ごとの遅延を特定するために使用します。管理者は、作業負荷の調整や特定のチームメンバーに必要なトレーニングの把握に役立てられます。重要な理由リソース分析と、ユーザーレベルのボトルネック特定に必要です。入手先 System Notesの「name」またはTransactionの「employee」例 John Doe財務管理者システム
	仕入先名 VendorName	請求書を発行した仕入先の名称です。
説明この属性には、仕入先請求書に関連付けられた組織の名称が含まれます。サプライチェーン全体のパフォーマンスを分析するうえで重要です。分析では、「仕入先支払サイクルのばらつき」ダッシュボードで使用します。ケースを仕入先ごとにグループ化し、照合差異を繰り返し引き起こす仕入先や、標準と異なる支払条件を設定している仕入先を特定できます。重要な理由仕入先別に分析をグループ化し、仕入先固有のボトルネックを見つけるために欠かせません。入手先 Transactionの「entity」フィールドをVendorレコードに結合例 Office DepotOracleFedEx
	子会社 Subsidiary	請求書を受け取る会社の子会社または法人です。
説明 NetSuite OneWorld環境では、請求書が属する特定の法人（Subsidiary）を識別します。組織間の比較が可能になります。この属性は「エンドツーエンド支払サイクルタイム」ダッシュボードに反映され、異なる事業部門の効率を比較できます。特定の地域や法人のパフォーマンスが低いかどうかを切り分けるのにも役立ちます。重要な理由複数の法人を持つ組織で、事業部門間のパフォーマンスを比較するために重要です。入手先 Transactionの「subsidiary」フィールド例米国東部EMEA本社APAC営業
	承認ステータス ApprovalStatus	請求書の現在のワークフロー承認状態です。
説明請求書が承認待ち、承認済み、却下のいずれであるかを示します。この状態がワークフローの遷移ロジックを決定します。「承認ワークフローのコンプライアンス監査」の中心となる項目です。このステータスが変更されるとアクティビティイベントが生成され、最終状態によって請求書が支払可能かどうかが決まります。重要な理由承認ゲートを通過する請求書の進捗を追跡します。入手先 Transactionの「approvalstatus」フィールド例承認待ち承認済み却下
	支払日 PaymentDate	支払が実行された日付です。
説明請求書に関連付けられたVendor Payment取引に記録された日付です。買掛金サイクルの完了を表します。「エンドツーエンド支払サイクルタイム」の計算に使用します。この日付と「InvoiceDate」を比較することで、プロセス全体の所要時間を算出できます。重要な理由主要プロセスサイクルの終了タイムスタンプです。入手先関連付けられたVendor Payment取引の日付例 2023-11-202023-12-05
	支払期日 DueDate	仕入先への支払いを完了しなければならない日付です。
説明請求書の条件に基づく、契約上の支払期限を示します。期日どおりの支払いを計算する際の基準になります。「期日どおりの支払率」KPIの中核となる項目です。「Payment Executed」の日付と比較することで、支払遅延を検出し、発生する可能性のあるペナルティを見積もれます。重要な理由期日どおりの支払率を計算し、支払遅延のある債務を特定するための基本項目です。入手先 Transactionの「duedate」フィールド例 2023-11-152023-12-01
	請求書金額 InvoiceAmount	請求書の合計金額です。
説明仕入先請求書の合計金額で、通常は基準通貨または取引通貨で表示されます。財務への影響を分析するための指標です。「支払遅延とペナルティの追跡」ダッシュボードで、支払遅延によるキャッシュフローリスクを定量化するために使用します。また、高額な請求書を特定し、手動対応の優先順位を付ける際にも使用します。重要な理由プロセスの非効率が財務に与える影響を定量化するために必要です。入手先 Transactionの「usertotal」または「foreignamount」フィールド例 1500.00250.5010000.00
	購買発注番号 PurchaseOrderNumber	関連する購買発注の参照番号です。
説明仕入先請求書を元の購買発注（PO）に関連付けます。この項目が空の場合、請求書は非PO請求書とみなされます。この属性は「非PO請求書の処理速度」ダッシュボードに不可欠です。プロセスのバリアントをPOに基づく請求書と非PO（FI）請求書に分け、効率とコンプライアンスを比較できます。重要な理由 POベースと非POベースの請求書処理を区別するために必要です。入手先 Transactionの「createdfrom」フィールド例 PO-8821PO-1002null
	部門 Department	請求書に関連付けられた社内部門です。
説明費用が発生したコストセンターまたは社内部門（IT、マーケティングなど）ごとに請求書を分類します。この属性により、サイクルタイムを部門別に分析できます。特定の部門で請求書のコード付与や承認に時間がかかっているかを特定し、対象を絞ったプロセス改善につなげられます。重要な理由組織内のプロセス効率を分析できます。入手先 Transactionの「department」フィールド例 ITマーケティング製造
	非POフラグ IsNonPO	請求書が購買発注に関連付けられていないことを示すフラグです。
説明関連する購買発注がないことから導出されるブール型の属性です。プロセスをPOに基づく請求書と、直接FIで処理する請求書に分けます。「非PO請求書の処理速度」ダッシュボードで、3点照合プロセスと比較した手動請求書処理の非効率を明らかにするために使用します。重要な理由プロセスバリアントを分析するための大分類です。入手先「PurchaseOrderNumber」がnullであることから導出例 truefalse
	利用可能な割引 DiscountAvailable	早期支払によって利用できる割引額です。
説明請求書金額と支払条件に基づいて計算された早期支払割引の金額です。得られる可能性のある節約額を表します。この属性は「早期支払割引の取得率」ダッシュボードの中心となります。支払遅延が発生した請求書についてこの値を合計することで、失われた節約額の合計を算出できます。重要な理由プロセスを迅速化することで得られる財務上の機会を定量化します。入手先 TermsとInvoiceAmountから計算例 30.000.0015.50
	支払保留 PaymentHold	請求書が現在、支払対象からブロックされているかどうかを示します。
説明請求書に支払保留が設定され、支払処理に含まれない状態であることを示すフラグまたはステータスです。この属性は「支払ブロックの影響分析」ダッシュボードで使用します。この項目が「true」に設定されている期間を分析することで、紛争や情報不足による処理遅延を明らかにできます。重要な理由請求書が滞留または遅延している理由を分析するために重要です。入手先 Transactionの「paymenthold」フィールド例 truefalse
	支払条件 PaymentTerms	支払時期と割引を定めた合意済みの条件です。
説明「Net 30」や「2% 10 Net 30」などの支払条件を指定します。この情報により、「支払期日」や早期支払割引の可能性を説明できます。この属性は「早期支払割引の取得率」ダッシュボードで使用します。割引の対象となる請求書を特定し、失われた割引と特定の制約的な条件との関係を分析できます。重要な理由支払期日の背景を補足し、割引の機会を特定します。入手先 Transactionの「terms」フィールド例 30日払い10日以内2％割引、30日払い受領時払い
	期限超過日数 DaysOverdue	支払が支払期日を過ぎて実行された日数です。
説明支払期日に対する支払遅延を測定する計算指標です。負の値は期日前の支払いを示します。この属性は「支払遅延とペナルティの追跡」ダッシュボードに反映されます。支払遅延の深刻度を定量化し、慢性的な支払遅延のパターンを特定するために欠かせません。重要な理由支払コンプライアンスとペナルティリスクを分析するための主要指標です。入手先計算式：PaymentDate - DueDate 例 50-2
	請求書日付 InvoiceDate	仕入先の請求書に記載された日付です。
説明仕入先が提示した書類の日付です。通常、経過期間の計算開始点になります。「エンドツーエンド処理サイクルタイム」の計算に使用します。この日付とNetSuiteでの作成日との差から、スキャンやメール室での遅延を把握できます。重要な理由仕入先側のタイムラインにおける正式な開始点を示します。入手先 Transactionの「trandate」フィールド例 2023-10-012023-10-05
	通貨 Currency	請求書が発行された通貨です。
説明取引通貨を表すISOコードです。多国籍組織にとって重要な項目です。「請求書金額」の分析で財務数値を標準化するために使用します。また、為替処理によって「Payment Cleared」アクティビティに時間がかかっているかどうかを特定するのにも役立ちます。重要な理由財務数値を正しく集計し、為替を分析するために必要です。入手先 Transactionの「currency」フィールド例 USDEURGBP

必須推奨任意

買掛金支払い処理のアクティビティ

支払い処理のライフサイクルを正確に発見するため、イベントログに記録すべき主要なプロセス手順と節目です。

5 推奨 9 任意

	アクティビティ	説明
	支払いを処理	Bill Paymentレコードが正常に計上され、請求書が全額支払い済みまたは一部支払い済みになります。総勘定元帳上の債務が消し込まれます。
重要な理由支払いプロセスの主要な完了時点です。「最初から最後までの処理サイクルタイム」の計算に使います。入手先取引テーブル。「Bill Payment」レコードの作成、またはステータスが「Deposited」（小切手の場合）もしくは「Paid」に変わった記録を特定します。取得 Bill Paymentの取引が実行された時点で記録イベントタイプ explicit
	支払いを決済	銀行照合プロセスでBill Paymentが決済済みになります。資金が銀行口座から出金されたことを確認します。
重要な理由会計上の支払日とは異なる、キャッシュフロー分析における実際の資金移動の終了日を示します。入手先 Transaction Line。Bill Paymentの取引明細で「cleared」フラグがTrueに設定された記録です。取得取引Xが実行された時点で記録イベントタイプ explicit
	請求書を承認	仕入先請求書のステータスがOpenに変わり、支払いが承認され、総勘定元帳に反映されたことを示します。支払い前の重要な節目です。
重要な理由承認サイクルを終了し、請求書を支払いスケジュールに組み込める状態にします。承認効率の測定に欠かせません。入手先 System Notes。「approvalstatus」フィールドが「2」（Approved）に変わった記録、またはステータスが「Open」になった記録を確認します。取得前後のstatusフィールドを比較イベントタイプ inferred
	請求書を発注書と照合	仕入先請求書が既存の発注書から作成された、または発注書に紐付いていることを示します。発注書あり請求書と発注書なし請求書を区別できます。
重要な理由調達ポリシーの遵守状況を分析し、発注書あり請求書と発注書なし請求書のサイクルタイムを比較するうえで重要です。入手先取引テーブル。仕入先請求書レコードの「createdfrom」フィールドを確認します。発注書IDが入力されていれば、このアクティビティが発生しています。取得前後のstatusフィールドを比較イベントタイプ inferred
	請求書作成	NetSuiteで仕入先請求書レコードが最初に作成された時点です。プロセスの開始点となり、請求書がERPに入力されたことを示します。
重要な理由買掛金サイクル全体と経過期間の計算における基準タイムスタンプを設定します。入手先取引テーブル。レコードタイプが仕入先請求書であるものを絞り込みます。datecreatedまたはtrandateフィールドを取得します。取得仕入先請求書の取引が実行された時点で記録イベントタイプ explicit
	仕入先クレジットを適用	Bill Credit（仕入先クレジット）が仕入先請求書に適用され、支払額が減少します。現金による支払いに代わる方法です。
重要な理由支払額が請求書金額と異なる理由を説明し、債務を正しく消し込みます。入手先 Transaction Links。タイプが「Vendor Credit」の取引が仕入先請求書に紐付いた時点を特定します。取得前後のstatusフィールドを比較イベントタイプ inferred
	支払いをスケジュール	Bill Paymentレコードが「Pending Approval」状態で作成されます。通常は、電子銀行支払い（EFT）バッチの作成時に発生します。
重要な理由支払いの意思決定と実際の資金移動を区別し、支払い承認の遅延を明らかにします。入手先取引テーブル。Billに紐付いた「Bill Payment」レコードが作成され、ステータスが「Pending Approval」になった記録です。取得前後のstatusフィールドを比較イベントタイプ inferred
	支払いを無効化	処理済みのBill Paymentが無効化され、仕入先請求書が再び未決済になります。重大な例外およびプロセス上の失敗を示します。
重要な理由監査上のコンプライアンスを確保し、支払い失敗の理由（小切手印刷エラーや銀行による拒否など）を特定するうえで重要です。入手先 Bill PaymentのSystem Notes。ステータスが「Voided」に変わった記録を確認します。取得取引Xが実行された時点で記録イベントタイプ explicit
	支払い保留を解除	Payment HoldチェックボックスがFalseに設定され、請求書が支払い処理に進める状態になります。ブロック期間の終了を示します。
重要な理由「支払いブロック期間」KPIの計算に使い、異議のある請求書の解決時間を把握します。入手先 System Notes。「paymenthold」フィールドが「T」から「F」に変わった記録を確認します。取得取引Xが実行された時点で記録イベントタイプ explicit
	支払い保留を設定	仕入先請求書のPayment HoldチェックボックスがTrueに設定されます。請求書が支払い処理の対象として選択されなくなります。
重要な理由異議やキャッシュフロー管理上の判断によって請求書が滞留するボトルネックを特定します。入手先 System Notes。「paymenthold」フィールドが「F」から「T」に変わった記録を確認します。取得取引Xが実行された時点で記録イベントタイプ explicit
	請求書の勘定科目を変更	請求書明細の総勘定元帳の費用勘定科目が変更されます。コーディングミスの修正または再分類を示します。
重要な理由「請求書コーディング手戻り率」KPIを直接測定し、会計コーディング工程における効率低下を明らかにします。入手先 System Notes。Transaction Lineサブリストの「account」フィールドの変更を確認します。取得取引Xが実行された時点で記録イベントタイプ explicit
	請求書の承認を申請	仕入先請求書のステータスがPending Approvalに変わります。請求書が承認のためのワークフロー経路に入ったことを示します。
重要な理由承認サイクルタイムの開始点となり、承認経路におけるボトルネックを特定できます。入手先 System Notes。「approvalstatus」フィールドが「1」（Pending Approval）に変わった記録を確認します。取得前後のstatusフィールドを比較イベントタイプ inferred
	請求書を却下	仕入先請求書が修正または否認のため申請者に戻されます。承認ワークフローにおけるループまたは終了を示します。
重要な理由却下率が高い場合、プロセス上の摩擦、トレーニングの問題、または前工程のデータ品質問題が考えられます。入手先 System Notes。「approvalstatus」フィールドが「3」（Rejected）に変わった記録を確認します。取得前後のstatusフィールドを比較イベントタイプ inferred
	請求書金額を変更	仕入先請求書の合計金額が、初回作成後に変更されます。手戻り、入力ミス、または不一致の解消を示します。
重要な理由手作業の介入と手戻りを示し、自動処理率に悪影響を与えます。入手先 System Notes。仕入先請求書レコードの「total」または「usertotal」フィールドの変更を確認します。取得取引Xが実行された時点で記録イベントタイプ explicit

推奨任意

抽出ガイド

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

ステップ

管理者、または保存検索の作成とエクスポート権限を持つユーザーとしてNetSuiteにログインします。
Lists > Search > Saved Searches > Newに移動します。
レコードタイプの一覧からTransactionを選択し、新しいTransaction Saved Searchを作成します。
Criteriaタブで、最初はUse Expressionsのチェックが外れていることを確認します。その後、Filter：Typeを追加し、Vendor Bill、Bill Payment、Bill Creditのいずれかを選択します。
引き続きCriteriaタブでFilter：Main Lineを追加し、Trueに設定します。これにより、作成イベントとステータスイベントをヘッダーレベルに限定できます。
履歴を取得するには、フィルター一覧の下部にあるSystem Notesの結合先に移動し、System Notes：Dateを追加します。希望する期間（例：過去90日以内）を設定します。
Resultsタブに切り替え、既定の列をすべて削除します。
ケース識別子の列を追加します。Transaction NameまたはDocument Numberを選択し、Custom LabelにInvoiceNumberを指定します。
イベント時刻の列を追加します。System Notes fields... > Dateを選択し、Custom LabelにEventTimeを指定します。
アクティビティの列を追加します。Formula（Text）を選択し、下記のQueryセクションに記載されたCASE文を数式ウィンドウに貼り付けます。このロジックにより、NetSuiteのフィールド変更が標準のアクティビティ名にマッピングされます。Custom LabelにActivityを指定します。
その他の必須属性（Source System、Last Data Update）を、Formula（Text）と固定値（例：'NetSuite'）、組み込みの{today}タグを使って追加します。
Save & Runをクリックします。結果が読み込まれたら、結果ツールバーの左上にあるExport - CSVアイコンをクリックし、ProcessMind用のイベントログをダウンロードします。

設定

取引タイプ：ノイズを避けるため、Vendor Bill、Bill Payment、Bill Creditのみに厳密に絞り込みます。Journal EntriesやPurchase Ordersは除外してください。
System Notesの結合：この設定では、現在の状態ではなく履歴ログを生成するため、System Notesの結合を使用します。ユーザーロールにSystem Notesの閲覧権限があることを確認してください。
日付範囲：日付フィルターは取引のDateフィールドではなく、System NotesのDateフィールドに適用します。これにより、過去に作成された請求書に対する最近のアクティビティ（昨年作成された請求書を本日支払った場合など）を取得できます。
Main Line：行数を減らすため、Main Line = Trueを推奨します。ただし、「Invoice Account Modified」を追跡する場合は、Main Line = Falseにするか、明細行レベルの変更用に別の検索を作成する必要があります。
Formulaの制限：NetSuiteのFormulaは4,000文字に制限されています。Activityのロジックが複雑になりすぎる場合は、2つの検索に分けるか、NetSuite外でマッピングを処理してください。

a サンプルクエリ config

Type: Transaction

CRITERIA TAB:
- Type: is any of Vendor Bill, Bill Payment, Bill Credit
- Main Line: is True
- System Notes : Date: is within [Your Date Range]

RESULTS TAB:

Column 1: Document Number
- Label: InvoiceNumber

Column 2: System Notes : Date
- Label: EventTime

Column 3: Formula (Text)
- Label: Activity
- Formula:
CASE 
   WHEN {systemnotes.type} = 'Create' AND {type} = 'Bill' THEN 'Invoice Created'
   WHEN {systemnotes.type} = 'Create' AND {type} = 'Bill' AND {createdfrom} IS NOT NULL THEN 'Invoice Matched to PO'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Approval Status' AND {systemnotes.newvalue} = 'Pending Approval' THEN 'Invoice Approval Requested'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Approval Status' AND {systemnotes.newvalue} = 'Open' THEN 'Invoice Approved'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Approval Status' AND {systemnotes.newvalue} = 'Rejected' THEN 'Invoice Rejected'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Amount' THEN 'Invoice Amount Modified'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Account' THEN 'Invoice Account Modified'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Payment Hold' AND {systemnotes.newvalue} = 'T' THEN 'Payment Hold Applied'
   WHEN {type} = 'Bill' AND {systemnotes.field} = 'Payment Hold' AND {systemnotes.newvalue} = 'F' THEN 'Payment Hold Released'
   WHEN {type} = 'Bill Credit' AND {systemnotes.type} = 'Create' THEN 'Vendor Credit Applied'
   WHEN {type} = 'Bill Payment' AND {systemnotes.type} = 'Create' AND {status} = 'Pending Approval' THEN 'Payment Scheduled'
   WHEN {type} = 'Bill Payment' AND {systemnotes.type} = 'Create' AND {status} = 'Paid In Full' THEN 'Payment Processed'
   WHEN {type} = 'Bill Payment' AND {systemnotes.field} = 'Void' THEN 'Payment Voided'
   WHEN {type} = 'Bill Payment' AND {systemnotes.field} = 'Cleared' AND {systemnotes.newvalue} = 'T' THEN 'Payment Cleared'
   ELSE 'General Update'
END

Column 4: Formula (Text)
- Label: SourceSystem
- Formula: 'NetSuite'

Column 5: Formula (Text)
- Label: LastDataUpdate
- Formula: TO_CHAR({today}, 'YYYY-MM-DD HH24:MI:SS')

Column 6: Vendor : Name
- Label: VendorName

Column 7: Subsidiary
- Label: Subsidiary

Column 8: Amount
- Label: InvoiceAmount

Column 9: Due Date
- Label: DueDate

Column 10: Created From
- Label: PurchaseOrderNumber

Column 11: System Notes : Set by
- Label: User

Column 12: Department
- Label: Department

Column 13: Status
- Label: ApprovalStatus

Column 14: Formula (Text)
- Label: IsNonPO
- Formula: CASE WHEN {createdfrom} IS NULL THEN 'True' ELSE 'False' END

ステップ

ODBCドライバーを設定：抽出用マシンにSuiteAnalytics Connect ODBCドライバーをインストールし、設定します。NetSuite Account ID、Role ID、有効な認証情報が必要です。
権限を確認：ODBC接続に関連付けられたユーザーロールには、「SuiteAnalytics Connect」権限と、Transactions、System Notes、Entitiesへの「View」アクセス権が必要です。
環境を準備：SQLクライアント（DBeaver、DataGrip、または専用のETLツールなど）を開き、NetSuiteデータソースへの接続を確立します。
対象範囲を定義：抽出対象のSubsidiary IDとDate Rangeを特定します。提供されたクエリ内の「VendorBills」というCommon Table Expression（CTE）のWHERE句を更新してください。
クエリを実行：提供されたSQLスクリプトを実行します。このスクリプトは、「Transaction」、「TransactionLine」、「SystemNote」、「TransactionLink」テーブルのデータを集約し、プロセス履歴を再構成します。
実行状況を監視：大規模なデータセットでは、NetSuiteのODBC接続がタイムアウトする場合があります。クエリが失敗した場合は、「trandate」フィルターを使い、月単位または四半期単位に分けて抽出してください。
データを検証：Invoice CreatedイベントとPayment Processedイベントが妥当な分布になっているか確認します。すべての行で「InvoiceNumber」が入力されていることを確認してください。
データをエクスポート：クエリ結果をCSVファイルとして保存するか、データフレームに直接取り込みます。仕入先名の特殊文字を処理できるよう、文字エンコーディングをUTF-8に設定してください。
日付を整形：ProcessMindへのインポート時に、「EventTime」列が日時オブジェクト（YYYY-MM-DD HH:MM:SS）として解析されることを確認してください。
NULLを処理：User列のNULL値は、スケジュールされたスクリプトなど、システムが生成したイベントを示すことがよくあります。必要に応じて、後処理で「System」に置き換えられます。
最終確認：「Activity」列に必要なイベント名（例：「Invoice Created」、「Payment Processed」）が含まれ、マッピングエラーが発生していないことを確認してください。

設定

日付範囲：「Transaction.trandate」を使ってフィルターします。初回のプロセスマイニング分析には、3～12か月の範囲を推奨します。
子会社による絞り込み：NetSuite環境がOneWorldの場合は、正しい法人を分析できるよう、必ず「Transaction.subsidiary」で絞り込んでください。
System Notes：承認履歴と変更履歴の抽出には「SystemNote」テーブルを使用します。「Log System Notes on Update Only」によって重要なワークフロー手順が記録されない設定になっていないことを確認してください。
取引ステータス：NetSuiteの取引ステータスは、「A」「B」などの個別の値で管理されます。クエリでは、これらを読みやすい文字列に変換します。環境で標準のステータスコードが使われていることを確認してください。
ODBCドライバーのバージョン：最近のNetSuiteアップグレードとの互換性問題を避けるため、利用可能な最新のSuiteAnalytics Connectドライバーを使用してください。

a サンプルクエリ sql

WITH VendorBills AS (
    SELECT
        t.ID AS TransactionID,
        t.tranid AS InvoiceNumber,
        t.trandate AS InvoiceDate,
        t.createDate AS CreatedDate,
        t.lastModifiedDate AS LastModified,
        e.altName AS VendorName,
        s.name AS Subsidiary,
        t.foreignTotal AS InvoiceAmount,
        t.dueDate AS DueDate,
        t.createdFrom AS CreatedFromID,
        CASE WHEN t.createdFrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
        dep.name AS Department,
        'NetSuite' AS SourceSystem
    FROM
        Transaction t
        LEFT JOIN Entity e ON t.entity = e.id
        LEFT JOIN Subsidiary s ON t.subsidiary = s.id
        LEFT JOIN Department dep ON t.department = dep.id
    WHERE
        t.type = 'VendBill'
        AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD') -- REPLACE WITH YOUR START DATE
        AND t.trandate <= TO_DATE('2023-12-31', 'YYYY-MM-DD') -- REPLACE WITH YOUR END DATE
),
PO_Data AS (
    SELECT
        t.ID AS PO_ID,
        t.tranid AS PONumber
    FROM
        Transaction t
    WHERE
        t.type = 'PurchOrd'
)

-- 1. Invoice Created
SELECT
    vb.InvoiceNumber,
    'Invoice Created' AS Activity,
    vb.CreatedDate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Created' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID

UNION ALL

-- 2. Invoice Matched to PO
SELECT
    vb.InvoiceNumber,
    'Invoice Matched to PO' AS Activity,
    vb.CreatedDate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Created' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID

UNION ALL

-- 3. Invoice Approval Requested (Derived from System Notes)
SELECT
    vb.InvoiceNumber,
    'Invoice Approval Requested' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Pending Approval' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'approvalstatus'
    AND sn.newValue = 'Pending Approval'

UNION ALL

-- 4. Invoice Approved
SELECT
    vb.InvoiceNumber,
    'Invoice Approved' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Open' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'approvalstatus'
    AND (sn.newValue = 'Approved' OR sn.newValue = 'Open')

UNION ALL

-- 5. Invoice Rejected
SELECT
    vb.InvoiceNumber,
    'Invoice Rejected' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Rejected' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'approvalstatus'
    AND sn.newValue = 'Rejected'

UNION ALL

-- 6. Invoice Amount Modified
SELECT
    vb.InvoiceNumber,
    'Invoice Amount Modified' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Modified' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    (sn.standardfield = 'foreigntotal' OR sn.standardfield = 'total')

UNION ALL

-- 7. Invoice Account Modified
SELECT
    vb.InvoiceNumber,
    'Invoice Account Modified' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Modified' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'account'

UNION ALL

-- 8. Payment Hold Applied
SELECT
    vb.InvoiceNumber,
    'Payment Hold Applied' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Hold' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'paymenthold'
    AND sn.newValue = 'T'

UNION ALL

-- 9. Payment Hold Released
SELECT
    vb.InvoiceNumber,
    'Payment Hold Released' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Released' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN SystemNote sn ON vb.TransactionID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    sn.standardfield = 'paymenthold'
    AND sn.newValue = 'F'

UNION ALL

-- 10. Vendor Credit Applied
SELECT
    vb.InvoiceNumber,
    'Vendor Credit Applied' AS Activity,
    vc.createDate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Credit Applied' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN TransactionLink tl ON vb.TransactionID = tl.previousDoc
    INNER JOIN Transaction vc ON tl.nextDoc = vc.ID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
WHERE
    vc.type = 'VendCred'

UNION ALL

-- 11. Payment Scheduled (Bill Payment created but pending)
SELECT
    vb.InvoiceNumber,
    'Payment Scheduled' AS Activity,
    vp.createDate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Scheduled' AS ApprovalStatus,
    vb.IsNonPO,
    vp.trandate AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN TransactionLink tl ON vb.TransactionID = tl.previousDoc
    INNER JOIN Transaction vp ON tl.nextDoc = vp.ID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
WHERE
    vp.type = 'VendPymt'
    AND vp.status = 'Pending Approval'

UNION ALL

-- 12. Payment Processed (Payment posted)
SELECT
    vb.InvoiceNumber,
    'Payment Processed' AS Activity,
    vp.trandate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Paid' AS ApprovalStatus,
    vb.IsNonPO,
    vp.trandate AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN TransactionLink tl ON vb.TransactionID = tl.previousDoc
    INNER JOIN Transaction vp ON tl.nextDoc = vp.ID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
WHERE
    vp.type = 'VendPymt'
    AND (vp.status = 'PaidInFull' OR vp.status = 'Deposited' OR vp.status = 'NotDeposited')

UNION ALL

-- 13. Payment Voided
SELECT
    vb.InvoiceNumber,
    'Payment Voided' AS Activity,
    sn.date AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    emp.entityid AS User,
    vb.Department,
    'Voided' AS ApprovalStatus,
    vb.IsNonPO,
    NULL AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN TransactionLink tl ON vb.TransactionID = tl.previousDoc
    INNER JOIN Transaction vp ON tl.nextDoc = vp.ID
    INNER JOIN SystemNote sn ON vp.ID = sn.recordID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
    LEFT JOIN Entity emp ON sn.name = emp.id
WHERE
    vp.type = 'VendPymt'
    AND sn.standardfield = 'status'
    AND sn.newValue LIKE '%Void%'

UNION ALL

-- 14. Payment Cleared
SELECT
    vb.InvoiceNumber,
    'Payment Cleared' AS Activity,
    vp.clearedDate AS EventTime,
    vb.SourceSystem,
    vb.LastModified AS LastDataUpdate,
    vb.VendorName,
    vb.Subsidiary,
    vb.InvoiceAmount,
    vb.DueDate,
    po.PONumber AS PurchaseOrderNumber,
    NULL AS User,
    vb.Department,
    'Cleared' AS ApprovalStatus,
    vb.IsNonPO,
    vp.trandate AS PaymentDate
FROM
    VendorBills vb
    INNER JOIN TransactionLink tl ON vb.TransactionID = tl.previousDoc
    INNER JOIN Transaction vp ON tl.nextDoc = vp.ID
    LEFT JOIN PO_Data po ON vb.CreatedFromID = po.PO_ID
WHERE
    vp.type = 'VendPymt'
    AND vp.clearedDate IS NOT NULL

ステップ

前提条件：AdministratorまたはDeveloperのアクセス権を持つNetSuiteアカウントを用意します。Setup > Company > Enable Featuresで、「SuiteTalk REST Web Services」と「SuiteAnalytics Connect」機能を有効にする必要があります。
統合を設定：Setup > Integration > Manage Integrations > Newに移動します。「ProcessMining_ETL」という名前の統合を作成します。「Rest Web Services」と「Token-Based Authentication」を選択し、生成されたConsumer KeyとConsumer Secretを控えてください。
トークンを生成：Manage Access Tokensページに移動します。Transactions、System Notes、Listsの閲覧権限を持つロール用に新しいトークンを作成し、Token IDとToken Secretを控えてください。
Python環境：Python 3.xをインストールします。pipで必要なライブラリをインストールします：pip install requests requests-oauthlib pandas
スクリプトを設定：下記のQueryセクションにあるPythonスクリプトをコピーします。ACCOUNT_ID、CONSUMER_KEY、CONSUMER_SECRET、TOKEN_ID、TOKEN_SECRET変数を認証情報で更新します。START_DATE変数には、希望する抽出期間（例：「2023-01-01」）を設定してください。
SuiteQLロジック：このスクリプトはUNION ALL方式を使用します。Transactionテーブルから作成イベントと支払イベントを、SystemNoteテーブルから監査証跡イベント（承認、変更、保留）を取得します。
実行：コマンドラインで次のコマンドを実行します：python netsuite_extract.py。スクリプトはページネーションを自動処理します（SuiteQLでは1,000件単位でページが作成されます）。
データ処理：スクリプトはJSONレスポンスを、プロセスマイニングに適したフラットな表形式へ自動変換します。列のマッピングと日付の整形も処理します。
検証：スクリプトに表示される抽出行数を確認します。必要に応じて、NetSuiteの保存検索と照合してください。
エクスポート：最終的なデータフレームは「netsuite_ap_event_log.csv」として保存されます。このファイルはProcessMindにアップロードできます。
アップロード：CSVをProcessMindにインポートします。InvoiceNumberをCase ID、ActivityをActivity、EventTimeをTimestampとしてマッピングしてください。

設定

認証：OAuth 1.0a（トークンベース認証）を使用します。これはNetSuite REST APIの標準セキュリティモデルです。
バッチサイズ：スクリプトは1ページあたり1,000行を要求します（SuiteQLのデフォルト最大値）。
日付フィルタリング：パフォーマンスを最適化するため、取引にはtrandate、システムメモにはdateを使用し、START_DATE以降に絞り込みます。
範囲：取引テーブルを、タイプが「VendBill」（仕入先請求書）、「BillPymt」（請求書支払い）、「VendCred」（仕入先クレジット）のレコードに絞り込みます。
システムメモ：このテーブルは、承認ループや変更を取得するうえで重要です。サイズが大きくなる可能性があるため、連携ユーザーにSystemNoteを照会する権限があることを確認してください。
タイムゾーン：NetSuite APIは、アカウントのタイムゾーンで日付を返します。スクリプトは標準のISO形式を前提としています。

a サンプルクエリ python

import requests
from requests_oauthlib import OAuth1
import pandas as pd
import time

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
ACCOUNT_ID = class="hl-string">'1234567_SB1'  class=class="hl-string">"hl-comment"># Your NetSuite Account ID (Realm). Use hyphens for sandbox (e.g., 1234567-sb1)
CONSUMER_KEY = class="hl-string">'your_consumer_key'
CONSUMER_SECRET = class="hl-string">'your_consumer_secret'
TOKEN_ID = class="hl-string">'your_token_id'
TOKEN_SECRET = class="hl-string">'your_token_secret'
START_DATE = class="hl-string">'2024-01-01'  class=class="hl-string">"hl-comment"># Filter for data extraction

class=class="hl-string">"hl-comment"># Normalize Account ID for URL (NetSuite requires lowercase and hyphens)
url_account_id = ACCOUNT_ID.lower().replace(class="hl-string">'_', class="hl-string">'-')
BASE_URL = fclass="hl-string">'https://{url_account_id}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql'

class=class="hl-string">"hl-comment"># === SUITEQL QUERY ===
class=class="hl-string">"hl-comment"># This query extracts 14 activities using UNION ALL to combine Transaction data and System Notes.
suiteql_query = fclass="hl-string">"""
/* 1. Invoice Created */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Created' AS Activity,
    TO_CHAR(t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM Transaction t
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee e ON t.createdBy = e.id
LEFT JOIN Department d ON t.department = d.id
WHERE t.type = 'VendBill'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 2. Invoice Matched to PO */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Matched to PO' AS Activity,
    TO_CHAR(t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    'False' AS IsNonPO,
    NULL AS PaymentDate
FROM Transaction t
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee e ON t.createdBy = e.id
LEFT JOIN Department d ON t.department = d.id
WHERE t.type = 'VendBill'
AND t.createdfrom IS NOT NULL
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 3. Invoice Approval Requested (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Approval Requested' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30 /* Internal ID for Vendor Bill */
AND sn.field = 'status'
AND sn.value = 'Pending Approval'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 4. Invoice Approved (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Approved' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'status'
AND sn.value = 'Open'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 5. Invoice Rejected (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Rejected' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'status'
AND sn.value = 'Rejected'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 6. Invoice Amount Modified (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Amount Modified' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'total'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 7. Invoice Account Modified (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Invoice Account Modified' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'account'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 8. Payment Hold Applied (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Payment Hold Applied' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'paymenthold'
AND sn.value = 'T'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 9. Payment Hold Released (System Note) */
SELECT
    t.tranid AS InvoiceNumber,
    'Payment Hold Released' AS Activity,
    TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t.foreignTotal AS InvoiceAmount,
    t.duedate AS DueDate,
    t.otherrefnum AS PurchaseOrderNumber,
    rau.entityid AS User,
    d.name AS Department,
    t.status AS ApprovalStatus,
    CASE WHEN t.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    NULL AS PaymentDate
FROM SystemNote sn
JOIN Transaction t ON sn.recordid = t.id
LEFT JOIN Entity bu ON t.entity = bu.id
LEFT JOIN Subsidiary s ON t.subsidiary = s.id
LEFT JOIN Employee rau ON sn.name = rau.id
LEFT JOIN Department d ON t.department = d.id
WHERE sn.recordtypeid = -30
AND sn.field = 'paymenthold'
AND sn.value = 'F'
AND t.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 10. Vendor Credit Applied */
SELECT
    t_bill.tranid AS InvoiceNumber,
    'Vendor Credit Applied' AS Activity,
    TO_CHAR(t_cred.trandate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t_bill.foreignTotal AS InvoiceAmount,
    t_bill.duedate AS DueDate,
    t_bill.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t_bill.status AS ApprovalStatus,
    CASE WHEN t_bill.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    t_cred.trandate AS PaymentDate
FROM Transaction t_cred
JOIN TransactionLine tl ON t_cred.id = tl.transaction
JOIN Transaction t_bill ON tl.appliedtotransaction = t_bill.id
LEFT JOIN Entity bu ON t_bill.entity = bu.id
LEFT JOIN Subsidiary s ON t_bill.subsidiary = s.id
LEFT JOIN Employee e ON t_cred.createdBy = e.id
LEFT JOIN Department d ON t_bill.department = d.id
WHERE t_cred.type = 'VendCred'
AND t_bill.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 11. Payment Scheduled */
SELECT
    t_bill.tranid AS InvoiceNumber,
    'Payment Scheduled' AS Activity,
    TO_CHAR(t_pay.createddate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t_bill.foreignTotal AS InvoiceAmount,
    t_bill.duedate AS DueDate,
    t_bill.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t_bill.status AS ApprovalStatus,
    CASE WHEN t_bill.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    t_pay.trandate AS PaymentDate
FROM Transaction t_pay
JOIN TransactionLine tl ON t_pay.id = tl.transaction
JOIN Transaction t_bill ON tl.appliedtotransaction = t_bill.id
LEFT JOIN Entity bu ON t_bill.entity = bu.id
LEFT JOIN Subsidiary s ON t_bill.subsidiary = s.id
LEFT JOIN Employee e ON t_pay.createdBy = e.id
LEFT JOIN Department d ON t_bill.department = d.id
WHERE t_pay.type = 'BillPymt'
AND t_pay.status = 'Pending Approval'
AND t_bill.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 12. Payment Processed */
SELECT
    t_bill.tranid AS InvoiceNumber,
    'Payment Processed' AS Activity,
    TO_CHAR(t_pay.trandate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t_bill.foreignTotal AS InvoiceAmount,
    t_bill.duedate AS DueDate,
    t_bill.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t_bill.status AS ApprovalStatus,
    CASE WHEN t_bill.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    t_pay.trandate AS PaymentDate
FROM Transaction t_pay
JOIN TransactionLine tl ON t_pay.id = tl.transaction
JOIN Transaction t_bill ON tl.appliedtotransaction = t_bill.id
LEFT JOIN Entity bu ON t_bill.entity = bu.id
LEFT JOIN Subsidiary s ON t_bill.subsidiary = s.id
LEFT JOIN Employee e ON t_pay.createdBy = e.id
LEFT JOIN Department d ON t_bill.department = d.id
WHERE t_pay.type = 'BillPymt'
AND t_pay.status <> 'Voided'
AND t_bill.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 13. Payment Voided */
SELECT
    t_bill.tranid AS InvoiceNumber,
    'Payment Voided' AS Activity,
    TO_CHAR(t_pay.lastmodifieddate, 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t_bill.foreignTotal AS InvoiceAmount,
    t_bill.duedate AS DueDate,
    t_bill.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t_bill.status AS ApprovalStatus,
    CASE WHEN t_bill.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    t_pay.trandate AS PaymentDate
FROM Transaction t_pay
JOIN TransactionLine tl ON t_pay.id = tl.transaction
JOIN Transaction t_bill ON tl.appliedtotransaction = t_bill.id
LEFT JOIN Entity bu ON t_bill.entity = bu.id
LEFT JOIN Subsidiary s ON t_bill.subsidiary = s.id
LEFT JOIN Employee e ON t_pay.createdBy = e.id
LEFT JOIN Department d ON t_bill.department = d.id
WHERE t_pay.type = 'BillPymt'
AND t_pay.status = 'Voided'
AND t_bill.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')

UNION ALL

/* 14. Payment Cleared (Logic depends on bank rec features, using Check Cleared date or modification) */
SELECT
    t_bill.tranid AS InvoiceNumber,
    'Payment Cleared' AS Activity,
    /* Fallback to trandate if clearedDate is unavailable in your config */
    TO_CHAR(COALESCE(t_pay.createddate, t_pay.trandate), 'YYYY-MM-DD HH24:MI:SS') AS EventTime,
    'NetSuite' AS SourceSystem,
    TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
    bu.name AS VendorName,
    s.name AS Subsidiary,
    t_bill.foreignTotal AS InvoiceAmount,
    t_bill.duedate AS DueDate,
    t_bill.otherrefnum AS PurchaseOrderNumber,
    e.entityid AS User,
    d.name AS Department,
    t_bill.status AS ApprovalStatus,
    CASE WHEN t_bill.createdfrom IS NULL THEN 'True' ELSE 'False' END AS IsNonPO,
    t_pay.trandate AS PaymentDate
FROM Transaction t_pay
JOIN TransactionLine tl ON t_pay.id = tl.transaction
JOIN Transaction t_bill ON tl.appliedtotransaction = t_bill.id
LEFT JOIN Entity bu ON t_bill.entity = bu.id
LEFT JOIN Subsidiary s ON t_bill.subsidiary = s.id
LEFT JOIN Employee e ON t_pay.createdBy = e.id
LEFT JOIN Department d ON t_bill.department = d.id
WHERE t_pay.type = 'BillPymt'
AND t_pay.status = 'Paid In Full' /* Indicates cleared/posted in some contexts */
AND t_bill.trandate >= TO_DATE('{START_DATE}', 'YYYY-MM-DD')
"""

class=class="hl-string">"hl-comment"># === AUTH AND EXECUTION ===

def get_suiteql_results(query):
    oauth = OAuth1(
        client_key=CONSUMER_KEY,
        client_secret=CONSUMER_SECRET,
        resource_owner_key=TOKEN_ID,
        resource_owner_secret=TOKEN_SECRET,
        realm=ACCOUNT_ID,
        signature_method=class="hl-string">'HMAC-SHA256'
    )
    
    all_rows = []
    offset = 0
    has_more = True
    
    print(class="hl-string">"Starting extraction...")
    
    while has_more:
        class=class="hl-string">"hl-comment"># SuiteQL REST API payload
        headers = {
            class="hl-string">'Prefer': class="hl-string">'transient',
            class="hl-string">'Content-Type': class="hl-string">'application/json'
        }
        
        class=class="hl-string">"hl-comment"># Add LIMIT/OFFSET to query if not using built-in cursors (SuiteQL doesn't support OFFSET well natively in string, 
        class=class="hl-string">"hl-comment"># but REST API handles pagination via links. However, for raw query, we usually rely on class="hl-string">'items' return)
        class=class="hl-string">"hl-comment"># Note: Pure SuiteQL via REST returns a set number of records. We must iterate via the class="hl-string">'links' provided in response
        class=class="hl-string">"hl-comment"># or typically, SuiteQL REST creates a job for large queries. 
        class=class="hl-string">"hl-comment"># For simplicity in this script, we assume a direct synchronous call pattern.
        
        class=class="hl-string">"hl-comment"># Actually, for large datasets, we must use the class="hl-string">'q' parameter. 
        class=class="hl-string">"hl-comment"># But SuiteQL POST body is standard. We will implement simple looping if class="hl-string">'hasMore' is present.
        
        payload = {
            class="hl-string">"q": query
        }
        
        response = requests.post(BASE_URL, headers=headers, auth=oauth, json=payload)
        
        if response.status_code != 200:
            print(fclass="hl-string">"Error: {response.text}")
            break
            
        data = response.json()
        items = data.get(class="hl-string">'items', [])
        all_rows.extend(items)
        
        class=class="hl-string">"hl-comment"># Check if there are more results (SuiteQL REST paging)
        class=class="hl-string">"hl-comment"># Standard REST response has class="hl-string">'hasMore' and class="hl-string">'links'. 
        class=class="hl-string">"hl-comment"># However, Query API V1 often requires traversing the class="hl-string">'next' link.
        has_more = data.get(class="hl-string">'hasMore', False)
        
        if has_more:
            class=class="hl-string">"hl-comment"># For subsequent pages, we follow the class="hl-string">'next' link logic or offset logic.
            class=class="hl-string">"hl-comment"># Note: The Query API creates a paged result set. We strictly need to follow the class="hl-string">'links' > class="hl-string">'next'.
            links = data.get(class="hl-string">'links', [])
            next_link = next((l[class="hl-string">'href'] for l in links if l[class="hl-string">'rel'] == class="hl-string">'next'), None)
            if next_link:
                BASE_URL = next_link class=class="hl-string">"hl-comment"># Update URL for next loop
                class=class="hl-string">"hl-comment"># Payload is not needed for next link GET usually, but Query API might differ.
                class=class="hl-string">"hl-comment"># If using links, we switch to GET for the next page.
                class=class="hl-string">"hl-comment"># (Simplified logic: In production, robustly handle the href)
            else:
                has_more = False
        
        print(fclass="hl-string">"Fetched {len(items)} rows. Total: {len(all_rows)}")
        time.sleep(1) class=class="hl-string">"hl-comment"># Rate limit protection

    return pd.DataFrame(all_rows)

class=class="hl-string">"hl-comment"># === RUN ===
if __name__ == class="hl-string">'__main__':
    df = get_suiteql_results(suiteql_query)
    
    class=class="hl-string">"hl-comment"># Post-processing
    if not df.empty:
        class=class="hl-string">"hl-comment"># Ensure numeric formats
        df[class="hl-string">'invoiceamount'] = pd.to_numeric(df[class="hl-string">'invoiceamount'], errors=class="hl-string">'coerce').fillna(0)
        
        class=class="hl-string">"hl-comment"># Save
        filename = class="hl-string">'netsuite_ap_event_log.csv'
        df.to_csv(filename, index=False)
        print(fclass="hl-string">"Success! Saved {len(df)} rows to {filename}")
    else:
        print(class="hl-string">"No data found.")

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

このテンプレートをNetSuite環境に適用して、今日からプロセスマイニングを始めましょう。支払ワークフローの効率化につながるポイントを見つけ、すぐに改善へ取り組めます。

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

今すぐ買掛金支払処理を最適化

ボトルネックを特定し、サイクルタイムを30％短縮します。

無料トライアルを開始

クレジットカードは不要です。設定は数分で完了します。

買掛金支払処理用データテンプレート

買掛金支払処理用データテンプレート

買掛金支払い処理の属性

買掛金支払い処理のアクティビティ

抽出ガイド

買掛金取引向けNetSuite保存検索エクスポート

ステップ

設定

a サンプルクエリ config

SuiteAnalytics Connect ODBCを使用したSuiteQL抽出

ステップ

設定

a サンプルクエリ sql

SuiteTalk REST APIとSuiteQLを使用したPython ETL

ステップ

設定

a サンプルクエリ python

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

今すぐ買掛金支払処理を最適化

買掛金支払処理用データテンプレート

買掛金支払処理用データテンプレート

買掛金支払い処理の属性

買掛金支払い処理のアクティビティ

抽出ガイド

買掛金取引向けNetSuite保存検索エクスポート

ステップ

設定

a サンプルクエリ config

SuiteAnalytics Connect ODBCを使用したSuiteQL抽出

ステップ

設定

a サンプルクエリ sql

SuiteTalk REST APIとSuiteQLを使用したPython ETL

ステップ

設定

a サンプルクエリ python

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

今すぐ買掛金支払処理を最適化

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