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

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

NetSuite

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

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

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

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

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

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

買掛金の請求書処理に関する属性

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

5 必須 6 推奨 10 任意

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

必須推奨任意

買掛金の請求書処理に関するアクティビティ

プロセスを正確に把握し、ボトルネックを特定するために、イベントログに記録する主要なプロセスステップとマイルストーンです。

6 推奨 8 任意

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

推奨任意

データ抽出ガイド

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

ステップ

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

設定

前提条件：保存検索に対する「Create」または「Full」レベルの権限を持つユーザーロールが必要です。また、Transactionレコード（特にVendor Bill、Vendor Payment、Vendor Credit）と関連するEntityレコード（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個すべてのアクティビティの数式を含む保存検索を1つ作成すると、NetSuiteでの処理が遅くなったり、タイムアウトしたりする場合があります。複数の保存検索（例：請求書の作成・承認用と支払い用）に分け、ピボット解除の前にエクスポートしたファイルを結合する方法もご検討ください。

クエリの例 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 Bill、Vendor Payment、Purchase Order、System Notes）へのアクセス権も確認してください。
ドライバーをインストールして設定する：NetSuiteの画面で「Home」>「Set Preferences」>「Analytics Driver」に移動し、使用するOSに適したNetSuite ODBC（またはJDBC）ドライバーをダウンロードします。インストール手順に従って、新しいデータソース名（DSN）を設定し、NetSuiteサービスに接続します。
接続する：使用するSQLクライアント（例：DBeaver、Power BI、Tableau）を開き、設定したドライバーまたはDSNを使って新しい接続を作成します。認証にはNetSuiteのアカウントID、ロール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のアドオンモジュールが必要です。NetSuiteデータのレプリカに読み取り専用でアクセスできます。
ユーザーロールの権限：接続に使うNetSuiteロールで「SuiteAnalytics Connect」権限を有効にする必要があります。また、次のレコードに対する閲覧権限も必要です：Transactions（Vendor Bill、Vendor Payment、Vendor Credit）、Entities（Vendor、Employee）、System Notes。
期間の絞り込み：実行時間を運用しやすい範囲に抑えるため、特定の期間でクエリを絞り込むことが欠かせません（例：trandate BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'）。全データを抽出する前に、3～6か月など短い期間から始めてください。
子会社による絞り込み：NetSuite OneWorldアカウントでは、特定の法人のデータを分離し、クエリのパフォーマンスを高めるため、必ずWHERE句に子会社IDの条件を含めてください。
カスタム承認ワークフロー：このクエリは、Vendor Billの標準「Approval Status」フィールドを使うことを前提としています。承認にカスタムフィールドやカスタムレコードを使うSuiteFlowまたはスクリプトを組織で利用している場合、approvalstatusフィールドに関するSystemNote参照箇所を大幅に変更する必要があります。

クエリの例 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コマンドでインストールできます：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」フィールドの変更を解析して「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など、インデックスが設定された日付フィールドでメインクエリを絞り込むことが重要です。
データフィルター：SuiteQLクエリにWHERE句（例：WHERE subsidiary = 'YourSubsidiaryID'）を追加すると、特定の子会社、仕入先、文書タイプに絞り込めます。
パフォーマンスに関する考慮事項：NetSuiteにはAPIガバナンスの上限があります。スクリプトはページネーション（LIMITとOFFSET）を使い、大規模なデータセットを処理します。数百万件のレコードを抽出する場合は、日付範囲を小さく区切り、順番に実行することを検討してください。
前提条件：アクセストークンに関連付けられたロールには、次のレコードタイプを表示する権限が必要です：Vendor Bill、Vendor Payment、Vendor Credit、Purchase Order、System Note、Vendor、Employee。

クエリの例 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が有効になっていることを確認します。
スクリプトファイルを作成：下のクエリセクションにある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アカウントで特定の子会社に抽出対象を絞り込みます。空欄の場合、ユーザーがアクセスできるすべての子会社が対象になります。
パフォーマンスに関する考慮事項：月間の取引件数が5万件を超える環境では、ガバナンスの上限超過を避けるため、Map/Reduceスクリプトのほうが適している場合があります。パフォーマンスへの影響を抑えるため、業務時間外に実行するようスケジュールしてください。
カスタムフィールド：承認プロセスなどの重要なデータにカスタムフィールドやカスタムレコードを使用している場合は、スクリプト内の保存済み検索のフィルターと列を調整し、該当するカスタム要素の内部IDを含める必要があります。

クエリの例 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の保存検索と標準レポートのエクスポート

ステップ

設定

クエリの例 json

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

ステップ

設定

クエリの例 sql

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

ステップ

設定

クエリの例 python

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

ステップ

設定

クエリの例 javascript

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

買掛金請求書を最適化し、管理を強化