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

買掛金の支払処理向けデータテンプレート

NetSuite

← 改善ガイドに戻る

買掛金の支払処理に関する属性(21) 買掛金の支払処理に関するアクティビティ(14) データ抽出ガイド(3)

買掛金の支払処理向けデータテンプレート

このテンプレートは、NetSuiteの買掛金ワークフローをマッピングするための枠組みです。分析の正確性と実行可能性を高めるために必要なデータ属性、主要なプロセスアクティビティ、抽出手順を詳しくまとめています。

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

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

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

買掛金の支払処理に関する属性

NetSuite環境で買掛金の支払処理を詳しく分析するには、これらのデータ項目をイベントログに含めることをおすすめします。

5 必須 10 推奨 6 任意

	名前	説明
	アクティビティ Activity	実行されたプロセスの工程またはイベントの名前です。
説明この属性には、特定の時点で発生したアクションや状態の変化が記録されます。例として、「請求書作成」「承認ステータス変更」「支払い処理」などがあります。プロセスフローマップの再構築に欠かせないデータです。請求書番号ごとにアクティビティを時系列に並べると、プロセスマイニングツールで実際のワークフローを可視化できます。ループや手戻り、理想経路からの逸脱も特定できます。重要な理由プロセスマップの工程を定義する項目であり、プロセスマイニング分析に必須です。入手先 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です。入手先取引テーブルで、タイプが「Vendor Bill」のレコードのtranidフィールド例 INV-2023-001VB-99822ACME-10299982311
	ユーザー User	アクティビティを実行した従業員です。
説明請求書の承認や支払ブロックの解除など、特定のイベントを担当した人を示します。「承認ワークフローのボトルネック監視」で使用し、担当者ごとの遅延を特定します。管理者は業務量の配分を調整し、チームメンバーごとの研修ニーズを把握できます。重要な理由リソース分析と、ユーザー単位のボトルネック特定に必要です。入手先 System Notesの「name」またはTransactionの「employee」例山田太郎財務管理者システム
	仕入先名 VendorName	請求書を発行した仕入先の名前です。
説明仕入先請求書に関連付けられた取引先の名前を示す属性です。サプライチェーン全体のパフォーマンス分析に欠かせません。分析では、「仕入先別支払いサイクルのばらつき」ダッシュボードで使用します。仕入先ごとにケースをグループ化し、照合の不一致が繰り返し発生する仕入先や、標準外の支払条件を設定している仕入先を特定できます。重要な理由仕入先ごとの分析をグループ化し、固有のボトルネックを特定するために必要です。入手先取引の「entity」フィールドを仕入先レコードに結合例 Office DepotOracleFedEx
	子会社 Subsidiary	請求書を受け取る会社の子会社または法人です。
説明 NetSuite OneWorld環境で、請求書が属する法人（子会社）を特定します。組織間の比較に利用できます。「支払いサイクルのエンドツーエンド所要時間」ダッシュボードで使用し、事業部門ごとの効率を比較できます。特定の地域や法人のパフォーマンスが低いかどうかを把握するのに役立ちます。重要な理由複数の法人を持つ組織で、事業部門間のパフォーマンスを比較するために重要です。入手先取引の「subsidiary」フィールド例米国東部EMEA本社APAC営業
	承認状況 ApprovalStatus	請求書の現在のワークフロー承認状態です。
説明請求書が承認待ち、承認済み、却下のいずれであるかを示します。この状態に基づいてワークフローの遷移が決まります。「承認ワークフローのコンプライアンス監査」の中心となる項目です。状態が変わるとアクティビティイベントが記録され、最終状態から請求書が支払い可能かどうかを判断できます。重要な理由承認プロセスにおける請求書の進捗を追跡します。入手先取引の「approvalstatus」フィールド例承認待ち承認済み却下
	支払日 PaymentDate	支払いが実行された日付です。
説明請求書に関連付けられた仕入先支払取引に記録された日付です。買掛金処理サイクルの完了を示します。「支払いサイクルのエンドツーエンド所要時間」の計算に使用します。この日付と「InvoiceDate」を比較すると、プロセス全体の所要時間がわかります。重要な理由主要なプロセスサイクルの終了タイムスタンプです。入手先関連付けられた仕入先支払取引の日付例 2023-11-202023-12-05
	支払期日 DueDate	仕入先への支払い期限です。
説明請求書の支払条件に基づく契約上の支払期限を示します。期限内支払いの計算に使うベースラインです。「期限内支払率」の重要業績評価指標（KPI）を算出するための中心的な項目です。「支払実行日」と比較して支払遅延を検出し、発生する可能性のあるペナルティの推定に役立ちます。重要な理由期限内支払率の計算と、支払期限を過ぎた債務の特定に欠かせません。入手先取引の「duedate」フィールド例 2023-11-152023-12-01
	発注書なし IsNonPO	請求書が発注書に関連付けられていないことを示すフラグです。
説明関連する発注書がない場合に設定される真偽値属性です。プロセスを、発注書に基づく請求書と、直接処理されるFI請求書に分けます。「発注書なし請求書の処理速度」ダッシュボードで使用し、3点照合プロセスと比較して、請求書の手作業処理にどの程度の非効率があるかを明らかにします。重要な理由プロセスのバリアントを分析するための大分類です。入手先「PurchaseOrderNumber」がnullの場合に算出例 truefalse
	発注書番号 PurchaseOrderNumber	関連する発注書の参照番号です。
説明仕入先請求書を元となる発注書（PO）に関連付けます。この項目が空の場合、請求書は発注書なしの請求書として扱われます。「発注書なし請求書の処理速度」ダッシュボードに欠かせない属性です。プロセスのバリアントを発注書ありと発注書なし（FI）の請求書に分け、効率とコンプライアンスを比較できます。重要な理由発注書に基づく請求書処理と、発注書なしの請求書処理を区別するために必要です。入手先取引の「createdfrom」フィールド例 PO-8821PO-1002null
	請求金額 InvoiceAmount	請求書の合計金額です。
説明仕入先請求書の合計金額です。通常、基準通貨または取引通貨で表示されます。財務への影響を分析する際に使用します。「支払遅延とペナルティの追跡」ダッシュボードでは、支払いの遅れによるキャッシュフローリスクを定量化します。また、高額な請求書を優先して手作業で処理する際にも役立ちます。重要な理由プロセスの非効率が財務に与える影響の定量化に必要です。入手先取引の「usertotal」または「foreignamount」フィールド例 1500.00250.5010000.00
	部門 Department	請求書に関連する社内の部門です。
説明費用を負担したコストセンターまたは社内部門（IT、マーケティングなど）ごとに請求書を分類します。部門ごとのサイクルタイムを分析できます。特定の部門で請求書の勘定科目コード設定や承認に時間がかかっているかを把握し、対象を絞ったプロセス改善につなげられます。重要な理由組織内のプロセス効率を分析できます。入手先取引の「department」フィールド例 ITマーケティング製造
	割引可能額 DiscountAvailable	早期支払いで適用できる割引額です。
説明請求金額と支払条件に基づいて算出される早期支払い割引額です。割引による節約の可能性を示します。「早期支払い割引の獲得率」ダッシュボードの中心となる属性です。支払遅延が発生した請求書についてこの値を合計すると、取り逃した割引額を算出できます。重要な理由プロセスの迅速化による財務上の効果を定量化します。入手先支払条件と請求金額から算出例 30.000.0015.50
	支払保留 PaymentHold	請求書の支払いが現在保留されているかどうかを示します。
説明請求書に支払保留が設定され、支払処理の対象から除外されていることを示すフラグまたは状態です。「支払ブロックの影響分析」ダッシュボードで使用します。この項目が「true」に設定されている期間を分析すると、紛争や情報不足による処理遅延を特定できます。重要な理由請求書が滞留または遅延している理由の分析に重要です。入手先取引の「paymenthold」フィールド例 truefalse
	支払期限超過日数 DaysOverdue	支払期日を過ぎてから支払いが行われるまでの日数です。
説明支払期日からの遅延日数を測定する計算指標です。負の値は期日前の支払いを示します。「支払遅延とペナルティの追跡」ダッシュボードにデータを提供します。支払遅延の程度を定量化し、遅延が常態化しているパターンを特定するために欠かせません。重要な理由支払いのコンプライアンスとペナルティリスクの分析に使う主要指標です。入手先計算式：PaymentDate - DueDate 例 50-2
	支払条件 PaymentTerms	支払い時期や割引に関する合意条件です。
説明「Net 30」や「2% 10 Net 30」などの支払条件を示します。支払期日や早期支払い割引の適用可能性を把握する際に役立ちます。「早期支払い割引の獲得率」ダッシュボードで使用します。割引対象となる請求書を特定し、割引の取り逃しと特定の厳しい支払条件との関連を分析できます。重要な理由支払期日の背景を把握し、割引の機会を特定できます。入手先取引の「terms」フィールド例 Net 302% 10 Net 30受領時払い
	請求書日付 InvoiceDate	仕入先の請求書に記載された日付です。
説明仕入先が提示した文書の日付です。経過日数の計算を開始する基準となることがよくあります。「処理サイクルのエンドツーエンド所要時間」の計算に使用します。この日付とNetSuiteでの作成日との差から、スキャンやメール室での遅延を把握できます。重要な理由仕入先側の処理期間の正式な開始日を示します。入手先取引の「trandate」フィールド例 2023-10-012023-10-05
	通貨 Currency	請求書の発行に使用された通貨です。
説明取引通貨を表すISOコードです。多国籍の組織では特に重要です。「請求金額」の分析で金額を標準化するために使用します。また、為替処理によって「支払決済」アクティビティにかかる時間が増えているかどうかの把握にも役立ちます。重要な理由財務データの正確な集計と為替分析に必要です。入手先取引の「currency」フィールド例 USDEURGBP

必須推奨任意

買掛金の支払処理に関するアクティビティ

支払処理の全体像を正確に把握するため、これらの主要なプロセス手順と節目をイベントログに記録してください。

5 推奨 9 任意

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

推奨任意

データ抽出ガイド

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

ステップ

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

設定

取引タイプ：仕訳や発注書による不要なデータを避けるため、Vendor Bill、Bill Payment、Bill Creditだけに絞ります。
System Notesの結合：この設定では、現在の状態だけでなく履歴ログを作成するためにSystem Notesの結合を利用します。ユーザーロールにSystem Notesの閲覧権限があることを確認してください。
日付範囲：日付フィルターは取引の日付ではなく、「System Notes：Date」フィールドに適用します。これにより、昨年作成された請求書に今日支払いが行われた場合など、古い請求書に関する最近のアクティビティも取得できます。
Main Line：行数を抑えるには「Main Line = True」を推奨します。ただし、「Invoice Account Modified」を追跡する場合は、「Main Line = False」にするか、明細行レベルの変更を対象とする検索を別途作成する必要があります。
数式の制限：NetSuiteの数式は4,000文字までです。アクティビティのロジックが複雑になりすぎる場合は、検索を2つに分けるか、NetSuite外でマッピングしてください。

クエリの例 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のアカウントID、ロールID、有効な認証情報が必要です。
権限の確認：ODBC接続に関連付けられたユーザーロールに、「SuiteAnalytics Connect」の権限と、取引、System Notes、エンティティへの「View」アクセス権が必要です。
環境の準備：SQLクライアント（DBeaver、DataGrip、または独自のETLツールなど）を開き、NetSuiteのデータソースに接続します。
対象範囲の指定：抽出対象の子会社IDと日付範囲を特定します。提供されたクエリ内の「VendorBills」という共通テーブル式（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ドライバーを使用してください。

クエリの例 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

ステップ

前提条件：管理者または開発者のアクセス権を持つ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ページに移動します。取引、System Notes、Listsの閲覧権限を持つロールに対して、新しいトークンを作成します。Token IDとToken Secretを控えてください。
Python環境：Python 3.xをインストールします。pipで必要なライブラリをインストールします：pip install requests requests-oauthlib pandas。
スクリプトの設定：下記のクエリセクションにある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ページあたり1,000件のレコードが取得され、ページネーションはスクリプトが自動で処理します。
データ処理：スクリプトはJSONレスポンスをプロセスマイニングに適したフラットな表形式に自動変換します。列のマッピングと日付の書式設定も行います。
検証：スクリプトに表示される抽出行数を確認します。必要に応じて、NetSuiteの保存検索の結果と照合してください。
エクスポート：最終的なデータフレームはnetsuite_ap_event_log.csvとして保存されます。このファイルをProcessMindにアップロードできます。
アップロード：CSVをProcessMindにインポートします。InvoiceNumberをケースID、Activityをアクティビティ、EventTimeをタイムスタンプにマッピングします。

設定

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

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

ステップ

設定

クエリの例 config

SuiteAnalytics Connect ODBCを使ったSuiteQL抽出

ステップ

設定

クエリの例 sql

SuiteQLを使ったSuiteTalk REST APIによるPython ETL

ステップ

設定

クエリの例 python

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

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