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

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

NetSuite

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

買掛金（AP）請求書処理用データテンプレート

買掛金（AP）請求書処理を最適化するために必要なデータ収集を案内する包括的なテンプレートです。収集すべき主要な属性と、イベントログで追跡すべき重要なアクティビティを整理しています。さらに、NetSuiteからの具体的な抽出方法も示しており、正確なプロセス分析と改善に必要な情報を漏れなく揃えられます。

収集を推奨する属性
追跡すべき主要アクティビティ
NetSuite向け抽出ガイド

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

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

買掛金の請求書処理の属性

買掛金の請求書処理を網羅的に分析するため、イベントログに含めるべき推奨データ項目は次のとおりです。

5 必須 6 推奨 11 任意

	名前	説明
	アクティビティ ActivityName	請求書プロセスで発生した業務アクティビティ／イベント名。
説明この属性は、買掛金（AP）プロセスにおける個々のステップやマイルストーン（例: 'Vendor Bill Created'、'Invoice Approved'、'Payment Executed'）を表します。これらのアクティビティの順序と頻度を分析することが Process Mining の中核です。プロセスフローを可視化し、一般的なバリアントと稀なバリアントを把握し、標準手順からの逸脱やボトルネックを特定できます。定義された各アクティビティはプロセスマップ上のノードになります。その重要性プロセスの各ステップを定義し、プロセスマップの可視化、遷移時間の計算、ボトルネックや手戻りループの特定ができます。取得元 NetSuiteのVendor Billおよび関連する支払いレコードにおけるステータス変更、監査証跡、システムログから導出します。多くの場合、変換ロジックが必要です。例仕入先請求書の作成請求書が承認済み支払実行差異を検出
	請求書 Invoice	各仕入先請求書の一意の識別子。
説明 'Invoice' は主要なケース識別子として、請求書の受領から最終支払いまでのすべてのアクティビティを結び付けます。この属性は各請求書のエンドツーエンドの流れを再現するうえで不可欠です。分析では、フィルタリングや集計、個々の請求書プロセスの詳細な分析を可能にし、バリアント分析やサイクルタイム算出の基盤となります。その重要性関連するイベントを1つのプロセスインスタンスに結び付ける基礎属性で、請求書のライフサイクルをエンドツーエンドで分析できます。取得元 NetSuiteのVendor Bill取引レコードの主キーで、一般にTransaction IDまたは伝票番号と呼ばれます。例 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 からイベントデータを最後に抽出した日時を示します。プロセス・マイニングツール上でのデータの鮮度を表します。分析のタイムリーさを判断するうえで重要です。特に請求書のほぼリアルタイムな状況を追う運用系の dashboard では、データがどれだけ最新かを確認できます。その重要性データの鮮度を可視化し、分析がどれだけ最新か、次回の更新がいつかを把握できます。取得元このタイムスタンプは、データ取り込み時に抽出ツールやパイプラインによって生成されます。例 2024-03-10T02:00:00Z2024-03-11T02:00:00Z
	Approver Approver	請求書の支払い承認を担当するユーザー。
説明この属性は、請求書の最終承認を行った管理者または予算責任者を示します。請求書には複数の承認者が設定される場合があります。これは 'Approval Bottleneck Analysis' dashboard の主要ディメンションです。承認者別の所要時間を可視化し、承認が遅い担当者を特定したり、負荷分散のために経路を見直したりして、全体の承認プロセスを効率化できます。その重要性承認のボトルネック特定を直接支援し、承認チェーンに関与する管理者の負荷やパフォーマンス分析に役立ちます。取得元この情報は、Vendor Bill取引に紐づくワークフロー履歴や承認ログに保存されていることが多いです。例 s.chenp.williamsr.davis
	仕入先名 VendorName	請求書の発行元である仕入先名。
説明この属性は、請求書に紐づくベンダーの法的名称を示します。取引に結び付く重要なマスターデータです。ベンダー別に分析することで、頻発する不一致、支払い遅延、ダイナミックディスカウントの機会など、サプライヤー特有の課題を発見できます。'Invoice Status and Aging' dashboard で未払い請求書を分類したり、関係管理を行ううえでも不可欠です。その重要性仕入先別のパフォーマンス分析が可能になり、課題のある取引先の特定、条件交渉、関係管理を効果的に進められます。取得元 Vendor Billに紐づくVendorレコードから取得します。通常は「Vendor Name」または「Company Name」フィールドです。例 Global Office Supplies Inc.Tech Solutions LLCCreative Marketing Co.
	処理担当者 ProcessorUser	請求書の入力または処理を担当するユーザー。
説明この属性は、請求書のデータ入力や初期処理を担当した買掛金（AP）チームのメンバーを特定します。このデータは 'AP Staff Workload Distribution' dashboard に不可欠です。マネージャーは負荷の偏りや教育ニーズを把握し、個人・チームのパフォーマンスを測定できます。エラーの原因を担当者まで遡って調査する際にも役立ちます。その重要性活動を担当者にひもづけることで、工数分析、パフォーマンス監視、エラーの原因分析が可能になります。取得元 Vendor Bill の初期アクティビティに関するシステムノートまたは監査証跡の 'Created By' または 'Modified By' フィールド。例 j.doea.smithm.jones
	発注番号 PurchaseOrderNumber	請求書に関連付けられた発注書（該当する場合）の識別子。
説明この属性は、ベンダー請求書が事前承認済みの購買発注（PO）に紐づいているかどうかを示します。紐づきの有無は、PO付き請求書か非PO請求書かを区別する鍵です。 'PO/GR Matching Efficiency' dashboard および 'PO/GR Matching Success Rate' KPI に不可欠な項目です。請求書がPO付きかどうかでプロセスを分けて分析することで、3点照合による効率化や自動化の余地を明らかにできます。その重要性 POあり請求書と非PO請求書を区別します。両者はプロセス経路や自動化の余地が異なるため、照合効率の分析に不可欠です。取得元通常、Vendor Billレコードの明細行またはヘッダーにあり、Purchase Order取引への紐づけに使われます。例 PO-004589PO-005123null
	請求書の支払い期日 InvoiceDueDate	延滞料を避けるための支払い期日。
説明この属性は、ベンダーの支払い条件と請求書日から算定された支払期日を示します。AP プロセスにおける重要な締切です。この日付は 'Payment Compliance Dashboard' と 'Payment Term Adherence Rate' KPI の基準点です。支払いが期日内か、前倒しか、遅延かを判定し、サプライヤーとの関係や延滞金の発生に直結します。その重要性期限どおりの支払いを測る主要な指標であり、仕入先との関係や財務コンプライアンスの観点から非常に重要です。取得元 Vendor Bill取引レコードに標準で用意されている『Due Date』フィールドです。例 2023-11-302023-12-152024-02-28
	請求書金額 InvoiceAmount	請求書の合計金額。
説明この属性は、控除や割引前のベンダー請求書の総額（グロス）を表します。各ケースの基礎となる財務指標です。請求金額は、金額帯（高額/少額）で区分して経路の違いを比較するなどの財務分析に使われます。ボトルネックや遅延の財務インパクトを dashboard で把握する際にも役立ち、DPO の算出にも不可欠です。その重要性プロセス非効率の金額インパクトを可視化し、請求金額でセグメントして高額案件を優先できます。取得元 Vendor Bill 取引レコードのヘッダーにある 'Amount' または 'Total' フィールド。例 1500.75250.0012500.50
	ドキュメントタイプ DocumentType	処理対象のドキュメント種別（例: Invoice, Credit Memo）。
説明この属性は、標準の請求書とクレジットメモなどの関連ドキュメントを区別し、適用される処理ルールやワークフローの違いを反映します。ドキュメント種別ごとに分析することで、同じ性質のもの同士を正しく比較できます。例えば、高額請求書の承認プロセスは小額のクレジットメモより厳格になりがちです。こうしたセグメント化により、プロセスのパフォーマンスをより正確に捉えられます。その重要性伝票種別ごとにプロセスをセグメント化。経路やKPIが異なるケースを分けて分析でき、精度が高まります。取得元 NetSuiteの取引タイプから判別できます（例：'Vendor Bill'、'Vendor Credit'）。例標準請求書クレジットメモデビットメモ
	会社コード CompanyCode	請求書を処理する法人／子会社の識別子。
説明この属性は、請求書の負債を負う社内の会社または子会社を示します。複数の法的実体を持つ企業で特に重要です。 'Company Code' 単位でプロセスを分析することで、事業間のパフォーマンス比較が可能になります。子会社特有の効率・コンプライアンス・負荷の差異を可視化し、的を絞った改善施策につなげられます。その重要性法人や子会社間でプロセス性能を比較でき、重点改善とコーポレートガバナンスの徹底を支援します。取得元 NetSuiteのOneWorld環境では、トランザクションレコードの 'Subsidiary' フィールドに相当します。例 US01DE01UK01
	処理時間 ProcessingTime	アクティビティに実際に費やした作業時間。
説明この属性は、単一のアクティビティが開始してから終了するまでの所要時間（処理時間）を測定します。これは、リソースが実際にタスクに従事していた時間を表します。サイクルタイム（待ち時間を含む）とは異なり、処理時間は各タスクに必要な実労力の分析に役立ちます。たとえば 'PO Matching Attempted' に費やした時間を測ることで、そのステップの効率を評価し、自動化の機会を特定できます。その重要性アクティビティの実作業時間を測定し、待機時間と切り分けて、リソース配分や効率を正確に分析できます。取得元各アクティビティのStartTimeとEndTimeの差分で算出します。両方のタイムスタンプが存在することが前提です。例 PT5MPT1H30MPT8H
	割引日 EarlyPaymentDiscountDate	早期支払い割引の適用対象となる支払い期限。
説明この属性は、'Payment Terms' に基づきベンダーの割引を受けられる最終支払日（例: '2% 10, Net 30' における '10'）を示します。この日付は 'Early Payment Discount Opportunities' dashboard の主要ドライバーです。当日や実際の支払日と比較することで機会を特定し、'Early Payment Discount Capture Rate' KPI を測定して、コスト削減の最大化に役立ちます。その重要性早期支払い割引によるコスト削減を最大化するための重要日付で、追跡することでキャッシュマネジメントの最適化に役立ちます。取得元これはVendor Billレコード上の計算フィールドで、請求日と『Terms』から算出されます。例 2023-11-102024-01-20null
	手戻りか IsRework	そのアクティビティが手戻りループに該当するかを示すフラグ。
説明この計算済みブール属性は、二度目の『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）。
説明ベンダーがどの条件で支払いを求めるか（支払期限や早期支払い割引など）を定義する属性です。支払い条件は 'Invoice Due Date' や 'Early Payment Discount Date' の算出に使われます。'Payment Compliance Dashboard' の基礎データであり、早期支払い割引の獲得余地を分析して運転資本を最適化する際にも重要です。その重要性支払い期日や割引適用の可否を左右し、キャッシュフロー管理やコスト削減の実現に直結します。取得元 Vendor Bill 取引の 'Terms' フィールド。通常は仕入先マスタから継承されます。例 Net 30Net 602% 10, Net 30
	早期支払い割引を獲得済み IsEarlyPaymentCaptured	利用可能な早期支払割引を取得できたかを示すフラグ。
説明この計算済みブール属性は、割引適用対象の請求書が『Early Payment Discount Date』当日までに支払われたかどうかを判定します。この属性は『Early Payment Discount Capture Rate』KPIの測定や『Early Payment Discount Opportunities』ダッシュボードに不可欠です。割引獲得の成否を明確にし、逃した節約機会を可視化します。その重要性資金管理（Treasury）やAP機能がコスト削減をどれだけ獲得できているかを直接測る、重要な財務KPIです。取得元データ変換時に算出：割引対象の請求書について PaymentDate <= EarlyPaymentDiscountDate を満たすか。例 truefalsenull
	期日通りに支払い済み IsOnTimePayment	請求書が期日内（期日前を含む）に支払われたかを示すフラグ。
説明この計算済みブール属性は、『Payment Date』が『Invoice Due Date』以下かどうかを判定し、各請求書が期限どおりかを真偽で示します。この属性は『Payment Compliance Dashboard』を直接支援し、『Payment Term Adherence Rate』KPIの算出に用いられます。遅延支払いをすぐに絞り込めるため、原因分析を簡単にします。その重要性支払いのタイムリーさの分析を簡素化し、支払い条件の遵守や仕入先関係管理に関する KPI に直結します。取得元データ変換時に算出：PaymentDate <= InvoiceDueDate。例 truefalse
	請求書ステータス InvoiceStatus	請求書の現在の処理ステータス。
説明この属性は、AP のライフサイクルにおけるベンダー請求書の現在の状態（例: 'Open'、'Pending Approval'、'Paid in Full'）を表します。 'Invoice Status and Aging' dashboard の主要な属性であり、現在の作業量と負債状況のスナップショットを提供します。未処理や問題のある請求書に絞り込み、完了までの進捗を追跡できます。その重要性請求書がプロセスのどこにあるかをリアルタイムで把握でき、オペレーション監視、負荷管理、資金計画に不可欠です。取得元 Vendor Bill 取引レコードの 'Status' フィールド。例オープン承認待ち全額支払済み
	通貨 Currency	請求金額の通貨コード（例: USD, EUR）。
説明この属性は、請求書の通貨を示し、'InvoiceAmount' を理解するうえでの前提となる情報です。多国籍企業では、単一で一貫した通貨での分析が重要です。本フィールドにより適切な通貨換算が可能になり、地域や事業部をまたいで財務指標を同一基準で比較できます。その重要性金額に関する必要な前提情報を提供し、特に多国籍環境での正確な財務分析を支えます。取得元 Vendor Bill 取引レコード上の 'Currency' フィールド。多くの場合、仕入先マスタと連動します。例 USDEURGBPCAD

必須推奨任意

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

正確なプロセス発見とボトルネック特定のため、イベントログに記録すべき主要ステップとマイルストーンは次のとおりです。

6 推奨 8 任意

	アクティビティ	説明
	仕入先請求書の作成	NetSuite に新しい仕入先請求書が登録されたことを示します。Vendor Bill トランザクションの作成日から取得し、AP プロセスの正式な開始点となります。
その重要性請求書処理のサイクルタイム計測の起点を定義します。全体のプロセス効率の測定や経過日数の把握に不可欠です。取得元 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 レコードの取引日を使用して記録されます。
その重要性 APプロセスの主要な完了ポイントで、エンドツーエンドのサイクルタイム、支払い条件の順守、DPO（Days Payable Outstanding）の算出に不可欠です。取得元 Vendor Bill にリンクされた Vendor Payment 取引レコードの 'Date' フィールド。取得当該Billに適用されたVendor Paymentレコードの取引日。イベントタイプ explicit
	請求書がクローズ済み	Vendor Bill レコードが最終的にクローズされた時点を示します。通常は全額支払い後で、ステータスが 'Paid in Full' に変わったときに判定します。
その重要性プロセスライフサイクルの明確な終了イベントを提供し、当該請求書にこれ以上の対応が不要であることを確認します。取得元 System Notesに記録された、Vendor Billの 'Status' フィールドが 'Paid in Full' に変更されたタイムスタンプから推定します。取得『Status』が『Paid in Full』に変更されたタイムスタンプ。イベントタイプ inferred
	請求書が承認済み	指定された承認者により支払いが許可されたことを示します。伝票の 'Approval Status' が 'Approved' に設定された時点で記録されます。
その重要性承認フェーズを完了させ、仕訳計上と支払いスケジュール設定を可能にする重要なマイルストーンです。承認業務の効率を測る主要なデータポイントです。取得元 Vendor Billレコードの『Approval Status』が『Approved』に変更されたタイムスタンプ（System Notesまたはワークフローのログに記録）。取得 Workflow logまたはSystem Notesでの「Approval Status」=「Approved」のtimestamp。イベントタイプ explicit
	請求書をGLへ転記	Vendor Bill の財務影響が総勘定元帳に正式に記帳された瞬間を示します。請求書が承認され、'Posting' フラグが有効になったトランザクション日付で取得します。
その重要性負債が会社として正式に認識されたことを示す重要な財務コントロールのポイントです。計上の遅延は財務報告の正確性に影響します。取得元 Vendor Bill から作成された GL 取引に対応する計上日。伝票の 'Posting' フィールドがチェックされている必要があります。取得 Vendor Billに紐づくGL（総勘定元帳）計上の取引日。イベントタイプ explicit
	PO 突合を試行	仕入先請求書を検証のために対応する発注書（PO）に関連付ける操作を表します。承認前に、Vendor Bill のレコードの 'Items' または 'Expenses' サブリストで初めて PO を関連付けた時点で検出されます。
その重要性このステップを追うことで照合プロセスの効率を評価でき、承認提出前の遅延箇所を特定できます。取得元 Vendor Billで 'Created From' フィールドが初めて設定された、または明細レベルのPO参照が付与されたことを示すSystem Notesのログから推定します。取得 System Notesで、PO参照フィールドへの入力を検知します。イベントタイプ inferred
	クレジットメモ充当	Vendor Credit が Vendor Bill に充当され、支払額が減る場合です。2 つのトランザクションを関連付ける適用イベントから取得します。
その重要性クレジットメモの充当は請求書をクローズする重要な代替フローです。追跡することで、貸倒れや返品がAP全体に与える影響を把握できます。取得元 Vendor Credit 取引が Vendor Bill に適用された際の適用日。伝票の関連レコードで確認できます。取得 Vendor CreditがVendor Billに適用されたタイムスタンプ。イベントタイプ explicit
	差異を検出	請求書・購買発注・受領（入庫）の間に不一致が見つかり、その後の処理を停止する必要がある場合に発生します。多くの場合、ユーザーが 'Approval Status' を 'On Hold' や 'Pending Clarification' に設定したことから推定されます。
その重要性このアクティビティを可視化することで、検証プロセスにおける摩擦や手戻りの発生源を特定できます。これらは支払い遅延の主因です。取得元 Vendor Billの 'Approval Status' フィールドが標準外の保留状態（例: 'On Hold'）へ変更されたことから推定します。カスタムステータスの設定が必要になる場合があります。取得保留や問い合わせを示す『Approval Status』の変更を追跡します。イベントタイプ inferred
	支払スケジュール設定	このアクティビティは、ベンダー請求書が支払い対象として選ばれ、支払いバッチ（一括支払い）に含められたことを示します。支払日を将来日付に設定した 'Vendor Payment' 取引が作成された時点で記録されます。
その重要性このイベントにより支払いパイプラインの見通しが立ち、キャッシュフロー予測や早期支払い割引を逃さないための支払いタイミング管理に役立ちます。取得元仕入先請求書に充当された仕入先支払トランザクションの作成日。取得関連する仕入先支払トランザクションの作成タイムスタンプ。イベントタイプ explicit
	早期支払を実施	請求書の支払が早期支払割引の期限より前に実行された場合に発生する、計算で判定されるイベントです。仕入先請求書の支払条件から割引適用日を算出し、実際の支払日と比較して判定します。
その重要性 APチームが割引をどれだけ獲得できているかを直接示す指標で、収益性や資金管理戦略に直結します。取得元これは計算で判定するイベントです。Vendor Payment取引の『Date』と、Vendor Billの『Terms』から導かれる割引期日を比較します。取得仕入先支払の「Date」と仕入先請求書の「Terms」から導出した割引日を比較します。イベントタイプ calculated
	請求書が却下された	承認プロセス中に仕入先請求書が正式に却下され、修正と再申請が必要になったことを表します。'Approval Status' が 'Rejected' に更新された時点で記録されます。
その重要性却下の追跡は手戻り分析に不可欠です。典型的な失敗要因（コードの誤り、ポリシー違反など）を特定し、初回承認率の向上につなげます。取得元 Vendor Billレコードの『Approval Status』が『Rejected』に変更されたタイムスタンプ（System Notesに記録）。取得 Workflow logまたはSystem Notesでの「Approval Status」=「Rejected」のtimestamp。イベントタイプ explicit
	請求書を承認ルートへ再回付	変更や却下により、請求書が前段階や別の承認者に差し戻される場合です。'Approval Status' が 'Pending Approval' から別状態に戻り、再び 'Pending Approval' になる遷移から推定します。
その重要性承認プロセス内での再回付（re-routing）イベントを捉えることは、手戻りループの把握に不可欠です。これはサイクルタイムを大幅に延ばす要因となります。取得元同一の請求書で 'Approval Status' が複数回 'Pending Approval' に変わるシーケンスを、System Notesから検出して推定します。取得 System Notes内の「Approval Status」変更のシーケンスを分析。イベントタイプ inferred
	遅延支払いを検知	請求書が支払期日後に支払われた場合に発生する、計算で判定されるイベントです。仕入先請求書の支払期日と支払実行日を比較して判定します。
その重要性支払い遵守のモニタリングやサプライヤー関係の維持に不可欠なアクティビティです。遅延支払いが多いと、ベンダーの信頼を損ないます。取得元仕入先支払トランザクションの「Date」と、仕入先請求書レコードの「Due Date」を比較して判定します。Payment Date > Due Date の場合に発生します。取得仕入先支払の「Date」と仕入先請求書の「Due Date」を比較します。イベントタイプ calculated

推奨任意

データ抽出ガイド

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（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 用の Formula 列をそれぞれ 1 つずつ追加します。後で変換する前提の「横持ち」データを作成します。
- 'Invoice Approved' の例:
  - Formula (Text) に CASE WHEN {approvalstatus} = 'Approved' THEN 'Invoice Approved' ELSE NULL END を追加。Custom Label は ActivityName_Approved など。
  - Formula (Date/Time) に CASE WHEN {approvalstatus} = 'Approved' THEN {systemnotes.date} WHERE systemnotes.field = 'Approval Status' and systemnotes.newvalue = 'Approved' ELSE NULL END を追加。Custom Label は EventTime_Approved など。補足: ステータス変更の正確なタイムスタンプを取得するにはシステムノートを参照する必要があり、やや複雑です。より簡単ですが精度は下がる方法として、利用可能なら {approveddate} フィールドの使用も検討してください。
- 以下の query セクションのロジックに沿って、必要な 14 アクティビティすべてを同様に設定します。
検索の公開設定: Audience サブタブで、エクスポートを実行するユーザー/ロールがアクセスできるようにします。検索名は ProcessMind AP Extraction のように分かりやすく付けます。
保存して実行: Save & Run をクリックして検索を実行。NetSuite の UI で、横持ち形式で期待どおりにデータが出ているか確認します。
CSV へエクスポート: 検索結果画面の Export アイコン（CSV/Excel/PDF）から CSV を選択します。
データを変形（Unpivot）: 出力された CSV は、請求書 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 に対して Create または Full 権限を持つユーザーロールが必要です。あわせて、トランザクション（Vendor Bill、Vendor Payment、Vendor Credit）と関連エンティティ（Vendor、Employee）への閲覧権限も必要です。
検索タイプ: このプロセスでは常に Transaction 検索から始めてください。
日付範囲フィルター: データ量を抑えるため、日付範囲（例：Date Created）での絞り込みが不可欠です。まずは3〜6カ月の小さな範囲でパフォーマンスと結果を確認し、問題なければ期間を広げてください。
Main Line フィルター: Criteria > Main Line > is True を使うと、トランザクションあたり1件の結果になり、一般的に有効です。ただし、明細行レベルで発生する「PO Matching Attempted」のようなアクティビティは、このフィルターを使わない別の検索や、より複雑な式が必要になる場合があります。
カスタムフィールド: AP プロセスをカスタムフィールドで管理している場合（例：標準の Approval Status ではなくカスタムの AP Process Status）、該当フィールドを特定し、検索条件や結果の式で置き換えてください。
パフォーマンス: 14のアクティビティを単一の Saved Search と計算式で網羅すると、遅延やタイムアウトの恐れがあります。Bill 作成/承認用、支払用などにロジックを分割した Saved Search を複数用意し、unpivot 前にエクスポートしたファイルを結合する方法を検討してください。

a クエリ例 config

`config
# 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 の UI の Home > Set Preferences > Analytics Driver から、OS に合う NetSuite ODBC（または JDBC）ドライバーをダウンロードします。案内に従ってインストールし、NetSuite サービスを指す新規 DSN（Data Source Name）を設定します。
接続の確立: 好みの 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」権限を有効化してください。あわせて、以下のレコードへの閲覧権限が必要です：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 環境では、特定の法的主体に限定しパフォーマンスを高めるため、subsidiary ID で絞る WHERE 句を必ず含めてください。
カスタム承認ワークフロー: ここでのクエリは Vendor Bill の標準フィールド「Approval Status」を前提としています。SuiteFlow やスクリプトで承認をカスタムフィールド/レコードにしている場合、approvalstatus に関し SystemNote を参照する箇所を大幅に修正する必要があります。

a クエリ例 sql

`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 機能の有効化: 管理者が SuiteTalk Web Services を有効化します。Setup > Company > Enable Features > SuiteCloud に移動し、SUITEANALYTICS WORKBOOK と SUITETALK (WEB SERVICES) にチェックを入れます。
Integration レコードと Access Token の作成: Setup > Integration > Manage Integrations > New で新しい Integration を作成し、TOKEN-BASED AUTHENTICATION と TBA: AUTHORIZATION FLOW を有効化します。CONSUMER KEY と CONSUMER SECRET を控えます。続いて Setup > Users/Roles > Access Tokens > New で対象ユーザー/ロールの Access Token を作成し、作成した Integration に紐付けます。TOKEN ID と TOKEN SECRET も控えてください。
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 が生成されます。構造化されたイベントログが出力されます。
データ変換ロジック: スクリプトは NetSuite の生データを必要なイベントログ形式へ自動変換します。'Approval Status' の変更をシステムノートから解析して 'Invoice Approved' を判定し、支払日と期日を比較して 'Late Payment Identified' のような派生イベントも算出します。
アップロード準備: 生成された CSV は process mining ツールへ直接アップロード可能な形式です。列ヘッダー（Invoice, ActivityName, EventTime など）がターゲットアプリの期待するスキーマと一致しているか確認してください。

設定

認証: このスクリプトは OAuth 1.0 の Token-Based Authentication (TBA) を使用します。NetSuite のサーバー間連携の標準方式です。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。

a クエリ例 python

`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: Label Start Date, Type Date。
- custscript_pm_end_date: Label End Date, Type Date。
- custscript_pm_folder_id: Label Target Folder ID, Type Integer Number。出力ファイルを保存する File Cabinet フォルダの内部IDです。
- custscript_pm_subsidiary_id: Label Subsidiary ID (Optional), Type 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 へのアップロード準備が整いました。

設定

前提条件: SuiteScript の作成・実行権限があり、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 スクリプトの方が適している場合があります。業務時間外にスケジュール実行し、影響を最小限に抑えてください。
カスタムフィールド: 承認や重要データをカスタムフィールド/レコードで管理している場合は、スクリプト内の Saved Search のフィルターや列に、それらの内部 ID を含めるよう調整してください。

a クエリ例 javascript

`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 };
});
`

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

買掛金（AP）請求書処理用データテンプレート

買掛金の請求書処理の属性

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

データ抽出ガイド

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

ステップ

設定

a クエリ例 config

SuiteQL Query via SuiteAnalytics Connect (ODBC/JDBC)

ステップ

設定

a クエリ例 sql

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

ステップ

設定

a クエリ例 python

Server-Side SuiteScriptによる自動データエクスポート

ステップ

設定

a クエリ例 javascript

今すぐ始めませんか？

主導権を取り戻す：買掛金請求書を今すぐ最適化