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

買掛金請求書処理のデータテンプレート

NetSuite

買掛金請求書処理の属性 (21) 買掛金請求書処理のアクティビティ (14) 抽出ガイド (4)

買掛金請求書処理のデータテンプレート

この詳細なテンプレートは、買掛金請求書処理を最適化するために必要なデータの収集を支援します。イベントログに収集すべき属性と追跡すべき主要なアクティビティをまとめています。さらに、NetSuiteからこれらのデータを抽出する方法も説明しているため、正確なプロセス分析と改善に必要な情報を揃えられます。

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

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

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

買掛金請求書処理の属性

買掛金請求書処理を詳細に分析するため、イベントログに含める推奨データ項目です。

5 必須 6 推奨 10 任意

	名前	説明
	アクティビティ ActivityName	請求書プロセスで発生した業務アクティビティまたはイベントの名称。
説明買掛金プロセスにおける特定のステップまたは節目を示す属性です。例として「Vendor Bill Created」、「Invoice Approved」、「Payment Executed」などがあります。これらのアクティビティの順序と頻度を分析することが、プロセスマイニングの中心です。プロセスフローを可視化し、一般的なプロセスバリアントとまれなプロセスバリアントを特定するとともに、ボトルネックや標準手順からの逸脱を見つけ出せます。定義したアクティビティがプロセスマップのノードになります。重要な理由プロセスの各ステップを定義し、プロセスマップの可視化、遷移時間の計算、ボトルネックや手戻りループの特定を可能にします。入手先 NetSuiteの仕入先請求書および関連する支払レコードのシステムログ、監査証跡、ステータス変更から導出します。通常は変換ロジックが必要です。例仕入先請求書の作成請求書の承認支払いの実行不一致の特定
	請求書 Invoice	各仕入先請求書を一意に識別するID。
説明「Invoice」は主要なケース識別子です。請求書を受領した時点から最終的な支払いまで、すべてのアクティビティを関連付けます。各請求書のエンドツーエンドの処理経路を再構築するために欠かせない属性です。分析では、個々の請求書のプロセスフローを絞り込み、集計し、詳細に調査できます。バリアント分析とサイクルタイム計算の基盤となります。重要な理由関連するすべてのイベントを1つのプロセスインスタンスに結び付ける基本属性です。各請求書のライフサイクルをエンドツーエンドで分析できます。入手先 NetSuiteの仕入先請求書取引レコードにおける主キーです。通常はTransaction IDまたはDocument Numberと呼ばれます。例 INV-2023-001237894561VN54321A
	開始時刻 EventTime	アクティビティまたはイベントが開始された時刻を示すタイムスタンプ。
説明特定のアクティビティが発生した正確な日時を記録する属性です。各ケース内におけるイベントの時系列を示します。アクティビティ間のサイクルタイム、プロセス全体の所要時間、遅延を計算するなど、時間に基づくすべての分析に欠かせません。イベントを正しい順序に並べるために使われ、「Average Invoice Approval Time」や「Days Payable Outstanding」などのパフォーマンスKPIの基盤となります。重要な理由イベントの時系列を示します。期間に基づくすべての指標の計算、ボトルネックの発見、プロセスパフォーマンスの把握に欠かせません。入手先 NetSuiteの取引レコードおよびSystem Notesにおける、ステータス変更または作成日・更新日に関連するタイムスタンプフィールド。例 2023-10-26T10:00:00Z2023-11-15T14:35:10Z2024-01-05T09:12:05Z
	ソースシステム SourceSystem	データを抽出したシステム。
説明プロセスデータの取得元を識別する属性です。このビューでは常に「NetSuite」になります。外部OCRシステムやERPなど複数のシステムが存在する環境では、データの系譜を確認し、問題を調査するうえで欠かせません。すべてのイベントが記録元のソースシステムに正しく帰属していることを確認できます。重要な理由データの出所を明確にします。複数システムの環境で、検証や背景確認のためにデータを取得元まで追跡するうえで重要です。入手先データの抽出・変換処理中に入力される固定値（「NetSuite」）。例 NetSuite
	最終データ更新 LastDataUpdate	このイベントのデータがソースシステムから最後に更新された時刻を示すタイムスタンプ。
説明イベントデータがNetSuiteから最後に抽出された時刻を示す属性です。プロセスマイニングツール内のデータの鮮度を表します。分析に利用できるデータがどの時点のものかを把握するうえで重要です。特に、請求書のステータスをほぼリアルタイムで追跡する業務用ダッシュボードでは、データがどの程度最新かを確認できます。重要な理由データの鮮度を明確にし、プロセス分析がどの時点の状況を示しているか、次回のデータ更新がいつ予定されているかを把握できます。入手先データ取り込み時に、データ抽出ツールまたはパイプラインによって生成されるタイムスタンプ。例 2024-03-10T02:00:00Z2024-03-11T02:00:00Z
	仕入先名 VendorName	請求書を提出した仕入先またはサプライヤーの名称。
説明請求書に関連付けられた仕入先の正式名称を識別する属性です。取引に紐付く重要なマスターデータです。仕入先別にプロセスを分析すると、頻繁な不一致、支払遅延、動的割引の機会など、仕入先固有の問題を特定できます。「請求書ステータスと経過日数」ダッシュボードで未決済請求書を分類し、関係を管理するうえでも欠かせません。重要な理由仕入先別のパフォーマンス分析を可能にし、問題のある仕入先の特定、より良い条件の交渉、関係の適切な管理に役立ちます。入手先仕入先請求書取引にリンクされた仕入先レコードから取得します。通常は「Vendor Name」または「Company Name」というフィールド名です。例 Global Office Supplies Inc.Tech Solutions LLCCreative Marketing Co.
	処理担当者 ProcessorUser	請求書の処理または入力を担当するユーザー。
説明請求書へのデータ入力や初期処理を行った買掛金チームの担当者を識別する属性です。「買掛金担当者の業務量分布」ダッシュボードに欠かせません。管理者は業務量の偏りを分析し、研修の必要性を特定して、個人またはチームのパフォーマンスを測定できます。担当者まで追跡することで、エラーの根本原因を調査することも可能です。重要な理由業務量の分析、パフォーマンスの監視、特定の買掛金担当者にアクティビティを紐付けたエラーの根本原因分析を可能にします。入手先仕入先請求書の初期段階のアクティビティについて、System Notesまたは監査証跡にある「Created By」または「Modified By」フィールドから取得します。例 j.doea.smithm.jones
	承認者 Approver	請求書の支払いを承認する担当ユーザー。
説明請求書の最終承認を行った管理者または予算責任者を識別する属性です。請求書のライフサイクルには複数の承認者が関与する場合があります。「承認ボトルネック分析」ダッシュボードにおける重要な分析軸です。承認者ごとの承認時間を分析することで、承認に時間がかかる担当者を特定し、業務量のバランスを取るために請求書のルートを変更して、承認プロセス全体を効率化できます。重要な理由承認ボトルネックの特定を直接支援し、承認経路に関与する管理者の業務量とパフォーマンスの分析に役立ちます。入手先通常、仕入先請求書取引に関連付けられたワークフロー履歴または承認ログに保存されています。例 s.chenp.williamsr.davis
	発注書番号 PurchaseOrderNumber	該当する場合に、請求書に関連付けられた発注書の識別子。
説明仕入先請求書を事前承認済みの発注書（PO）に関連付ける属性です。発注書の有無によって、POに基づく請求書とPOなしの請求書を区別できます。「POとGRの照合効率」ダッシュボードと「POとGRの照合成功率」KPIに欠かせません。請求書がPOに基づくかどうかでプロセスを分析すると、三者照合による効率化の効果や自動化の機会を特定できます。重要な理由 PO請求書とPOなし請求書を区別します。両者は異なる処理経路をたどることが多く、自動化の可能性も異なります。照合効率の分析に欠かせません。入手先通常は仕入先請求書レコードの明細またはヘッダーにあり、発注書取引にリンクされています。例 PO-004589PO-005123null
	請求書支払期日 InvoiceDueDate	ペナルティを避けるために請求書を支払うべき日付。
説明仕入先の支払条件と請求書の日付に基づいて決まる支払期日を示す属性です。買掛金プロセスにおける重要な期限です。「支払コンプライアンスダッシュボード」と「支払条件遵守率」KPIの基準日となります。支払いが期限内、期限前、期限後のいずれであるかを判定し、仕入先との関係や支払遅延損害金に直接影響します。重要な理由期限内支払のパフォーマンスを測定する主要な基準です。仕入先との関係と財務上のコンプライアンスに欠かせません。入手先仕入先請求書取引レコードの標準的な「Due Date」フィールド。例 2023-11-302023-12-152024-02-28
	請求書金額 InvoiceAmount	請求書の合計金額。
説明控除や割引を適用する前の、仕入先請求書に対する支払総額を示す属性です。各ケースにおける基本的な財務指標です。請求書金額は、高額請求書と低額請求書など金額帯に分けて処理経路の違いを確認する財務分析に使います。また、ボトルネックや遅延による財務的な影響をダッシュボードで把握する際にも使われ、DPOの計算にも欠かせません。重要な理由プロセスの非効率による財務的な影響を分析し、金額に応じて請求書を分類して高額項目を優先できます。入手先仕入先請求書取引レコードのヘッダーにある「Amount」または「Total」フィールド。例 1500.75250.0012500.50
	会社コード CompanyCode	請求書を処理する法人または子会社の識別子。
説明請求書の支払義務を負う組織内の会社または子会社を示す属性です。複数の法人を持つ企業では特に重要です。会社コード別にプロセスを分析すると、事業の異なる部分を比較できます。子会社ごとに異なる効率、コンプライアンス、業務量の差を明らかにし、対象を絞った改善施策につなげられます。重要な理由異なる法人や子会社間でプロセスパフォーマンスを比較できます。対象を絞った改善と、企業ガバナンスの確保に役立ちます。入手先 NetSuiteでは、OneWorldアカウントの取引レコードにある「Subsidiary」フィールドに該当します。例 US01DE01UK01
	割引適用期限 EarlyPaymentDiscountDate	早期支払割引の対象となるために、請求書の支払いを完了すべき期限です。
説明この属性は、「Payment Terms」で定義された仕入先割引の適用対象となる最終支払日を指定します（例：「2% 10, Net 30」の「10」）。この日付は、「Early Payment Discount Opportunities」ダッシュボードの主要な判定基準です。この日付を現在日および支払日と比較することで、システムは早期支払割引の機会を特定し、「Early Payment Discount Capture Rate」KPIを測定できます。これにより、企業はコスト削減を最大化できます。重要な理由早期支払割引によるコスト削減を最大化するうえで重要な日付です。この日付を追跡することで、資金管理を最適化できます。入手先 Vendor Billレコード上の計算フィールドで、請求書日付と「Terms」フィールドから算出されます。例 2023-11-102024-01-20null
	手戻りかどうか IsRework	アクティビティが手戻りループの一部かどうかを示すフラグです。
説明この計算済みの真偽値属性は、2回目の「Discrepancy Identified」イベントや、請求書が却下された後に承認申請へ再提出されるケースなど、作業の繰り返しを示すアクティビティを特定します。この属性は、「Rework and Error Analysis」ダッシュボードと「Invoice Rework Rate」KPIに欠かせません。手戻りの頻度と影響を定量化し、非効率、エラー、プロセス逸脱の発生源を特定できます。重要な理由無駄な作業を示すアクティビティにフラグを付けることで、プロセスの非効率を定量化できます。品質と初回正解率の向上に向けた施策を、対象を絞って実施できます。入手先特定のケースにおけるアクティビティの順序を分析し、データ変換時に計算します。たとえば、「Invoice Approved」の後に「Invoice Rejected」が続き、その後に再び「Invoice Approved」が発生する場合です。例 truefalse
	支払日 PaymentDate	請求書の支払いが実行された日付です。
説明この属性には、仕入先への現金支払いが実行された日付が記録されます。請求書に関する最終的な財務決済を示します。この日付は、「Days Payable Outstanding」や「Payment Term Adherence Rate」など、多くのKPIでプロセスの実際の終了日を判定するために使われます。「Invoice Due Date」および「Early Payment Discount Date」と比較する基準となる、実際に発生したイベントです。重要な理由プロセスの財務上の完了を示し、支払コンプライアンス、DPO、割引取得に関するKPIの計算基準となります。入手先 NetSuiteで関連付けられたBill Payment取引レコードの「Date」フィールドから取得します。例 2023-11-282023-12-142024-02-25
	支払条件 PaymentTerms	請求書の支払いについて合意された条件（例：Net 30、2% 10 Net 30）。
説明支払期限や早期支払時の割引など、仕入先が支払いに求める条件を定義する属性です。支払条件は「請求書支払期日」や「早期支払割引日」の計算に使います。「支払コンプライアンスダッシュボード」や、早期支払割引を受ける機会の分析に欠かせず、運転資本の最適化にも役立ちます。重要な理由支払期限と割引の機会を決定し、キャッシュフロー管理とコスト削減に直接影響します。入手先仕入先請求書取引の「Terms」フィールド。通常は仕入先マスターレコードから引き継がれます。例 30日後払い60日後払い10日以内2％割引、30日後払い
	文書タイプ DocumentType	処理対象となる文書の種類です（例：Invoice、Credit Memo）。
説明この属性により、標準的な請求書と、異なる処理ルールやワークフローに従うCredit Memoなどの関連文書を区別できます。文書タイプ別にプロセスを分析すると、同じ種類の項目を比較できます。たとえば、高額な請求書の承認プロセスは、小額のCredit Memoよりも厳格になる場合があります。この分類により、プロセスのパフォンスをより正確に把握できます。重要な理由異なる経路やKPIを持つ財務文書の種類ごとにプロセスを分類できます。これにより、より正確な分析が可能になります。入手先 NetSuiteの取引タイプから特定できます（例：「Vendor Bill」、「Vendor Credit」）。例標準請求書貸方メモ借方メモ
	早期支払割引を取得したかどうか IsEarlyPaymentCaptured	利用可能な早期支払割引を実際に取得できたかどうかを示すフラグです。
説明この計算済みの真偽値属性は、割引が利用可能な請求書について、「Early Payment Discount Date」までに支払われたかどうかを判定します。この属性は、「Early Payment Discount Capture Rate」KPIの測定と、「Early Payment Discount Opportunities」ダッシュボードに欠かせません。割引取得施策の成否を明確に示し、取り逃した削減機会を明らかにします。重要な理由コスト削減の取得における財務部門または買掛金管理部門の有効性を直接測定する、重要な財務パフォーマンス指標です。入手先データ変換時に計算します：割引が利用可能な請求書について、PaymentDate <= EarlyPaymentDiscountDate。例 truefalsenull
	期限内支払かどうか IsOnTimePayment	請求書が支払期限日までに支払われたかどうかを示すフラグです。
説明この計算済みの真偽値属性は、「Payment Date」が「Invoice Due Date」以前かどうかを判定します。請求書ごとの支払期限遵守状況を、明確な二値で示します。この属性は「Payment Compliance Dashboard」を直接支え、「Payment Term Adherence Rate」KPIの計算に使われます。すべての遅延支払いをすぐに絞り込み、根本原因を調査できるため、分析を簡単にします。重要な理由支払期限の遵守状況を簡単に分析でき、支払条件の遵守や仕入先との関係管理に関するKPIに直接役立ちます。入手先データ変換時に計算します：PaymentDate <= InvoiceDueDate。例 truefalse
	請求書ステータス InvoiceStatus	請求書の現在の処理ステータス。
説明買掛金ライフサイクルにおける仕入先請求書の現在の状態を示す属性です。例として「Open」、「Pending Approval」、「Paid in Full」などがあります。「請求書ステータスと経過日数」ダッシュボードにおける重要な属性であり、現在の業務量と負債の状況を把握できます。未処理または問題のある請求書に絞り込んだり、完了までの進捗を追跡したりできます。重要な理由請求書がプロセスのどの段階にあるかをリアルタイムで把握できます。業務の監視、業務量の管理、財務予測に欠かせません。入手先仕入先請求書取引レコードの「Status」フィールド。例未処理承認待ち全額支払済み
	通貨 Currency	請求書金額の通貨コード（例：USD、EUR）。
説明請求書の金額がどの通貨で表示されているかを示す属性です。「InvoiceAmount」を解釈するために必要な情報です。多国籍組織では、データを単一の一貫した通貨で分析することが重要です。このフィールドにより、適切な通貨換算が可能になり、地域や事業部門をまたいで財務指標を同じ基準で比較できます。重要な理由すべての金額に必要な背景情報を提供し、特に多国籍事業における正確な財務分析を可能にします。入手先仕入先請求書取引レコードの「Currency」フィールド。通常は仕入先のマスターデータにリンクされています。例 USDEURGBPCAD

必須推奨任意

買掛金請求書処理のアクティビティ

正確なプロセス発見とボトルネック特定のため、イベントログに記録すべき主要なプロセス手順と重要な節目です。

6 推奨 8 任意

	アクティビティ	説明
	仕入先請求書の作成	新しい仕入先請求書がNetSuiteに登録されたことを示します。仕入先請求書取引レコードの作成日から取得し、買掛金プロセスの正式な開始点を表します。
重要な理由すべての請求書処理のサイクルタイム計算における開始点となります。プロセス全体の効率や請求書の経過日数を測定するうえで欠かせません。入手先仕入先請求書取引レコードの「Date Created」フィールド。取得仕入先請求書の取引作成イベント。イベントタイプ explicit
	承認申請	仕入先請求書が正式に承認ワークフローへ登録された時点を示します。請求書の「Approval Status」が下書き状態から「Pending Approval」に変更された時点で取得します。
重要な理由承認サイクルタイムの測定開始点です。特定の承認者や部門におけるボトルネックの特定に欠かせません。入手先 System Notesで追跡される、仕入先請求書レコードの「Approval Status」が「Pending Approval」に変更された時刻から推定します。取得「Approval Status」フィールドが「Pending Approval」に変更された時刻。イベントタイプ inferred
	支払いの実行	請求書の支払いが最終的に実行されたことを示します。仕入先請求書に適用された仕入先支払レコードの取引日から取得します。
重要な理由買掛金プロセスの主な終点です。エンドツーエンドのサイクルタイム、支払条件の遵守状況、買掛金回転日数（DPO）の計算に欠かせません。入手先仕入先請求書にリンクされた仕入先支払取引レコードの「Date」フィールド。取得請求書に適用された仕入先支払レコードの取引日。イベントタイプ explicit
	請求書のクローズ	通常、全額支払い後に仕入先請求書レコードが最終的にクローズされたことを示します。仕入先請求書のステータスが「Paid in Full」に変更された時点から推定します。
重要な理由プロセスライフサイクルの明確な終了イベントとなり、その請求書について追加の対応が不要になったことを確認できます。入手先 System Notesで追跡される、仕入先請求書レコードの「Status」フィールドが「Paid in Full」に変更された時刻から推定します。取得「Status」フィールドが「Paid in Full」に変更された時刻。イベントタイプ inferred
	請求書の承認	指定された承認者が仕入先請求書の支払いを承認したことを示します。請求書の「Approval Status」が「Approved」に設定された時点で取得します。
重要な理由承認段階を完了し、請求書の計上と支払予定の設定を可能にする重要な節目です。承認効率を測定するための重要なデータポイントでもあります。入手先 System Notesまたはワークフローログに記録された、仕入先請求書レコードの「Approval Status」が「Approved」に変更された時刻。取得「Approval Status」＝「Approved」となったワークフローログまたはSystem Notesの時刻。イベントタイプ explicit
	請求書の総勘定元帳への計上	仕入先請求書の財務上の影響が総勘定元帳に正式に記録された時点を示します。請求書が承認され、「Posting」フラグが設定された際の取引日から取得します。
重要な理由財務上の重要な統制ポイントです。会社が負債を正式に認識したことを確認できます。計上の遅延は財務報告の正確性に影響する可能性があります。入手先仕入先請求書から作成された総勘定元帳取引に設定された計上日。「Posting」フィールドを確認します。取得仕入先請求書に関連する総勘定元帳計上の取引日。イベントタイプ explicit
	PO照合の試行	検証のため、仕入先請求書と対応する発注書を関連付ける操作を示します。承認前に、仕入先請求書レコードの「Items」または「Expenses」サブリストに発注書が初めてリンクされた時点から推定します。
重要な理由このステップを追跡すると、請求書が承認に回される前の照合プロセスの効率を分析し、遅延を特定できます。入手先 System Notesログに記録された「Created From」フィールドの初回入力、または仕入先請求書の明細レベルにおける発注書参照から推定します。取得 System NotesでPO参照フィールドの入力を検出。イベントタイプ inferred
	クレジットメモの適用	仕入先クレジットが仕入先請求書に適用され、支払額が減額されたときに発生します。2つの取引を関連付ける適用イベントから取得します。
重要な理由クレジットメモの適用は、請求書をクローズする別経路として重要です。追跡することで、償却や返品が買掛金プロセス全体に与える影響を把握できます。入手先仕入先クレジット取引が仕入先請求書に適用された際に記録される適用日。請求書の関連レコードで確認できます。取得仕入先クレジットが仕入先請求書に適用された時刻。イベントタイプ explicit
	不一致の特定	請求書、発注書、または入庫記録の間に不一致が見つかり、処理を続行できなくなったときに発生します。通常は、ユーザーが「Approval Status」を「On Hold」や「Pending Clarification」などに変更したことから推定します。
重要な理由このアクティビティを可視化すると、検証プロセスにおける摩擦や手戻りの原因を特定できます。これらは支払い遅延の主な原因です。入手先仕入先請求書の「Approval Status」フィールドが、標準外の保留状態（例：「On Hold」）に変更されたことから推定します。カスタムステータスの設定が必要になる場合があります。取得保留または照会を示す「Approval Status」フィールドの変更を追跡。イベントタイプ inferred
	承認のための請求書再ルーティング	変更や却下により、請求書が前の段階または別の承認者へ戻されたときに発生します。「Approval Status」が「Pending Approval」から別の状態に戻り、その後再び「Pending Approval」になった場合に推定します。
重要な理由再ルーティングのイベントを特定すると、承認プロセス内の手戻りループを把握できます。手戻りループはサイクルタイムを大幅に延ばす原因です。入手先同じ請求書について、「Approval Status」が複数回「Pending Approval」に変更された一連の記録をSystem Notesから検出して推定します。取得 System Notesにおける「Approval Status」変更の順序を分析。イベントタイプ inferred
	支払予定の設定	仕入先請求書が支払対象として選択され、支払バッチに含まれたことを示します。将来の支払日を設定した仕入先支払取引が作成された時点で取得します。
重要な理由支払処理の状況を可視化し、キャッシュフローの予測や、早期支払割引を受けるための支払時期の管理に役立ちます。入手先仕入先請求書に適用された仕入先支払取引レコードの作成日。取得関連する仕入先支払取引レコードの作成時刻。イベントタイプ explicit
	支払遅延の特定	請求書が支払期日を過ぎて支払われた場合に発生する計算イベントです。支払実行日と仕入先請求書に指定された支払期日を比較して判定します。
重要な理由支払いに関するコンプライアンスとサプライヤーとの関係を管理するうえで重要なアクティビティです。支払遅延が頻発すると、取引先からの信頼を損なう可能性があります。入手先仕入先支払の「Date」と仕入先請求書レコードの「Due Date」を比較して算出します。支払日が支払期日より後の場合、このイベントが発生します。取得仕入先支払の「Date」と仕入先請求書の「Due Date」を比較。イベントタイプ calculated
	早期支払の実施	請求書の支払いが早期支払割引の期限より前に実行された場合に発生する計算イベントです。支払日と仕入先請求書の支払条件を比較して算出します。
重要な理由買掛金チームが割引を獲得できた成果を直接測定します。会社の収益性とキャッシュマネジメント戦略に直接影響します。入手先計算イベントです。仕入先支払取引の「Date」と、仕入先請求書の「Terms」フィールドから算出した割引日を比較する必要があります。取得仕入先支払の「Date」と、仕入先請求書の「Terms」から算出した割引日を比較。イベントタイプ calculated
	請求書の却下	承認プロセス中に仕入先請求書が正式に却下され、修正と再申請が必要になったことを示します。「Approval Status」が「Rejected」に更新された時点で取得します。
重要な理由却下を追跡すると、手戻りを分析し、失敗のよくある理由（例：不正な勘定科目コード、ポリシー違反）を特定できます。初回承認率の向上にも役立ちます。入手先 System Notesに記録された、仕入先請求書レコードの「Approval Status」が「Rejected」に変更された時刻。取得「Approval Status」＝「Rejected」となったワークフローログまたはSystem Notesの時刻。イベントタイプ explicit

推奨任意

抽出ガイド

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

ステップ

Saved Searchの作成画面へ移動：Saved Searchの作成・編集権限を持つロールでNetSuiteにログインします。Reports > Saved Searches > All Saved Searches > Newの順に移動します。検索タイプの一覧からTransactionを選択します。
検索条件を定義：Criteriaタブで、対象の請求書（Vendor Bills）を抽出するための主なフィルターを設定します。
- Typeをis Vendor Billに設定します。
- Main Lineをis Trueに設定します。これにより、ヘッダーレベルの情報に絞り込めます。
- Date Createdフィルターを追加し、データ抽出期間を指定します（例：is within last 6 months）。
共通属性の結果列を定義：Resultsタブに移動します。請求書のすべてのイベントに共通する次のフィールドを追加します。
- Document Number（Custom Label：Invoice）
- Entity（Custom Label：VendorName）
- Amount（Custom Label：InvoiceAmount）
- Due Date（Custom Label：InvoiceDueDate）
- Created By（Custom Label：ProcessorUser）
- Formula（Text）：数式を'{source}'に設定します（Custom Label：SourceSystem）。この列には'NetSuite'が入力されます。
- Formula（Date/Time）：数式を{today}に設定します（Custom Label：LastDataUpdate）。
アクティビティの結果列を定義：ここが最も重要な手順です。14個のアクティビティそれぞれについて、ActivityName用とEventTime用の数式列を2つ追加します。これにより横持ちのデータセットが作成されるため、後で変換が必要です。
- 「Invoice Approved」の例：
  - Formula（Text）を追加し、値にCASE WHEN {approvalstatus} = 'Approved' THEN 'Invoice Approved' ELSE NULL ENDを設定します。ActivityName_Approvedなどのカスタムラベルを設定します。
  - Formula（Date/Time）を追加し、値にCASE WHEN {approvalstatus} = 'Approved' THEN {systemnotes.date} WHERE systemnotes.field = 'Approval Status' and systemnotes.newvalue = 'Approved' ELSE NULL ENDを設定します。EventTime_Approvedなどのカスタムラベルを設定します。注：ステータス変更の正確なタイムスタンプを取得するには、通常、system notesを詳しく確認する必要があり、複雑になる場合があります。利用できる場合は、専用の{approveddate}フィールドを使うと、精度は下がりますが簡単に取得できます。
- 以下のクエリセクションに示すロジックを使い、必要な14個すべてのアクティビティについてこの手順を繰り返します。
検索設定を構成：Audienceサブタブで、検索を実行してエクスポートする適切なロールまたはユーザーがアクセスできることを確認します。検索にはProcessMind AP Extractionなど、内容が分かる名前を付けます。
検索を保存して実行：Save & Runをクリックして検索を実行します。NetSuiteのUIで結果を確認し、横持ち形式で想定どおりデータが表示されていることを確認します。
データをCSVにエクスポート：検索結果ページでExportアイコン（CSV、Excel、PDF）をクリックし、CSVを選択します。
データを変換（Unpivot）：エクスポートしたCSVには、請求書1件につき1行と、アクティビティおよびタイムスタンプ用の多数の列が含まれます（例：ActivityName_Created、EventTime_Created、ActivityName_Approved、EventTime_Approved）。この「横持ち」形式を「縦持ち」のイベントログに変換する必要があります。
- Microsoft Excel（Power Query）、Python（Pandas）、または別のデータ加工ツールでCSVを開きます。
- 「Unpivot」機能を使います。共通属性の列（Invoice、VendorNameなど）をすべて選択し、ActivityName_...およびEventTime_...の列をUnpivotします。
- この変換により、アクティビティ1件につき1行の、必要なイベントログ構造が作成されます。
最終ファイルを整理して整形：Unpivot後は、属性と値を表す列が作成されます。これらの列名をActivityNameとEventTimeに変更します。ActivityNameまたはEventTimeがNULLの行を除外します。最終的な列見出しがProcessMindのスキーマ（Invoice、ActivityName、EventTimeなど）と一致していることを確認します。
最終イベントログを保存：変換したデータを新しいCSVファイルとして保存します。これでProcessMindにアップロードできる状態になります。

設定

前提条件：Saved Searchの作成またはFullレベルの権限を持つユーザーロールが必要です。また、取引レコード（特にVendor Bills、Vendor Payments、Vendor Credits）と関連するエンティティレコード（Vendor、Employee）への閲覧権限も必要です。
検索タイプ：このプロセスでは、必ずTransaction検索タイプから始めます。
日付範囲のフィルタリング：データセットのサイズを制限するため、日付範囲フィルター（例：Date Created）を適用することが重要です。まず3～6か月などの短い範囲で検索性能と結果を検証してから、より長い過去期間を対象に実行します。
Main Lineフィルター：通常はCriteria > Main Line > is Trueを使い、取引ごとに1件の結果を取得することを推奨します。ただし、「PO Matching Attempted」など明細行レベルで発生するアクティビティでは、このフィルターを使わない別の検索、またはより複雑な式が必要になる場合があります。
カスタムフィールド：NetSuiteの環境では、買掛金プロセスの管理にカスタムフィールドを使っている場合があります（例：標準のApproval Statusの代わりにカスタムのAP Process Statusフィールドを使用）。これらのフィールドを特定し、検索条件と結果の式で置き換える必要があります。
性能に関する考慮事項：14個すべてのアクティビティを式で処理する単一のSaved Searchは、NetSuiteで遅延したりタイムアウトしたりする場合があります。複数のSaved Search（例：Billの作成・承認用と支払用）に分け、アンピボットの前にエクスポートしたファイルを結合する方法を検討してください。

a サンプルクエリ json

# NetSuite Saved Search Configuration for Accounts Payable Event Log Extraction
# This configuration describes the settings for a single, comprehensive Saved Search.
# The output is a 'wide' file that must be unpivoted into an event log.

SearchType: "Transaction"

# ====================================================================
# CRITERIA
# ====================================================================
# Define the filters to select the base records
# --------------------------------------------------------------------

Filters: [
  {
    "field": "Type",
    "operator": "is",
    "value": "Vendor Bill"
  },
  {
    "field": "Main Line",
    "operator": "is",
    "value": "True"
  },
  {
    "field": "Date Created",
    "operator": "within",
    "value": "[Specify Date Range, e.g., thisfiscalquarter]"
  }
]

# ====================================================================
# RESULTS
# ====================================================================
# Define the columns for the output. The final CSV will have these columns.
# Common attributes are listed first, followed by pairs of columns for each activity.
# --------------------------------------------------------------------

Columns: [
  // --- Common Attributes ---
  { "field": "Document Number", "label": "Invoice" },
  { "field": "Entity", "label": "VendorName" },
  { "field": "Amount", "label": "InvoiceAmount" },
  { "field": "Applied To Transaction", "label": "PurchaseOrderNumber" },
  { "field": "Created By", "label": "ProcessorUser" },
  { "field": "Next Approver", "label": "Approver" },
  { "field": "Due Date", "label": "InvoiceDueDate" },
  { "formula": "'NetSuite'", "type": "Text", "label": "SourceSystem" },
  { "formula": "{today}", "type": "Date/Time", "label": "LastDataUpdate" },

  // --- Activity 1: Vendor Bill Created ---
  { "formula": "'Vendor Bill Created'", "type": "Text", "label": "ActivityName_Created" },
  { "field": "Date Created", "label": "EventTime_Created" },

  // --- Activity 2: PO Matching Attempted ---
  { "formula": "CASE WHEN {appliedtotransaction} IS NOT NULL THEN 'PO Matching Attempted' ELSE NULL END", "type": "Text", "label": "ActivityName_POMatched" },
  { "formula": "CASE WHEN {appliedtotransaction} IS NOT NULL THEN {datecreated} ELSE NULL END", "type": "Date/Time", "label": "EventTime_POMatched" },

  // --- Activity 3: Discrepancy Identified ---
  { "formula": "CASE WHEN {approvalstatus} = 'Rejected' THEN 'Discrepancy Identified' ELSE NULL END", "type": "Text", "label": "ActivityName_Discrepancy" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Rejected')", "type": "Date/Time", "label": "EventTime_Discrepancy" },

  // --- Activity 4: Approval Submitted ---
  { "formula": "CASE WHEN {approvalstatus} != 'Pending Approval' AND {approvalstatus} != 'Approved' THEN NULL ELSE 'Approval Submitted' END", "type": "Text", "label": "ActivityName_Submitted" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval')", "type": "Date/Time", "label": "EventTime_Submitted" },

  // --- Activity 5: Invoice Re-Routed For Approval ---
  { "formula": "CASE WHEN (SELECT COUNT(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval') > 1 THEN 'Invoice Re-Routed For Approval' ELSE NULL END", "type": "Text", "label": "ActivityName_ReRouted" },
  { "formula": "(SELECT MAX(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval' AND systemnotes.date < (SELECT MAX(sub_notes.date) FROM systemnote sub_notes WHERE sub_notes.recordid = {internalid} AND sub_notes.field = 'TRANSACTION.APPROVALSTATUS' AND sub_notes.newvalue = 'Pending Approval'))", "type": "Date/Time", "label": "EventTime_ReRouted" },

  // --- Activity 6: Invoice Approved ---
  { "formula": "CASE WHEN {approvalstatus} = 'Approved' THEN 'Invoice Approved' ELSE NULL END", "type": "Text", "label": "ActivityName_Approved" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Approved')", "type": "Date/Time", "label": "EventTime_Approved" },

  // --- Activity 7: Invoice Rejected ---
  { "formula": "CASE WHEN {approvalstatus} = 'Rejected' THEN 'Invoice Rejected' ELSE NULL END", "type": "Text", "label": "ActivityName_Rejected" },
  { "formula": "(SELECT MAX(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Rejected')", "type": "Date/Time", "label": "EventTime_Rejected" },

  // --- Activity 8: Invoice Posted To GL ---
  { "formula": "CASE WHEN {posting} = 'Yes' THEN 'Invoice Posted To GL' ELSE NULL END", "type": "Text", "label": "ActivityName_Posted" },
  { "field": "Date", "label": "EventTime_Posted" },

  // --- Activity 9: Payment Scheduled ---
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Payment' AND {payingtransaction.trandate} > {today} THEN 'Payment Scheduled' ELSE NULL END", "type": "Text", "label": "ActivityName_Scheduled" },
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Payment' AND {payingtransaction.trandate} > {today} THEN {payingtransaction.datecreated} ELSE NULL END", "type": "Date/Time", "label": "EventTime_Scheduled" },

  // --- Activity 10: Payment Executed ---
  { "formula": "CASE WHEN {status} = 'Paid in Full' OR {status} = 'Pending Approval' THEN 'Payment Executed' ELSE NULL END", "type": "Text", "label": "ActivityName_Executed" },
  { "field": "Paying Transaction Date", "label": "EventTime_Executed" },

  // --- Activity 11: Invoice Closed ---
  { "formula": "CASE WHEN {status} = 'Paid in Full' THEN 'Invoice Closed' ELSE NULL END", "type": "Text", "label": "ActivityName_Closed" },
  { "field": "Paying Transaction Date", "label": "EventTime_Closed" },

  // --- Activity 12: Early Payment Captured ---
  { "formula": "CASE WHEN {payingtransaction.trandate} < {discountdate} AND {discountamount} IS NOT NULL THEN 'Early Payment Captured' ELSE NULL END", "type": "Text", "label": "ActivityName_EarlyPay" },
  { "formula": "CASE WHEN {payingtransaction.trandate} < {discountdate} AND {discountamount} IS NOT NULL THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_EarlyPay" },

  // --- Activity 13: Late Payment Identified ---
  { "formula": "CASE WHEN {daysoverdue} > 0 AND {status} = 'Paid in Full' THEN 'Late Payment Identified' ELSE NULL END", "type": "Text", "label": "ActivityName_LatePay" },
  { "formula": "CASE WHEN {daysoverdue} > 0 AND {status} = 'Paid in Full' THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_LatePay" },

  // --- Activity 14: Credit Memo Applied ---
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Credit' THEN 'Credit Memo Applied' ELSE NULL END", "type": "Text", "label": "ActivityName_CreditMemo" },
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Credit' THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_CreditMemo" }
]

ステップ

前提条件：NetSuiteアカウントでSuiteAnalytics Connectモジュールが有効になっていることを確認します。「SuiteAnalytics Connect」権限と、必要なレコード（Vendor Bills、Vendor Payments、Purchase Orders、System Notes）へのアクセス権を持つユーザーロールが必要です。
ドライバーのインストールと設定：NetSuiteの画面で、Home > Set Preferences > Analytics Driverから、使用するOSに対応したNetSuite ODBC（またはJDBC）ドライバーをダウンロードします。インストール手順に従って設定し、NetSuiteサービスを指す新しいデータソース名（DSN）を構成します。
接続の確立：使用するSQLクライアント（例：DBeaver、Power BI、Tableau）を開きます。設定したドライバーまたはDSNを使って新しい接続を作成します。認証にはNetSuite Account ID、Role ID、ユーザー認証情報が必要です。
クエリの準備：下記の「query」セクションに記載された完全なSuiteQLクエリを、SQLクライアントのクエリエディターにコピーします。
プレースホルダーのカスタマイズ：クエリのWHERE句にあるプレースホルダー値を変更します。最低限、分析期間を定義するために[START_DATE]と[END_DATE]を設定してください。NetSuite OneWorldアカウントを使用している場合は、[SUBSIDIARY_ID]も調整します。
カスタムロジックへの対応：-- CUSTOMIZABLEなどのコメントが付いた箇所を確認します。これらのクエリ部分では、特定のステータス値に基づいて「Discrepancy Identified」などのアクティビティを推定しています。組織固有のNetSuite設定と業務プロセスに合わせて、値を更新する必要があります。
クエリの実行：カスタマイズしたクエリをNetSuiteデータベースに対して実行します。日付範囲とデータ量によっては、完了まで数分かかる場合があります。
結果のエクスポート：クエリが完了したら、SQLクライアントから結果セットをCSVファイルにエクスポートします。
アップロード用の仕上げ：エクスポートしたCSVファイルがUTF-8でエンコードされていることを確認します。列見出しがProcessMindで必要または推奨される属性（例：Invoice、ActivityName、EventTime）と一致していることを確認します。これでファイルをアップロードできます。

設定

SuiteAnalytics Connect：この抽出方法を使うには、NetSuiteの追加モジュールであるSuiteAnalytics Connectが必要です。NetSuiteデータの複製に対する読み取り専用アクセスを提供します。
ユーザーロールの権限：接続に使うNetSuiteロールでは、「SuiteAnalytics Connect」権限を有効にする必要があります。また、次のレコードへの閲覧権限も必要です：取引（Vendor Bill、Vendor Payment、Vendor Credit）、エンティティ（Vendor、Employee）、System Notes。
日付範囲のフィルタリング：実行時間を管理可能な範囲に収めるため、特定の日付範囲（例：trandate BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'）でクエリを絞り込むことが重要です。完全な抽出を実行する前に、3～6か月などの短い範囲から始めてください。
Subsidiaryによるフィルタリング：NetSuite OneWorldアカウントでは、特定の法人のデータに限定し、クエリ性能を高めるため、必ずWHERE句にSubsidiary IDの条件を含めます。
カスタム承認ワークフロー：提供されているクエリは、Vendor Billsの標準「Approval Status」フィールドを使う前提です。組織で承認にカスタムSuiteFlowやスクリプト、カスタムフィールドまたはレコードを使っている場合、SystemNoteのapprovalstatusフィールドを参照するクエリ部分を大幅に変更する必要があります。

a サンプルクエリ sql

-- This query extracts an event log for the Accounts Payable Invoice Processing from NetSuite.
-- It uses a UNION ALL approach to gather 14 distinct activities into a single file.

WITH VendorBillsInScope AS (
    -- CTE to select the primary Vendor Bills to analyze.
    -- Filtering here is critical for performance.
    SELECT
        Transaction.ID AS BillID,
        Transaction.tranid AS Invoice,
        Transaction.trandate AS BillDate,
        Transaction.duedate AS InvoiceDueDate,
        Transaction.foreignTotal AS InvoiceAmount,
        Transaction.entity AS VendorID,
        Transaction.createdBy AS ProcessorUserID,
        Transaction.status AS BillStatus,
        Transaction.approvalStatus AS ApprovalStatus,
        Transaction.discountDate AS DiscountDate
    FROM
        Transaction
    WHERE
        Transaction.type = 'VendBill'
        -- CRITICAL: Define the date range for the extraction
        AND Transaction.trandate BETWEEN TO_DATE('[START_DATE]', 'YYYY-MM-DD') AND TO_DATE('[END_DATE]', 'YYYY-MM-DD')
        -- OPTIONAL: Filter by a specific subsidiary for NetSuite OneWorld accounts
        -- AND Transaction.subsidiary = [SUBSIDIARY_ID]
),

-- Base information for joins, including vendor, processor, and PO data.
BaseInfo AS (
    SELECT
        vb.BillID,
        vb.Invoice,
        vb.InvoiceAmount,
        vb.InvoiceDueDate,
        vb.DiscountDate,
        vendor.companyName AS VendorName,
        processor.entityId AS ProcessorUser,
        LISTAGG(DISTINCT po.tranid, ', ') WITHIN GROUP (ORDER BY po.tranid) AS PurchaseOrderNumber
    FROM
        VendorBillsInScope vb
    LEFT JOIN
        Entity vendor ON vb.VendorID = vendor.ID
    LEFT JOIN
        Employee processor ON vb.ProcessorUserID = processor.ID
    LEFT JOIN
        TransactionLine tl ON vb.BillID = tl.Transaction
    LEFT JOIN
        Transaction po ON tl.purchaseOrder = po.ID AND po.type = 'PurchOrd'
    GROUP BY
        vb.BillID, vb.Invoice, vb.InvoiceAmount, vb.InvoiceDueDate, vb.DiscountDate, vendor.companyName, processor.entityId
),

-- System Notes are used to track status changes for approvals, rejections, etc.
Notes AS (
    SELECT
        sn.transactionId AS BillID,
        sn.date AS NoteDate,
        sn.field AS NoteField,
        sn.newValue AS NoteNewValue,
        sn.oldValue AS NoteOldValue,
        approver.entityId AS Approver
    FROM
        SystemNote sn
    JOIN
        VendorBillsInScope vb ON sn.transactionId = vb.BillID
    LEFT JOIN
        Employee approver ON sn.author = approver.ID
    WHERE
        -- Filtering to relevant fields improves performance
        sn.field IN ('approvalstatus', 'status')
)

-- 1. Vendor Bill Created
SELECT
    bi.Invoice AS "Invoice",
    'Vendor Bill Created' AS "ActivityName",
    vb.BillDate AS "EventTime",
    'NetSuite' AS "SourceSystem",
    BUILTIN.CURRRENT_TIMESTAMP() AS "LastDataUpdate",
    bi.VendorName AS "VendorName",
    bi.InvoiceAmount AS "InvoiceAmount",
    bi.PurchaseOrderNumber AS "PurchaseOrderNumber",
    bi.ProcessorUser AS "ProcessorUser",
    NULL AS "Approver",
    bi.InvoiceDueDate AS "InvoiceDueDate"
FROM
    VendorBillsInScope vb
JOIN
    BaseInfo bi ON vb.BillID = bi.BillID

UNION ALL

-- 2. PO Matching Attempted (Inferred from PO link on creation date)
SELECT
    bi.Invoice,
    'PO Matching Attempted',
    vb.BillDate, -- Occurs at the same time as creation
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL,
    bi.InvoiceDueDate
FROM
    VendorBillsInScope vb
JOIN
    BaseInfo bi ON vb.BillID = bi.BillID
WHERE
    bi.PurchaseOrderNumber IS NOT NULL

UNION ALL

-- 3. Discrepancy Identified (CUSTOMIZABLE: Inferred from status change to 'On Hold')
SELECT
    bi.Invoice,
    'Discrepancy Identified',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver, -- User who placed it on hold
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' 
    -- CUSTOMIZABLE: Update 'On Hold' to match the status your company uses for discrepancies.
    AND n.NoteNewValue = 'On Hold'

UNION ALL

-- 4. Approval Submitted
SELECT
    bi.Invoice,
    'Approval Submitted',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver, -- User who submitted for approval
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Pending Approval'

UNION ALL

-- 5. Invoice Re-Routed For Approval (Inferred by status returning to Pending Approval)
SELECT
    bi.Invoice,
    'Invoice Re-Routed For Approval',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' 
    AND n.NoteNewValue = 'Pending Approval'
    AND n.NoteOldValue IN ('Rejected', 'On Hold') -- Capture re-submission after rejection/hold

UNION ALL

-- 6. Invoice Approved
SELECT
    bi.Invoice,
    'Invoice Approved',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Approved'

UNION ALL

-- 7. Invoice Rejected
SELECT
    bi.Invoice,
    'Invoice Rejected',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Rejected'

UNION ALL

-- 8. Invoice Posted To GL (Happens upon approval)
SELECT
    bi.Invoice,
    'Invoice Posted To GL',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Approved'

UNION ALL

-- 9. Payment Scheduled & 10. Payment Executed & 12. Early & 13. Late Payments
WITH Payments AS (
    SELECT
        tp.previousDoc AS BillID,
        vp.trandate AS PaymentExecutionDate,
        vp.createdDate AS PaymentScheduledDate
    FROM
        TransactionPayment tp
    JOIN
        Transaction vp ON tp.nextDoc = vp.ID AND vp.type = 'VendPymt'
    WHERE
        tp.previousDoc IN (SELECT BillID FROM VendorBillsInScope)
)
SELECT p.Invoice, p.ActivityName, p.EventTime, p.SourceSystem, p.LastDataUpdate, p.VendorName, p.InvoiceAmount, p.PurchaseOrderNumber, p.ProcessorUser, p.Approver, p.InvoiceDueDate FROM (
    SELECT bi.Invoice, 'Payment Scheduled' AS ActivityName, p.PaymentScheduledDate AS EventTime, 'NetSuite' AS SourceSystem, BUILTIN.CURRRENT_TIMESTAMP() AS LastDataUpdate, bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL AS Approver, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID
    UNION ALL
    SELECT bi.Invoice, 'Payment Executed', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID
    UNION ALL
    SELECT bi.Invoice, 'Early Payment Captured', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID WHERE p.PaymentExecutionDate <= bi.DiscountDate
    UNION ALL
    SELECT bi.Invoice, 'Late Payment Identified', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID WHERE p.PaymentExecutionDate > bi.InvoiceDueDate
) p

UNION ALL

-- 11. Invoice Closed (Paid in Full)
SELECT
    bi.Invoice,
    'Invoice Closed',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'status' AND n.NoteNewValue = 'Paid In Full'

UNION ALL

-- 14. Credit Memo Applied
SELECT 
    bi.Invoice,
    'Credit Memo Applied',
    vc.trandate AS EventTime,
    'NetSuite' AS SourceSystem,
    BUILTIN.CURRRENT_TIMESTAMP() AS LastDataUpdate,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL AS Approver,
    bi.InvoiceDueDate
FROM 
    TransactionLink tl
JOIN 
    Transaction vc ON tl.previousDoc = vc.ID AND vc.type = 'VendCred'
JOIN 
    BaseInfo bi ON tl.nextDoc = bi.BillID;

ステップ

前提条件：Python 3.6以降と、requests、requests-oauthlib、pandasライブラリがインストールされていることを確認します。pip install requests requests-oauthlib pandasでインストールできます。
NetSuite機能の有効化：NetSuiteで管理者がSuiteTalk Web Servicesを有効にする必要があります。Setup > Company > Enable Features > SuiteCloudに移動し、SUITEANALYTICS WORKBOOKとSUITETALK（WEB SERVICES）のチェックボックスをオンにします。
インテグレーションレコードとアクセストークンの作成：Setup > Integration > Manage Integrations > Newに移動します。新しいインテグレーションレコードを作成し、TOKEN-BASED AUTHENTICATIONとTBA: AUTHORIZATION FLOWを有効にします。CONSUMER KEYとCONSUMER SECRETを控えます。次に、Setup > Users/Roles > Access Tokens > Newに移動し、対象のユーザーまたはロール用のアクセストークンを作成して、インテグレーションレコードに関連付けます。TOKEN IDとTOKEN SECRETを控えます。
Pythonスクリプトの設定：提供されたPythonスクリプトをファイル（例：extract_netsuite_ap.py）にコピーします。NETSUITE_CREDENTIALS辞書のプレースホルダー値に、Account ID、Consumer Key／Secret、Token ID／Secretを入力します。
抽出パラメーターの設定：スクリプトのSTART_DATEとEND_DATE変数を変更し、抽出対象期間を定義します。初回テストでは、1か月などの短い期間から始めることを推奨します。
スクリプトの実行：ターミナルでpython extract_netsuite_ap.pyコマンドを実行します。スクリプトがNetSuiteで認証を行い、複数のSuiteQLクエリを実行してデータを収集・処理します。
スクリプト実行状況の確認：スクリプトはコンソールに進捗を表示し、現在取得しているデータセット（Vendor Bills、System Notes、Paymentsなど）を示します。大量のデータでは数分かかる場合があるため、完了までお待ちください。
出力の確認：正常に完了すると、同じディレクトリにnetsuite_ap_event_log.csvというCSVファイルが生成されます。このファイルには構造化されたイベントログが含まれます。
データ変換ロジック：スクリプトはNetSuiteの生のデータを、必要なイベントログ形式に自動変換します。「Approval Status」フィールドの変更に関するSystem Notesを解析して「Invoice Approved」などのアクティビティを特定し、支払日と支払期限日を比較して「Late Payment Identified」などの派生イベントを計算します。
アップロードの準備：生成されたCSVファイルは、プロセスマイニングツールに直接アップロードできる形式です。列見出し（Invoice、ActivityName、EventTimeなど）が対象アプリケーションで想定されるスキーマと一致していることを確認します。

設定

認証：スクリプトは、NetSuiteがサーバー間インテグレーションの標準方式として採用しているOAuth 1.0のトークンベース認証（TBA）を使います。Account ID、Consumer Key、Consumer Secret、Token ID、Token Secretを指定する必要があります。
APIエンドポイント：スクリプトはAccount IDを使ってREST APIエンドポイントのURLを自動的に構成します。NetSuiteアカウントでREST Web Servicesリクエストが許可されていることを確認してください。
日付範囲：抽出対象はSTART_DATEとEND_DATE変数で制御します。効率的にデータを取得し、タイムアウトを避けるため、lastmodifieddateやdatecreatedなどのインデックス付き日付フィールドで主クエリを絞り込むことが重要です。
データフィルター：WHERE句を追加することで、SuiteQLクエリを特定のSubsidiary、仕入先、文書タイプに絞り込めます（例：WHERE subsidiary = 'YourSubsidiaryID'）。
性能に関する考慮事項：NetSuiteにはAPIガバナンスの上限があります。スクリプトはLIMITとOFFSETによるページネーションを使い、大規模なデータセットを適切に処理します。数百万件のレコードを扱う場合は、日付を小さな範囲に分割し、順番に抽出することを検討してください。
前提条件：アクセストークンに関連付けられたロールには、次のレコードタイプへの閲覧権限が必要です：Vendor Bill、Vendor Payment、Vendor Credit、Purchase Order、System Note、Vendor、Employee。

a サンプルクエリ python

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

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your NetSuite Token-Based Authentication credentials
NETSUITE_CREDENTIALS = {
    class="hl-string">"account": class="hl-string">"[Your_NetSuite_Account_ID]", class=class="hl-string">"hl-comment"># e.g., 1234567_SB1
    class="hl-string">"consumer_key": class="hl-string">"[Your_Consumer_Key]",
    class="hl-string">"consumer_secret": class="hl-string">"[Your_Consumer_Secret]",
    class="hl-string">"token_id": class="hl-string">"[Your_Token_ID]",
    class="hl-string">"token_secret": class="hl-string">"[Your_Token_Secret]"
}

class=class="hl-string">"hl-comment"># Set the date range for the extraction
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- NetSuite API Client ---
def get_netsuite_api_url(account_id):
    class=class="hl-string">"hl-comment"># Replace class="hl-string">'-' with class="hl-string">'_' for sandbox/release preview accounts
    account_id_formatted = account_id.replace(class="hl-string">'-', class="hl-string">'_').lower()
    return fclass="hl-string">"https://{account_id_formatted}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query against the NetSuite REST API with pagination."""
    url = get_netsuite_api_url(NETSUITE_CREDENTIALS[class="hl-string">"account"])
    auth = OAuth1(
        client_key=NETSUITE_CREDENTIALS[class="hl-string">"consumer_key"],
        client_secret=NETSUITE_CREDENTIALS[class="hl-string">"consumer_secret"],
        resource_owner_key=NETSUITE_CREDENTIALS[class="hl-string">"token_id"],
        resource_owner_secret=NETSUITE_CREDENTIALS[class="hl-string">"token_secret"],
        realm=NETSUITE_CREDENTIALS[class="hl-string">"account"]
    )
    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }
    
    all_results = []
    offset = 0
    limit = 1000 class=class="hl-string">"hl-comment"># Max limit per page

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(url, headers=headers, data=payload, auth=auth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_results.extend(items)
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit
            print(fclass="hl-string">"Fetched {len(all_results)} records...")
            time.sleep(1) class=class="hl-string">"hl-comment"># Be respectful to the API

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            if e.response is not None:
                print(fclass="hl-string">"Response Body: {e.response.text}")
            break

    return pd.DataFrame(all_results)

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    print(class="hl-string">"Starting NetSuite AP Data Extraction...")
    
    class=class="hl-string">"hl-comment"># 1. Fetch Vendor Bills
    print(class="hl-string">"\n--- Step 1: Fetching Vendor Bills ---")
    vendor_bill_query = fclass="hl-string">"""
        SELECT
            tran.ID as TransactionId,
            tran.tranId as Invoice,
            tran.entity as VendorId,
            BUILTIN.DF(tran.entity) as VendorName,
            tran.tranDate as TransactionDate,
            tran.dueDate as InvoiceDueDate,
            tran.createdDate as CreatedDate,
            tran.lastModifiedDate as LastDataUpdate,
            tran.total as InvoiceAmount,
            BUILTIN.DF(tran.createdBy) as ProcessorUser,
            BUILTIN.DF(tran.approvalStatus) as ApprovalStatusText,
            tran.approvalStatus as ApprovalStatusId,
            tran.status as StatusId,
            tran.terms as TermsId,
            BUILTIN.DF(tran.terms) as TermsName
        FROM
            Transaction AS tran
        WHERE
            tran.type = 'VendBill'
            AND tran.lastModifiedDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    """
    df_bills = execute_suiteql(vendor_bill_query)
    if df_bills.empty:
        print(class="hl-string">"No vendor bills found for the specified date range. Exiting.")
        return
    
    bill_ids = class="hl-string">','.join(df_bills[class="hl-string">'TransactionId'].astype(str).tolist())
    print(fclass="hl-string">"Found {len(df_bills)} vendor bills.")

    class=class="hl-string">"hl-comment"># 2. Fetch System Notes for status changes
    print(class="hl-string">"\n--- Step 2: Fetching System Notes for status changes ---")
    system_notes_query = fclass="hl-string">"""
        SELECT
            transactionId,
            field,
            newValue,
            oldValue,
            date as EventTime
        FROM
            SystemNote
        WHERE
            transactionId IN ({bill_ids})
            AND field IN ('transaction.approvalstatus', 'transaction.status')
    """
    df_notes = execute_suiteql(system_notes_query)
    print(fclass="hl-string">"Found {len(df_notes)} relevant system notes.")

    class=class="hl-string">"hl-comment"># 3. Fetch PO Links
    print(class="hl-string">"\n--- Step 3: Fetching Purchase Order Links ---")
    po_link_query = fclass="hl-string">"""
        SELECT DISTINCT
            vb.ID as BillId,
            po.tranId as PurchaseOrderNumber
        FROM
            Transaction AS vb
            JOIN TransactionLine AS vbl ON vb.ID = vbl.Transaction
            JOIN Transaction AS po ON vbl.purchaseOrder = po.ID
        WHERE
            vb.ID IN ({bill_ids})
    """
    df_po = execute_suiteql(po_link_query)
    df_po.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_po)} PO links.")

    class=class="hl-string">"hl-comment"># 4. Fetch Payments
    print(class="hl-string">"\n--- Step 4: Fetching Payment Information ---")
    payment_query = fclass="hl-string">"""
        SELECT
            link.prevtranid AS BillId,
            pymt.tranDate AS PaymentDate,
            pymt.ID AS PaymentId
        FROM
            NextTransactionLineLink AS link
            JOIN Transaction AS pymt ON link.nexttranid = pymt.ID
        WHERE
            link.prevtranid IN ({bill_ids})
            AND pymt.type = 'VendPymt'
    """
    df_payments = execute_suiteql(payment_query)
    df_payments.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_payments)} payment applications.")

    class=class="hl-string">"hl-comment"># 5. Fetch Credit Memo Applications
    print(class="hl-string">"\n--- Step 5: Fetching Credit Memo Applications ---")
    credit_query = fclass="hl-string">"""
        SELECT
            link.prevtranid AS BillId,
            credit.tranDate AS CreditApplyDate
        FROM
            NextTransactionLineLink AS link
            JOIN Transaction AS credit ON link.nexttranid = credit.ID
        WHERE
            link.prevtranid IN ({bill_ids})
            AND credit.type = 'VendCred'
    """
    df_credits = execute_suiteql(credit_query)
    df_credits.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_credits)} credit memo applications.")

    class=class="hl-string">"hl-comment"># --- Event Log Generation ---
    print(class="hl-string">"\n--- Step 6: Generating Event Log ---")
    event_log = []
    source_system = class="hl-string">"NetSuite SuiteTalk API"

    for _, bill in df_bills.iterrows():
        base_event = {
            class="hl-string">'Invoice': bill[class="hl-string">'Invoice'],
            class="hl-string">'SourceSystem': source_system,
            class="hl-string">'LastDataUpdate': bill[class="hl-string">'LastDataUpdate'],
            class="hl-string">'VendorName': bill[class="hl-string">'VendorName'],
            class="hl-string">'InvoiceAmount': bill[class="hl-string">'InvoiceAmount'],
            class="hl-string">'InvoiceDueDate': bill[class="hl-string">'InvoiceDueDate'],
            class="hl-string">'ProcessorUser': bill[class="hl-string">'ProcessorUser'],
            class="hl-string">'Approver': None, class=class="hl-string">"hl-comment"># Placeholder, can be enriched from workflow data if available
        }

        po_info = df_po[df_po[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        base_event[class="hl-string">'PurchaseOrderNumber'] = po_info[class="hl-string">'PurchaseOrderNumber'].iloc[0] if not po_info.empty else None

        class=class="hl-string">"hl-comment"># Activity: Vendor Bill Created
        event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Vendor Bill Created', class="hl-string">'EventTime': bill[class="hl-string">'CreatedDate']})

        class=class="hl-string">"hl-comment"># Activity: PO Matching Attempted (inferred at creation if PO exists)
        if base_event[class="hl-string">'PurchaseOrderNumber'] is not None:
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'PO Matching Attempted', class="hl-string">'EventTime': bill[class="hl-string">'CreatedDate']})

        class=class="hl-string">"hl-comment"># Activities from System Notes
        notes = df_notes[df_notes[class="hl-string">'transactionId'] == bill[class="hl-string">'TransactionId']].sort_values(class="hl-string">'EventTime')
        for _, note in notes.iterrows():
            activity = None
            if note[class="hl-string">'field'] == class="hl-string">'transaction.approvalstatus':
                if note[class="hl-string">'newValue'] == class="hl-string">'Pending Approval': activity = class="hl-string">'Approval Submitted'
                elif note[class="hl-string">'newValue'] == class="hl-string">'Approved': 
                    activity = class="hl-string">'Invoice Approved'
                    event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Posted To GL', class="hl-string">'EventTime': note[class="hl-string">'EventTime']})
                elif note[class="hl-string">'newValue'] == class="hl-string">'Rejected': activity = class="hl-string">'Invoice Rejected'
                elif note[class="hl-string">'oldValue'] == class="hl-string">'Pending Approval' and note[class="hl-string">'newValue'] != class="hl-string">'Approved': activity = class="hl-string">'Invoice Re-Routed For Approval'
            
            if note[class="hl-string">'field'] == class="hl-string">'transaction.status' and note[class="hl-string">'newValue'] == class="hl-string">'Paid In Full':
                activity = class="hl-string">'Invoice Closed'

            class=class="hl-string">"hl-comment"># Logic for discrepancy is highly custom. We infer it from a move to a non-standard approval status like class="hl-string">'On Hold'.
            class=class="hl-string">"hl-comment"># This requires knowing the specific numeric ID for such a status.
            class=class="hl-string">"hl-comment"># Example: elif note[class="hl-string">'field'] == class="hl-string">'transaction.approvalstatus' and note[class="hl-string">'newValueId'] == class="hl-string">'[Your_On_Hold_Status_ID]': activity = class="hl-string">'Discrepancy Identified'

            if activity:
                event_log.append({**base_event, class="hl-string">'ActivityName': activity, class="hl-string">'EventTime': note[class="hl-string">'EventTime']})

        class=class="hl-string">"hl-comment"># Payment Activities
        payments = df_payments[df_payments[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        if not payments.empty:
            first_payment = payments.sort_values(class="hl-string">'PaymentDate').iloc[0]
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Scheduled', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']}) class=class="hl-string">"hl-comment"># Simplified: using payment date for schedule
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Executed', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})

            class=class="hl-string">"hl-comment"># Derived Payment Events
            payment_date = pd.to_datetime(first_payment[class="hl-string">'PaymentDate'])
            due_date = pd.to_datetime(bill[class="hl-string">'InvoiceDueDate'])
            if due_date and payment_date > due_date:
                event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Late Payment Identified', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})
            
            class=class="hl-string">"hl-comment"># Early payment requires discount date from terms, which needs another join. Simplified for this example.
            class=class="hl-string">"hl-comment"># If you query class="hl-string">'discountdate' from the transaction you can compare it here.
            class=class="hl-string">"hl-comment"># For example: if pd.to_datetime(bill[class="hl-string">'discountdate']) and payment_date <= pd.to_datetime(bill[class="hl-string">'discountdate']):
            class=class="hl-string">"hl-comment">#    event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Early Payment Captured', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})

        class=class="hl-string">"hl-comment"># Credit Memo Activity
        credits = df_credits[df_credits[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        for _, credit in credits.iterrows():
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Credit Memo Applied', class="hl-string">'EventTime': credit[class="hl-string">'CreditApplyDate']})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    df_event_log = pd.DataFrame(event_log)
    df_event_log.sort_values(by=[class="hl-string">'Invoice', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'netsuite_ap_event_log.csv'
    df_event_log.to_csv(output_filename, index=False)
    print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")

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

ステップ

SuiteScriptの有効化：Setup > Company > Enable Featuresに移動します。SuiteCloudタブで、Server SuiteScriptが有効になっていることを確認します。
スクリプトファイルの作成：下記のqueryセクションから完全なJavaScriptコードをコピーし、.jsファイル（例：processmind_ap_extraction.js）として保存します。
File Cabinetへのスクリプトのアップロード：NetSuiteでDocuments > Files > SuiteScriptsに移動します。新しいフォルダー（例：ProcessMind）を作成し、作成した.jsファイルをアップロードします。
スクリプトレコードの作成：Customization > Scripting > Scripts > Newに移動します。アップロードしたファイルを選択し、「Create Script Record」をクリックします。スクリプト名（例：「ProcessMind AP Extraction」）とID（例：_pm_ap_extraction）を入力して保存します。
スクリプトパラメーターの定義：スクリプトレコードページのParametersサブタブに移動し、次のパラメーターを作成します：
- custscript_pm_start_date：ラベルはStart Date、タイプはDate。
- custscript_pm_end_date：ラベルはEnd Date、タイプはDate。
- custscript_pm_folder_id：ラベルはTarget Folder ID、タイプはInteger Number。出力を保存するFile Cabinetフォルダーの内部IDです。
- custscript_pm_subsidiary_id：ラベルはSubsidiary ID（Optional）、タイプはInteger Number。
スクリプトのデプロイ：スクリプトレコードページでDeploy Scriptボタンをクリックします。Scheduled Scriptを選択してSaveをクリックします。
デプロイの設定：Script DeploymentページでデプロイID（例：_pm_ap_extraction_deployment）を入力します。初回テストではStatusをNot Scheduledに設定します。
スケジュールの設定：Scheduleサブタブで抽出頻度を設定します。初回実行では、手動で1回実行する設定にできます。継続的に抽出する場合は、業務時間外に毎日または毎週実行するよう設定します。
実行パラメーターの設定：デプロイのParametersサブタブで、抽出対象のStart Date、End Date、Target Folder IDを入力します。
実行とファイルの取得：手動で実行するには、StatusをNot Scheduledにしてデプロイを保存し、「Save and Execute」をクリックします。Customization > Scripting > Script Execution Logsでスクリプトの進行状況を確認します。完了したら、File Cabinetの対象フォルダーに移動して、生成されたCSVイベントログをダウンロードします。
ProcessMind用の形式に整える：ダウンロードしたCSVファイルに、スクリプトで指定された正しいヘッダー（Invoice、ActivityName、EventTimeなど）が含まれていることを確認します。これでProcessMindにアップロードできます。

設定

前提条件：SuiteScriptsを作成・実行する権限、Vendor BillとVendor Paymentレコードへのアクセス権、System Notesの閲覧権限を持つNetSuiteユーザーロールが必要です。
スクリプトパラメーター：スクリプトはデプロイパラメーターで設定できるため、コードを変更せずに再利用できます：
- Start DateとEnd Date：請求書の作成日に基づく処理期間を定義します。初回ロードでは6～12か月、差分ロードでは直近7日間を推奨します。
- Target Folder ID：出力CSVを保存するNetSuite File Cabinetフォルダーの内部IDを指定します。フォルダーは事前に作成しておく必要があります。
- Subsidiary ID（Optional）：OneWorldアカウントで、特定のSubsidiaryに抽出対象を絞り込みます。ユーザーがアクセスできるすべてのSubsidiaryを対象にする場合は空欄にします。
性能に関する考慮事項：取引量が多い環境（月間50,000件を超える請求書）では、ガバナンス上限を超えないよう、Map/Reduceスクリプトの使用が適している場合があります。性能への影響を抑えるため、スクリプトは業務時間外に実行するようスケジュールしてください。
カスタムフィールド：承認プロセスやその他の主要データがカスタムフィールドまたはカスタムレコードに依存している場合、スクリプト内のSaved Searchのフィルターと列を調整し、それらのカスタム要素の内部IDを含める必要があります。

a サンプルクエリ javascript

/**
 * @NApiVersion 2.1
 * @NScriptType ScheduledScript
 * @NModuleScope SameAccount
 */

/*

ProcessMind NetSuite AP Invoice Extraction Script

This script extracts Accounts Payable invoice processing events from NetSuite.
It queries Vendor Bill and related transaction data, formats it into a single event log, and saves it as a CSV file in the File Cabinet.

Script Parameters:
- custscript_pm_start_date: (Date) The start date for the query window (based on bill creation date).
- custscript_pm_end_date: (Date) The end date for the query window.
- custscript_pm_folder_id: (Integer) The internal ID of the File Cabinet folder to save the CSV file in.
- custscript_pm_subsidiary_id: (Integer, Optional) The internal ID of the subsidiary to filter on.

*/

define(['N/search', 'N/runtime', 'N/file', 'N/format', 'N/log'], (search, runtime, file, format, log) => {

    const execute = (context) => {
        log.debug('Script Execution Started', 'Starting AP Invoice event log extraction.');

        const script = runtime.getCurrentScript();
        const startDate = script.getParameter({ name: 'custscript_pm_start_date' });
        const endDate = script.getParameter({ name: 'custscript_pm_end_date' });
        const folderId = script.getParameter({ name: 'custscript_pm_folder_id' });
        const subsidiaryId = script.getParameter({ name: 'custscript_pm_subsidiary_id' });

        if (!startDate || !endDate || !folderId) {
            log.error('Missing Parameters', 'Start Date, End Date, and Folder ID are required.');
            return;
        }

        let allEvents = [];
        const now = new Date();

        // Helper to format date/time for CSV
        const formatDateTime = (dateStr) => {
            if (!dateStr) return '';
            try {
                const parsedDate = format.parse({ value: dateStr, type: format.Type.DATETIME });
                return format.format({ value: parsedDate, type: format.Type.DATETIMETZ });
            } catch (e) {
                return dateStr; // Fallback for simple date strings
            }
        };

        // Helper function to run a search and format results
        const runSearchAndCollectEvents = (config) => {
            log.debug('Running Search', `Activity: ${config.activityName}`);
            const searchObj = search.create({
                type: config.type,
                filters: config.filters,
                columns: config.columns
            });

            const pagedData = searchObj.runPaged({ pageSize: 1000 });
            pagedData.pageRanges.forEach(pageRange => {
                const page = pagedData.fetch({ index: pageRange.index });
                page.data.forEach(result => {
                    allEvents.push({
                        'Invoice': result.getValue(config.mapping.Invoice) || '',
                        'ActivityName': config.activityName,
                        'EventTime': formatDateTime(result.getValue(config.mapping.EventTime)) || '',
                        'SourceSystem': 'NetSuite',
                        'LastDataUpdate': format.format({ value: now, type: format.Type.DATETIMETZ }),
                        'VendorName': result.getText(config.mapping.VendorName) || result.getValue(config.mapping.VendorName) || '',
                        'InvoiceAmount': result.getValue(config.mapping.InvoiceAmount) || '',
                        'PurchaseOrderNumber': result.getText(config.mapping.PurchaseOrderNumber) || result.getValue(config.mapping.PurchaseOrderNumber) || '',
                        'ProcessorUser': result.getText(config.mapping.ProcessorUser) || '',
                        'Approver': result.getText(config.mapping.Approver) || '',
                        'InvoiceDueDate': result.getValue(config.mapping.InvoiceDueDate) || ''
                    });
                });
            });
            log.debug('Search Complete', `Found ${allEvents.length} total events so far.`);
        };

        // Common filters
        let baseBillFilters = [
            ['mainline', 'is', 'T'], 'AND',
            ['type', 'anyof', 'VendBill'], 'AND',
            ['datecreated', 'within', startDate, endDate]
        ];
        if (subsidiaryId) {
            baseBillFilters.push('AND', ['subsidiary', 'anyof', subsidiaryId]);
        }

        // --- Define Search Configurations for each Activity ---

        const searchConfigs = [
            // 1. Vendor Bill Created
            {
                activityName: 'Vendor Bill Created',
                type: 'vendorbill',
                filters: baseBillFilters,
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'datecreated', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: 'datecreated', VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: 'createdby', InvoiceDueDate: 'duedate' }
            },
            // 2. PO Matching Attempted (Inferred from System Notes on first PO application)
            {
                activityName: 'PO Matching Attempted',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'appliedtotransaction'], 'AND', ['systemnotes.newvalue', 'contains', 'Purchase Order']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', sort: search.Sort.ASC, label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' }),
                    search.createColumn({ name: 'appliedtotransaction', label: 'PurchaseOrderNumber' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: 'createdby', InvoiceDueDate: 'duedate', PurchaseOrderNumber: 'appliedtotransaction' }
            },
            // 3. Discrepancy Identified (Uses a placeholder for custom status, e.g., 'On Hold')
            {
                activityName: 'Discrepancy Identified',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', '[On Hold]']]), // Placeholder: Replace '[On Hold]' with your actual status text
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 4. Approval Submitted & 5. Invoice Re-Routed For Approval
            {
                activityName: 'Approval Submitted', // This will capture initial and subsequent submissions
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Pending Approval']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 6. Invoice Approved & 8. Invoice Posted to GL
            {
                activityName: 'Invoice Approved', // Approval event often coincides with posting
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Approved']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'Approver' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', Approver: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 7. Invoice Rejected
            {
                activityName: 'Invoice Rejected',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Rejected']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'Approver' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', Approver: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 9. Payment Scheduled
            {
                activityName: 'Payment Scheduled',
                type: 'vendorpayment',
                filters: [['mainline', 'is', 'T'], 'AND', ['type', 'anyof', 'VendPymt'], 'AND', ['appliedtotransaction.type', 'anyof', 'VendBill'], 'AND', ['appliedToTransaction.datecreated', 'within', startDate, endDate]],
                columns: [
                    search.createColumn({ name: 'tranid', join: 'appliedToTransaction', label: 'Invoice' }),
                    search.createColumn({ name: 'datecreated', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', join: 'appliedToTransaction', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', join: 'appliedToTransaction', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: search.createColumn({name: 'tranid', join: 'appliedToTransaction'}), EventTime: 'datecreated', VendorName: 'entity', InvoiceAmount: search.createColumn({name: 'total', join: 'appliedToTransaction'}), ProcessorUser: 'createdby', InvoiceDueDate: search.createColumn({name: 'duedate', join: 'appliedToTransaction'}) }
            },
            // 10. Payment Executed
            {
                activityName: 'Payment Executed',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', '']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', join: 'payingTransaction', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'createdby', join: 'payingTransaction'}), InvoiceDueDate: 'duedate' }
            },
            // 11. Invoice Closed
            {
                activityName: 'Invoice Closed',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'Status'], 'AND', ['systemnotes.newvalue', 'is', 'Vendor Bill : Paid in Full']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 12. Early Payment Captured
            {
                activityName: 'Early Payment Captured',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', ''], 'AND', ['formuladate: {payingtransaction.trandate} <= {discountdate}', 'is', '1']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', InvoiceDueDate: 'duedate' }
            },
            // 13. Late Payment Identified
            {
                activityName: 'Late Payment Identified',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', ''], 'AND', ['formuladate: {payingtransaction.trandate} > {duedate}', 'is', '1']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', InvoiceDueDate: 'duedate' }
            },
            // 14. Credit Memo Applied
            {
                activityName: 'Credit Memo Applied',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['applyingtransaction.type', 'anyof', 'VendCred']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'applyingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', join: 'applyingTransaction', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'applyingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'createdby', join: 'applyingTransaction'}), InvoiceDueDate: 'duedate' }
            },
        ];

        // Execute all searches
        searchConfigs.forEach(config => {
            try {
                runSearchAndCollectEvents(config);
            } catch (e) {
                log.error(`Search Failed for ${config.activityName}`, e);
            }
        });

        // Convert to CSV and save
        if (allEvents.length > 0) {
            const headers = Object.keys(allEvents[0]);
            let csvContent = headers.join(',') + '\n';
            allEvents.forEach(event => {
                const row = headers.map(header => {
                    let value = event[header] ? event[header].toString() : '';
                    // Escape commas and quotes
                    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
                        value = '"' + value.replace(/"/g, '""') + '"';
                    }
                    return value;
                });
                csvContent += row.join(',') + '\n';
            });

            const fileName = `ProcessMind_AP_EventLog_${new Date().toISOString().slice(0, 10)}.csv`;
            const csvFile = file.create({
                name: fileName,
                fileType: file.Type.CSV,
                contents: csvContent,
                folder: folderId
            });
            const fileId = csvFile.save();
            log.audit('File Created', `Successfully created file ${fileName} with ID ${fileId} in folder ${folderId}.`);
        } else {
            log.audit('No Events Found', 'No events found for the specified criteria.');
        }

        log.debug('Script Execution Finished', `Processed a total of ${allEvents.length} events.`);
    };

    return { execute };
});

準備はできましたか

このデータテンプレートを使えば、買掛金請求書処理の最適化を始める準備が整います。今すぐワークフローを変革し、より迅速でコンプライアンスに適合した支払いを実現します。

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

管理を強化：買掛金請求書処理を今すぐ最適化

遅延損害金と二重支払いをなくし、コストを60％削減します。

無料トライアルを開始

クレジットカードは不要で、数分でセットアップできます。

買掛金請求書処理のデータテンプレート

買掛金請求書処理のデータテンプレート

買掛金請求書処理の属性

買掛金請求書処理のアクティビティ

抽出ガイド

NetSuite Saved Searchと標準レポートのエクスポート

ステップ

設定

a サンプルクエリ json

SuiteAnalytics Connect経由のSuiteQLクエリ（ODBC／JDBC）

ステップ

設定

a サンプルクエリ sql

SuiteTalk REST／SOAP APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

サーバー側SuiteScriptによるデータエクスポートの自動化

ステップ

設定

a サンプルクエリ javascript

準備はできましたか

管理を強化：買掛金請求書処理を今すぐ最適化

買掛金請求書処理のデータテンプレート

買掛金請求書処理のデータテンプレート

買掛金請求書処理の属性

買掛金請求書処理のアクティビティ

抽出ガイド

NetSuite Saved Searchと標準レポートのエクスポート

ステップ

設定

a サンプルクエリ json

SuiteAnalytics Connect経由のSuiteQLクエリ（ODBC／JDBC）

ステップ

設定

a サンプルクエリ sql

SuiteTalk REST／SOAP APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

サーバー側SuiteScriptによるデータエクスポートの自動化

ステップ

設定

a サンプルクエリ javascript

準備はできましたか

管理を強化：買掛金請求書処理を今すぐ最適化

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