> 継続的なプロセス改善 > 調達から支払いまで：請求書処理 > NetSuite > データテンプレート

調達から支払いまで：請求書処理のデータテンプレート

NetSuite

調達から支払いまで：請求書処理の属性 (19) 調達から支払いまで：請求書処理のアクティビティ (14) 抽出ガイド (3)

調達から支払いまで：請求書処理のデータテンプレート

このテンプレートでは、NetSuiteで請求書処理を分析するために必要なデータを収集する方法を詳しく説明します。必須のデータ項目、主要なプロセスステップ、データを効率的に抽出するための手順をまとめています。このテンプレートに沿って準備すれば、イベントログを漏れなく整え、プロセスマイニング分析を始められます。

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

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

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

調達から支払いまで：請求書処理の属性

調達から支払いまでの請求書処理を詳細に分析し、必要なコンテキストを漏れなく把握するため、イベントログに含めることを推奨するデータ項目です。

5 必須 7 推奨 7 任意

	名前	説明
	請求書番号 InvoiceNumber	システム内で仕入先請求書を一意に識別する番号です。
説明請求書番号は主要なケース識別子として機能し、1件の仕入先請求書に関連するすべてのアクティビティとイベントを、作成から最終支払いまで関連付けます。この属性は、各請求書のエンドツーエンドの経過を追跡するうえで欠かせません。プロセス分析では、この番号を使って請求書のライフサイクル全体を再構成できます。関連するすべてのアクティビティを共通の識別子でグループ化することで、アナリストはプロセスフローを可視化し、サイクル時間を測定し、個々の請求書に影響するばらつきやボトルネックを特定できます。重要な理由各請求書が支払いプロセスを進む経過を追跡するための基本キーであり、ケース単位の詳細な分析を可能にします。入手先通常、NetSuiteの仕入先請求書レコードにある「Transaction ID」または「Invoice #」フィールドです。例 INV-0012345789-ABC-654202405-101
	アクティビティ ActivityName	実行された業務プロセスのステップ名です。
説明この属性は、請求書処理のライフサイクルで発生した特定のアクションまたはイベントを示します。たとえば、「Vendor Bill Created」、「Bill Approved」、「Bill Paid In Full」などです。各アクティビティは、プロセス上の個別の時点を表します。アクティビティはプロセスマップを構成する基本要素です。アクティビティの順序と頻度を分析すると、実際のプロセスフローを理解し、標準手順からの逸脱を特定し、繰り返し発生するやり直しループや非効率なステップを明らかにできます。重要な理由プロセスマップの基盤となり、請求書ライフサイクルにおけるイベントの順序を可視化・分析できます。入手先システムログ、仕入先請求書レコードのステータス変更、またはシステム履歴に記録された特定のユーザーアクションから取得します。例仕入先請求書の作成仕入先請求書の承認支払いバッチへの登録
	ソースシステム SourceSystem	データの取得元システムを識別します。
説明この属性は、イベントデータが生成されたソースアプリケーションを示します。このプロセスでは通常、「NetSuite」です。複数のシステムを連携している環境では、データの系譜を把握し、データ品質を評価するうえで欠かせないフィールドです。システムごとに発生したアクティビティを区別でき、エンドツーエンドのプロセスを全体的に把握する際にも役立ちます。重要な理由データの出所に関する情報を提供します。複数システムの環境で、問題の切り分けやデータ検証を行ううえで重要です。入手先通常、データ抽出時に追加される固定値（「NetSuite」）です。例 NetSuite
	最終データ更新日時 LastDataUpdate	ソースシステムからデータが最後に更新または抽出された日時です。
説明この属性は、ソースシステムから直近にデータを抽出した日時を示します。分析対象データの鮮度を把握するための情報です。最終データ更新日時を把握することで、現在表示している情報が最新かどうかを確認できます。データの遅延を適切に見積もり、データの経過時間を把握したうえで意思決定できるようになります。重要な理由データの鮮度をアナリストに伝え、意思決定時にデータの適時性を把握できるようにします。入手先データの抽出およびロード（ETL）処理中に生成され、追加される日時情報です。例 2024-05-21T02:00:00Z
	開始時刻 EventTime	アクティビティが発生した日時です。
説明この属性は、特定のアクティビティまたはイベントがシステムに記録された正確な日時を取得します。プロセス全体を時系列で把握するための情報です。日時情報は、時間に基づくプロセス分析の基本です。アクティビティ間の所要時間の計算、ケース全体のサイクル時間の測定、サービスレベル合意に対するパフォーマンスの分析に使用します。正確な日時情報は、ボトルネックを特定し、プロセスの遅延を理解するうえで欠かせません。重要な理由すべての所要時間、サイクル時間、パフォーマンス指標を計算するために必要な時系列データを提供し、時間軸に基づくプロセス分析の基盤となります。入手先仕入先請求書レコードおよび関連取引レコードの日付フィールドやシステムログから取得します。たとえば、「Date Created」、「Last Modified Date」、「approval date」フィールドなどです。例 2023-04-15T09:00:00Z2023-04-16T14:30:15Z2023-04-20T11:05:45Z
	仕入先名 VendorName	請求書を提出した仕入先またはサプライヤーの名称です。
説明この属性は、請求書に関連付けられた仕入先の正式名称を示します。仕入先は、調達から支払いまでのプロセスにおける主要な対象です。仕入先別にプロセスを分析することは、特定の仕入先に関する問題を特定するうえで重要です。どの仕入先の承認時間が最も長いか、やり直しが必要な請求書を最も多く提出しているのはどこか、どの仕入先への支払いが最も頻繁に遅れているか、といった問いに答えられます。この分類は、取引先関係の管理とパフォーマンス分析の基盤となります。重要な理由プロセスデータを仕入先別に分類し、仕入先固有のボトルネック、支払いパフォーマンス、コンプライアンス上の問題を特定できます。入手先仕入先請求書レコードの「Vendor」または「Supplier」フィールドから取得し、仕入先マスターデータに関連付けます。例 Office Supplies Inc.Global Tech ServicesCreative Marketing Agency
	承認者 Approver	請求書を承認または却下する担当ユーザーです。
説明この属性は、請求書の承認ステップを実行した従業員または管理者を示します。複数の承認レベルがあるワークフローでは、直近または最終の承認者を記録する場合があります。承認者を追跡することは、承認サイクルを分析するうえで欠かせません。個人または部門ごとの平均承認時間を確認し、承認プロセスのボトルネックを特定できます。この情報を使って業務量を平準化したり、追加のトレーニングを実施したりできます。重要な理由承認プロセスのボトルネックを特定し、個人または部門別にパフォーマンスを分析することで、対象を絞った改善が可能になります。入手先仕入先請求書取引に関連するワークフローまたは承認履歴ログから取得します。「System Notes」またはカスタム承認ログに記録されている場合があります。例 John SmithJane Doe財務部門責任者
	支払期日 PaymentDueDate	合意した支払条件を満たすために、請求書を支払う必要がある日付です。
説明支払期日は、請求書の日付と仕入先との間で合意した支払条件（Net 30、Net 60など）に基づいて計算されます。支払いを実行するための主要な期限です。この日付は、取引先との関係や財務健全性に関わる重要なKPIである、期日どおりの支払いパフォーマンスを測定するうえで欠かせません。実際の支払日と支払期日を比較することで、支払いの適時性を追跡し、支払いが継続的に遅れている仕入先を特定し、キャッシュフローをより適切に管理できます。重要な理由期日どおりの支払いパフォーマンスを測定する基準となり、取引先との関係に直接影響するほか、遅延損害金の回避にも役立ちます。入手先仕入先請求書レコードの「Due Date」フィールドです。通常は「Terms」フィールドに基づいて自動計算されます。例 2023-05-152023-06-302023-07-01
	期限内支払済み IsPaidOnTime	請求書が支払期日までに支払われたかを示すフラグです。
説明この計算済みブール型属性は、「Bill Paid In Full」アクティビティのタイムスタンプと「Payment Due Date」を比較します。期限内に支払われていれば「true」、それ以外は「false」です。この属性は、「期限内支払率」KPIを直接支えます。これは、財務規律と取引先との関係管理を測る重要な指標です。支払遅延を簡単に抽出・分析し、承認の遅れや支払処理スケジュールの問題など、根本原因を特定できます。重要な理由支払条件の遵守状況を直接測定します。取引先との関係維持、違約金の回避、財務計画に欠かせない指標です。入手先計算フィールドです。最終支払アクティビティのタイムスタンプが「PaymentDueDate」以下の場合はTRUEです。例 truefalse
	自動照合済み IsAutoMatched	請求書が手作業なしで発注書と自動的に照合されたかを示すフラグです。
説明このブール型属性は、定義済みのルールと許容範囲に基づき、システムが請求書を発注書および入荷記録（3-way matchingの場合）と自動的に照合できたかを示します。「true」は、手作業を介さない照合プロセスであることを意味します。この属性は、「請求書自動照合率」KPIの基礎となります。自動照合率が高いことは、請求書処理システムの効率と自動化の水準が高いことを示す重要な指標です。「false」となったケースを分析すると、照合に失敗した理由や自動化を改善できる機会を特定できます。重要な理由請求書照合プロセスの自動化と効率を直接測定し、手作業を減らせる機会を明らかにします。入手先通常は派生属性です。「Matching Discrepancy Identified」アクティビティがないこと、または短時間でシステムユーザーによってBillが作成・承認されたことから推定できます。例 truefalse
	請求書ステータス InvoiceStatus	請求書の現在の処理ステータスです。
説明この属性は、ライフサイクル上の仕入先請求書の現在の状態を示します。たとえば、「Pending Approval」、「Approved」、「Paid in Full」、「Rejected」などです。ステータスにより、任意の時点で請求書がプロセスのどこにあるかを把握できます。運用ダッシュボードで現在の作業量と処理量を監視する際に使用します。ステータスの遷移を分析することは、プロセスマイニングの重要な要素でもあります。多くの場合、アクティビティを定義する基礎となるためです。重要な理由請求書の進捗状況をリアルタイムで把握でき、作業量の管理と処理量の分析に役立ちます。入手先 NetSuiteの仕入先請求書レコードにある「Status」フィールドです。例未処理承認待ち承認済み全額支払済み
	請求書金額 InvoiceAmount	仕入先請求書の合計金額です。
説明この属性は、税金やその他の費用を含む請求書記載の支払総額を示します。各ケースにおける主要な財務指標です。請求書金額は、金額帯別の請求書分類（高額・低額など）に使用し、処理時間や承認経路に違いがあるかを確認できます。また、財務報告、各段階にある請求書の金額計算、支払い遅延による財務的影響の分析にも欠かせません。重要な理由財務分析と金額に基づく分類を可能にし、高額請求書の優先順位付けやコスト要因の把握に役立ちます。入手先 NetSuiteの仕入先請求書レコードのヘッダーにある「Total」または「Amount」フィールドに該当します。例 1500.75250.0012500.50
	割引取得済み DiscountTaken	利用可能な早期支払割引を実際に取得したかを示すフラグです。
説明この計算済みブール型属性は、割引が利用可能な請求書が「Discount Date」までに支払われたかを確認します。割引を取得できた場合は「true」、機会を逃した場合は「false」です。この属性は、「早期支払割引取得率」KPIに欠かせません。財務部門が取り逃した節約額を定量化し、承認の遅れなど、支払条件のメリットを受けられなくするプロセス上のボトルネックを特定するのに役立ちます。重要な理由コスト削減の機会をどれだけ取得できているかを測定し、企業の利益に直接影響します。入手先計算フィールドです。「DiscountDate」があり、最終支払アクティビティがその日付以前に発生している場合はTRUEです。例 truefalse
	割引日 DiscountDate	請求書を早期支払割引の対象とするための支払期限です。
説明この属性は、支払条件（例：「2% 10、Net 30」）で定められた早期支払割引を利用するために、請求書を支払う必要がある日付を指定します。この日付は、「早期支払割引取得率」KPIの計算に欠かせません。この日付に対する実績を追跡することで、組織は取り逃した節約機会を特定し、取得できる割引を最大化するために支払戦略を改善できます。これにより、収益性に大きなプラスの影響を与えられる可能性があります。重要な理由早期支払割引の特定と取得における基準日であり、コスト削減と収益性に直接影響します。入手先請求書の日付とVendor Billレコードの「Terms」フィールドから算出されます。NetSuiteでは、この日付を「Discount Date」として計算します。例 2023-04-252023-05-10
	却下理由 RejectionReason	承認プロセスで請求書が却下された際に示された理由です。
説明承認者が請求書を却下する際は通常、「金額の誤り」、「重複請求書」、「発注書の欠落」などの理由を示します。この属性は、その理由を記録します。この情報は、プロセスの非効率について根本原因を分析するうえで重要です。却下理由を分類して傾向を追跡することで、特定の仕入先に関する問題やデータ入力ミスなど、共通する問題を特定し、やり直しや遅延を減らす是正措置を講じられます。重要な理由やり直しやプロセス上の問題の根本原因を直接把握でき、初回から正しく処理できる割合の向上に役立ちます。入手先通常、承認ワークフローで却下する際にメモまたはコメントフィールドへ入力します。「System Notes」またはカスタムフィールドに保存される場合があります。例数量が不正重複請求書発注書との価格不一致
	子会社 Subsidiary	組織内で請求書に対する責任を負う会社または法人です。
説明複数法人で構成される組織では、「子会社」属性によって、Vendor Billがどの法人に属するかを特定します。これは、NetSuite OneWorldアカウントにおける基本的な組織データです。子会社別にプロセスを分析すると、異なる事業部門や地域間で実績を比較できます。組織内で効率の高い部門やベストプラクティスを共有できる領域、特定のプロセス上の問題がある領域を特定するのに役立ちます。重要な理由組織内の異なる法人や事業部門間で、実績のベンチマークと分析を行えるようにします。入手先 NetSuite OneWorldアカウントのすべての取引レコードにある標準の「Subsidiary」フィールドです。例米国西部EMEA本社APACサービス
	支払いブロック理由 PaymentBlockReason	承認済み請求書の支払いがブロックされた理由です。
説明支払い承認済みの請求書でも、仕入先との紛争、納品物の品質問題、資金管理上の判断など、さまざまな理由で支払いブロックが設定される場合があります。この属性は、ブロックの具体的な理由を記録します。支払いブロックの理由と解消までの時間を分析することは、キャッシュフローの最適化と良好な取引先関係の維持に重要です。請求書が正常に処理され承認された後でも支払い遅延につながる、繰り返し発生する問題を特定できます。重要な理由承認済み請求書が支払われない理由を明らかにし、支払いを遅らせる業務上または財務上の問題を特定できます。入手先通常、仕入先請求書のカスタム「Payment Hold」または「Payment Block」チェックボックスと、対応する理由リストまたはテキストフィールドで管理します。例仕入先アカウント保留中品質検査待ちクレジットメモ待ち
	発注書番号 PurchaseOrderNumber	請求書に関連する発注書の識別番号です。
説明この属性は、仕入先請求書を、商品またはサービスの調達を承認した対応する発注書（PO）に関連付けます。請求書には、発注書に基づくものと、発注書に基づかないものがあります。発注書別に分析すると、請求書照合の効率を把握するための重要な情報が得られます。自動照合と手動対応の割合を確認し、請求書、発注書、入荷記録の間の不一致を特定できます。不一致率が高い場合、調達プロセスに問題がある可能性があります。重要な理由請求書を調達プロセスに関連付けます。請求書照合の効率と3者間照合のコンプライアンスを分析するうえで欠かせません。入手先仕入先請求書レコードで確認できます。通常は明細行または発注書に関連付けるヘッダーフィールドにあります。例 PO-005678PO-005891該当なし
	通貨 Currency	請求金額の通貨です。
説明この属性は、請求書の金額がどの通貨で表示されているかを指定します。例としてUSD、EUR、GBPなどがあります。複数の国で事業を展開する企業では、特に重要です。通貨は、すべての金額を解釈するために必要な情報です。分析では、財務データを正しく読み取り、異なる地域の財務指標を集計する際に適切な通貨換算を行えるようにします。重要な理由すべての財務金額に必要な情報を付加し、複数通貨環境で正確な財務分析を行えるようにします。入手先 Vendor Billレコードの「Currency」フィールドです。通常はVendorマスターレコードから初期設定されます。例 USDEURGBP

必須推奨任意

調達から支払いまで：請求書処理のアクティビティ

請求書ワークフローを正確に発見し、ボトルネックを特定するため、イベントログに記録する主要なプロセス手順とマイルストーンです。

5 推奨 9 任意

	アクティビティ	説明
	仕入先支払いの作成	仕入先請求書を決済する支払い取引が作成されたことを示します。請求書に関連付けられたVendor Paymentレコードの作成から取得する明示的なイベントです。
重要な理由支払いが実行されたことを示します。期日どおりの支払い分析とキャッシュフロー予測に欠かせないステップであり、プロセス終了前の重要なマイルストーンです。入手先 Vendor Payment取引レコードの作成日から取得します。支払いレコードの「Apply」サブリストには、支払い対象の仕入先請求書への参照があります。取得 Vendor Payment取引の作成日時。イベントタイプ explicit
	仕入先請求書の作成	このアクティビティは、NetSuiteで仕入先請求書レコードが作成されたことを示し、請求書処理の開始点となります。仕入先請求書取引レコードの作成日から取得します。
重要な理由これは請求書ライフサイクルにおける主要な開始イベントです。このアクティビティから他のアクティビティまでの時間を分析すると、総処理時間を把握し、初期データ入力の遅延を明らかにできます。入手先仕入先請求書レコードの「Date Created」または取引日フィールドから取得します。各仕入先請求書には、一意の内部IDと取引番号があります。取得仕入先請求書取引の作成日時。イベントタイプ explicit
	仕入先請求書の全額支払い完了	仕入先請求書の全額支払いが完了し、ステータスが更新されたことを示します。プロセスが正常に完了した状態であり、請求書自体のステータス変更から推定します。
重要な理由請求書ライフサイクルにおける主要な正常終了イベントです。この状態に到達するまでの総時間を測定すると、プロセスのエンドツーエンドのサイクル時間を把握できます。入手先仕入先請求書レコードのシステムノートまたは監査証跡から、ステータスが「Paid in Full」に変わった日時を取得します。取得仕入先請求書のステータスが「Paid in Full」に変わった日時。イベントタイプ inferred
	仕入先請求書の承認	仕入先請求書の最終承認を示し、支払いを可能にします。通常は、システムの承認ワークフローでステータスが明示的に「Approved」に変わったことから取得する重要なマイルストーンです。
重要な理由支払いプロセスを進めるための重要なマイルストーンです。ここでの遅延は一般的なボトルネックとなるため、支払いの適時性とキャッシュフローを管理するには、このアクティビティの追跡が欠かせません。入手先仕入先請求書のシステムノートまたは監査証跡から、「Approval Status」フィールドが「Approved」に設定された日時を取得します。取得仕入先請求書の監査証跡でステータスが「Approved」に変わった日時。イベントタイプ explicit
	総勘定元帳への仕訳計上	承認済みの仕入先請求書が総勘定元帳に反映された時点を示します。標準的なNetSuite設定では、請求書の最終承認時に自動的に発生します。
重要な理由負債が正しく認識されていることを確認する、財務管理上の重要なポイントです。計上前の支払いなどの逸脱を監視することは、コンプライアンス分析に欠かせません。入手先仕入先請求書の「Posting」フラグがtrueに設定された状態です。通常、計上は承認と同期して行われるため、日時には承認イベントの日付を使用できます。取得総勘定元帳への計上を開始する最終承認アクションの日時。イベントタイプ explicit
	クレジットメモの適用	仕入先クレジットメモを請求書に適用し、未払い額を減らしたことを示します。Vendor Credit取引の適用レコードから取得する明示的なイベントです。
重要な理由現金による直接支払いを伴わずに請求書を決済する代替経路を示します。クレジットメモが頻繁に発生する場合、当初の発注精度や仕入先のパフォーマンスに問題がある可能性があります。入手先 Vendor Creditと仕入先請求書を関連付ける適用レコードから取得します。適用日をイベント日時として使用します。取得 Vendor Credit取引を仕入先請求書に適用した日時。イベントタイプ explicit
	仕入先請求書の却下	承認者が仕入先請求書を却下し、処理中のキューから外れた状態です。明示的な「Rejected」へのステータス変更から取得し、再申請されない限り通常は終端状態となります。
重要な理由重複請求書や誤った仕入先情報など、プロセス上の問題を明らかにします。却下の頻度と理由を追跡することで、初回からの正確性を高め、無駄な作業を減らせます。入手先仕入先請求書のシステムノートまたは監査証跡から、「Approval Status」フィールドが「Rejected」に設定された日時を記録します。取得仕入先請求書の監査証跡でステータスが「Rejected」に変わった日時。イベントタイプ explicit
	仕入先請求書を修正のために差し戻し	承認者または確認担当者が、修正のため請求書を起票者へ差し戻したときに発生します。通常は、ワークフロー上で請求書のステータスが「Pending Approval」から「Pending Submission」へ戻るなど、後戻りする変更から推定します。
重要な理由処理時間を大幅に延ばし、手作業を増やすやり直しループを特定します。これを追跡することで、誤った勘定科目コードやデータ入力ミスなど、エラーの一般的な原因を明らかにできます。入手先仕入先請求書のシステムノートまたは監査証跡から、ステータスの後戻りや特定の「Rework」ステータスを探して推定します。取得承認ワークフローで後戻りが発生したことを示すステータス変更の日時。イベントタイプ inferred
	承認のために仕入先請求書を送信	作成された仕入先請求書が正式に承認ワークフローへ送信された時点を示します。通常は、請求書のステータスが「Open」または「Pending Submission」から「Pending Approval」に変わったことから推定します。
重要な理由承認サイクルを開始します。このイベントから「Bill Approved」または「Bill Rejected」までの時間を測定することは、請求書承認サイクル時間分析ダッシュボードに欠かせません。入手先仕入先請求書レコードのシステムノートまたは監査証跡から推定します。具体的には、「Approval Status」フィールドの変更を追跡します。取得仕入先請求書の監査証跡でステータスが「Pending Approval」に変わった日時。イベントタイプ inferred
	支払いバッチへの登録	承認済み請求書が選択され、後で実行する支払いバッチに含められた状態です。請求書をVendor Payment Batchに追加する、または「Pay Bills」ページで処理する明示的なアクションです。
重要な理由承認済みの負債が、予定された現金支出へ移行したことを示します。承認から登録までの遅延を分析すると、資金管理方針や支払い実行プロセスの非効率を明らかにできます。入手先独立したイベントとして取得するのが難しい場合があります。多くの場合、支払い作成プロセスの一部として発生します。請求書を含む支払いバッチレコードの作成日から推定できる場合があります。取得請求書を参照する支払いバッチレコードの作成日時。イベントタイプ inferred
	支払いブロックの解除	請求書の支払いブロックが解除され、再び支払い可能になった状態です。「Payment Hold」チェックボックスの選択が解除されたこと、または「Hold」状態から別のステータスへ変わったことから推定します。
重要な理由「Payment Block Set」からこのアクティビティまでの時間を測定すると、解消プロセスの効率を把握できます。ブロックの一般的な原因を特定し、解除を効率化するのに役立ちます。入手先「Payment Hold」チェックボックスの選択が解除されたこと、または仕入先請求書のカスタムステータスフィールドが更新されたことを監査証跡から推定します。取得「Payment Hold」または同様のフィールドが解除された日時。イベントタイプ inferred
	支払いブロックの設定	承認済み請求書に支払いブロックが設定され、支払いができなくなった状態です。通常は、特定のチェックボックスが選択されたこと、またはカスタムの「Hold」ステータスが適用されたことから推定します。
重要な理由支払いブロック解消分析ダッシュボードに欠かせないアクティビティです。承認から支払い可能な状態になるまでの遅延を特定し、取引先との関係に悪影響を及ぼす要因を明らかにします。入手先仕入先請求書取引の「Payment Hold」チェックボックスまたはカスタムステータスフィールドの監査証跡から推定します。取得「Payment Hold」または同様のフィールドが変更された日時。イベントタイプ inferred
	早期支払い割引の適用漏れ	早期支払い条件が設定された請求書について、割引期間内に支払いが実行されなかったことを示す計算イベントです。支払日と割引適用期限を比較して導出します。
重要な理由失われた節約額を定量化し、「Early Payment Discount Capture Rate」KPIを直接支援します。割引を受けられない原因となっているプロセス上またはキャッシュフロー上の問題を特定できます。入手先計算イベントです。適用されたVendor Payment取引の「Date」と、元の仕入先請求書レコードの「Discount Date」フィールドを比較する必要があります。取得 Vendor Paymentの日付と仕入先請求書の割引日を比較します。支払日が割引日より後の場合にイベントが発生します。イベントタイプ calculated
	照合不一致の特定	発注書との照合が必要な請求書が自動照合ルールに適合せず、手動確認が必要になったときに発生します。通常は、請求書が特定の「Matching Hold」または「Discrepancy」ステータスになったことから推定します。
重要な理由手作業によるやり直しにつながる調達および入荷プロセスの非効率を明らかにします。請求書照合効率ダッシュボードと「Matching Discrepancy Rework Rate」KPIを直接支援します。入手先仕入先請求書の保留または例外を示すステータス変更、または承認前に大幅な手動編集が必要だった発注書関連請求書を特定することで推定します。取得ステータスが「hold」または「mismatch」に変わった日時。カスタムフィールドやワークフローの分析が必要になる場合があります。イベントタイプ inferred

推奨任意

抽出ガイド

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

ステップ

NetSuiteにログイン：TransactionタイプのSaved Searchを作成・実行する権限を持つロールで、NetSuiteアカウントにアクセスします。
Saved Searchへ移動：Reports > Saved Searches > All Saved Searches > Newの順に選択します。
検索タイプを選択：新しい検索タイプの一覧から「Transaction」を選択します。
検索条件を定義：「Criteria」タブで、データを絞り込むために次のフィルターを設定します。
- 「Type」を「is any of」に設定し、「Vendor Bill」「Vendor Payment」「Vendor Credit」を指定します。請求書ライフサイクルに関係するすべての取引タイプを取得できます。
- 「Main Line」を「is」「true」に設定します。明細行ごとの重複を避け、ヘッダーレベルの情報に絞り込みます。
- 「Date」フィルター（例：「Date Created」）を追加し、直近6か月などの期間を指定します。初期データセットを扱いやすい規模に保てます。例：「is within」「last fiscal year」。
- （任意）組織で複数の子会社を使用している場合は、「Subsidiary」フィルターを追加します。
結果列を指定：「Results」タブに移動します。ここが最も重要なステップです。イベントログに必要なすべての列を追加します。異なる業務イベントのタイムスタンプ、ステータス、分析軸となる属性を含むフィールドを追加してください。推奨列の一覧とNetSuiteフィールドIDについては、「query」セクションを参照してください。
追加オプションを設定：「Available Filters」タブで「Date」をフィルターとして追加することを検討します。検索定義を編集せずに、実行時の日付範囲を変更できるようになります。
検索を保存して実行：「ProcessMind_P2P_Invoice_Extraction」など、内容が分かる名前をSaved Searchに付け、「Save & Run」をクリックします。
結果をエクスポート：検索結果が表示されたら、「Export - CSV」アイコンをクリックしてCSVファイルをダウンロードします。
データを変換：エクスポートしたファイルは、取引ごとに1行のフラットな表です。各行が1つのアクティビティを表すイベントログ形式に変換する必要があります。Python（pandasなど）やデータ準備ツールを使って、データをピボットします。CSVの各行について、関連する日付列（例：「Date Created」「Date Approved」「Payment Date」）ごとに複数の出力行を作成します。各行は、対応する日付を「EventTime」とする「Vendor Bill Created」「Bill Approved」「Vendor Payment Created」などのアクティビティを表します。
派生イベントを計算：変換時に派生イベントを計算します。たとえば「Early Payment Discount Missed」アクティビティを生成するには、「Payment Date」と「Discount Due Date」を比較します。支払日が割引日より後であれば、そのイベントの行を作成します。
イベントログを仕上げる：最終的に変換したCSVファイルに、必須列であるInvoiceNumber、ActivityName、EventTime、SourceSystem、LastDataUpdateと、その他の推奨属性が含まれていることを確認します。これで、プロセスマイニングツールにアップロードできる状態になります。

設定

検索タイプ：Transaction。この検索タイプでは、Vendor Bill、Vendor Payment、クレジットメモにアクセスできます。
Criteria - Main Line：各取引のヘッダーレベルの情報だけを取得し、取引明細行によるイベントの重複を防ぐため、「True」に設定します。
Criteria - Transaction Type：請求書の受領から支払、クレジットの適用まで、ライフサイクル全体を取得するため、「Vendor Bill」「Vendor Payment」「Vendor Credit」で絞り込みます。
Criteria - Date Range：「Date Created」フィールドを使って、通常は3～12か月など、扱いやすい期間に絞り込みます。パフォーマンスとデータの関連性を維持できます。
Results - Columns：すべてのイベントのタイムスタンプと属性を取得できるよう、十分な数の列を追加してください。作成日、ステータスフィールド、承認日、支払日、支払期日、関連する取引の詳細などが含まれます。全項目はqueryセクションを参照してください。
権限：検索を実行するユーザーロールには、Vendor Bill、Vendor Payment、Vendor Credit、およびVendorやEmployeeなどの関連レコードを表示する権限が必要です。
パフォーマンス：数百万件の取引がある場合は、タイムアウトを避けるため、利用の少ない時間帯に検索を実行するか、四半期単位などの短い期間に分けてエクスポートしてください。

a サンプルクエリ config

Below is the configuration for the NetSuite Saved Search, detailing the criteria (filters) and the result columns needed to extract the data.

**Search Type**: Transaction

**Criteria (Filters)**:
| Field | Description | Value |
|---|---|---|
| Type | Transaction Type | is any of: Vendor Bill, Vendor Payment, Vendor Credit |
| Main Line | Main Line Filter | is true |
| Date Created | Date Filter | is within: [Specify Date Range, e.g., last 6 months] |
| Subsidiary | Subsidiary Filter | is: [Your Subsidiary Name] (if applicable) |

**Results (Columns)**:
| Column Label | Field ID | Description |
|---|---|---|
| InvoiceNumber | tranid | Case ID. The unique number for the bill, payment, or credit. |
| InternalID | internalid | Internal system ID for joining. |
| DateCreated | datecreated | Timestamp for 'Vendor Bill Created' activity. |
| VendorName | entity | Required attribute 'Vendor Name'. |
| InvoiceAmount | amount | Required attribute 'Invoice Amount'. |
| DueDate | duedate | Required attribute 'Payment Due Date'. |
| Approver | approver | Recommended attribute 'Approver'. May require drilling into related fields. |
| ApprovalStatus | approvalstatus | Field for inferring activities like 'Bill Submitted For Approval', 'Bill Approved', 'Bill Rejected'. |
| SystemNotes_ApprovalStatus_Date | formuladate | Formula: `NS_CONCAT('systemnotes.newvalue=''Approved''')` to get the approval date. Similar formulas needed for other statuses. |
| PaymentDueDate | duedate | Attribute for 'Payment Due Date'. |
| Terms | terms | Used with Discount Date to derive 'Early Payment Discount Missed'. |
| DiscountDate | discountdate | The date by which payment must be made to receive a discount. |
| Status | statusref | The current status of the transaction, e.g., 'Open', 'Paid in Full'. |
| DatePostedToGL | trandate | Timestamp for 'Bill Posted To GL', typically the transaction date. |
| AppliedToTransaction | appliedtotransaction | Links payments/credits to the original bill. |
| ApplyingTransaction | applyingtransaction | Links bills to their payments/credits. |
| PaymentDate | applyingtransaction.trandate | The date of the payment transaction. Used for 'Vendor Payment Created' and 'Bill Paid In Full' events. |
| CreditMemoDate | applyingtransaction.trandate | The date a credit memo was applied. |
| PaymentHold | custbody_payment_hold | Placeholder for a custom 'Payment Block Set' / 'Released' checkbox. Track changes via System Notes. |
| MatchingStatus | custbody_matching_status | Placeholder for a custom field to identify 'Matching Discrepancy Identified'. |
| IsAutoMatched | custbody_is_auto_matched | Placeholder for a custom field for the 'Is Auto Matched' attribute. |

ステップ

前提条件：NetSuiteアカウントでSuiteAnalytics Connectモジュールが有効になっていることを確認します。NetSuiteホームのダッシュボードで「Settings」>「Set Up SuiteAnalytics Connect」を開き、ご利用のOSに対応するODBCまたはJDBCドライバーをダウンロードしてインストールします。
ドライバーを設定：ODBCドライバー用の新しいDSN（Data Source Name）を設定するか、JDBCドライバーの接続プロパティを設定します。接続には、Service Host、Port、Data Source、Account ID、使用するRole IDが必要です。
接続を確立：DBeaver、DBVisualizer、Microsoft ExcelなどのSQLクライアントツールを使い、設定したドライバーと認証情報でNetSuiteデータソースに接続します。認証情報に関連付けられたロールには、取引レコードとエンティティレコードへのアクセス権が必要です。
SQLクエリを準備：このドキュメントの「query」セクションに記載された完全なSQLクエリをコピーします。このクエリは、請求書処理分析に必要なすべてのアクティビティと属性を抽出するよう設計されています。
クエリパラメーターをカスタマイズ：実行前に、クエリ内のプレースホルダーを変更します。[START_DATE]と[END_DATE]を希望する日付範囲（例：「2023-01-01」）に置き換えます。複数の子会社を運用している場合は、[Your_Company_Subsidiary_ID]を分析対象の子会社の正しい数値IDに置き換えます。
カスタマイズに対応：「Matching Discrepancy Identified」や「Payment Block Set」などのアクティビティに関するカスタムフィールドのコメントを確認します。フィールド名（例：custbody_approval_status、custbody_payment_hold）を、組織固有のNetSuite設定に合わせて変更します。
クエリを実行：接続したSQLクライアントで、カスタマイズ済みのSQLクエリを実行します。実行時間は、日付範囲とNetSuiteアカウント内のデータ量によって異なります。
結果を確認：クエリが完了したら、返されたデータの列と行が想定どおりか簡単に確認します。さまざまなアクティビティと属性が含まれていることを確認してください。
CSVにエクスポート：SQLクライアントから結果セット全体をCSVファイルにエクスポートします。特殊文字の問題を防ぐため、UTF-8エンコーディングを使用してください。
アップロードの準備：CSVファイルに必須ヘッダー（InvoiceNumber、ActivityName、EventTime、SourceSystem、LastDataUpdate）があり、「EventTime」列が一貫したタイムスタンプ形式（例：YYYY-MM-DD HH:MI:SS）になっていることを確認します。これで、プロセスマイニングツールにアップロードできます。

設定

SuiteAnalytics Connectライセンス：この抽出方法には、有効なNetSuite SuiteAnalytics Connectモジュールのライセンスが必要です。ライセンスにより、必要なドライバーとバックエンドデータベースへのアクセスが提供されます。
ユーザーロールの権限：接続に使用するNetSuiteロールには、十分な権限が必要です。最低限、Transactions（Vendor Bill、Vendor Payment、Vendor Credit）、Lists > Entities、Setup > System Notesに対する「View」アクセス権が必要です。
日付範囲：[START_DATE]と[END_DATE]パラメーターを使い、特定の日付範囲でクエリを絞り込むことが重要です。初期分析では、データ量とパフォーマンスを管理しやすい3～6か月の範囲を推奨します。複数年分のデータを1回のクエリで取得することは推奨しません。
子会社フィルター：NetSuite OneWorldアカウントでは、単一の法人に対応する一貫したプロセスのデータを取得するため、子会社（subsidiary_id）での絞り込みが欠かせません。プレースホルダー[Your_Company_Subsidiary_ID]を置き換えてください。
カスタムフィールド：このクエリでは、ステータス追跡に標準フィールドと一般的なカスタムフィールドを組み合わせて使用することを想定しています。承認ステータス、支払保留、照合情報について、自社のカスタムフィールドIDを特定して置き換えてください。対象箇所はクエリ内のコメントに記載されています。

a サンプルクエリ sql

WITH BaseInvoices AS (
    SELECT 
        T.transaction_id,
        T.tranid AS InvoiceNumber,
        E.companyname AS VendorName,
        T.foreignTotal AS InvoiceAmount,
        T.dueDate AS PaymentDueDate,
        T.createdDate,
        T.status AS InvoiceStatus,
        T.approvalstatus,
        T.tranDate,
        -- Placeholder for IsAutoMatched logic. Adjust based on your configuration.
        -- This might be a custom field on the bill or inferred from other data.
        'No' AS IsAutoMatched 
    FROM 
        Transaction T
    JOIN 
        Entity E ON T.entity_id = E.entity_id
    WHERE 
        T.type = 'VendBill'
        AND T.createdDate BETWEEN TO_DATE('[START_DATE]', 'YYYY-MM-DD') AND TO_DATE('[END_DATE]', 'YYYY-MM-DD')
        AND T.subsidiary_id = [Your_Company_Subsidiary_ID]
),
Payments AS (
    SELECT 
        ATL.prev_tran_id AS bill_id,
        MAX(P.trandate) AS final_payment_date
    FROM
        Transaction P
    JOIN 
        TransactionLine APL ON P.transaction_id = APL.transaction_id
    JOIN
        AppliedToTransactionLink ATL ON APL.transactionline_id = ATL.appliedtolink_id
    WHERE P.type = 'VendPymt'
    GROUP BY ATL.prev_tran_id
)
-- 1. Vendor Bill Created
SELECT 
    B.InvoiceNumber,
    'Vendor Bill Created' AS ActivityName,
    B.createdDate AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id

UNION ALL

-- 2. Bill Submitted For Approval / 5. Bill Approved / 6. Bill Rejected
SELECT 
    B.InvoiceNumber,
    CASE 
        WHEN SN.new_value_id = '2' THEN 'Bill Approved' -- '2' is typically the internal ID for 'Approved'
        WHEN SN.new_value_id = '3' THEN 'Bill Rejected' -- '3' is typically the internal ID for 'Rejected'
        WHEN SN.new_value_id = '1' AND SN.old_value_id = '2' THEN 'Bill Sent For Rework' -- Example: Approved back to Pending
        WHEN SN.new_value_id = '1' THEN 'Bill Submitted For Approval' -- '1' is 'Pending Approval'
    END AS ActivityName,
    SN.date AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    U.entityid AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    SystemNotes SN ON B.transaction_id = SN.transaction_id
JOIN
    User U ON SN.author_id = U.id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    SN.field = 'TRAN_APPROVALSTATUS' 
    AND SN.new_value_id IN ('1', '2', '3')

UNION ALL

-- 3. Matching Discrepancy Identified / 4. Bill Sent For Rework (via custom status)
-- This section is highly dependent on custom fields and workflow. Adjust field name as needed.
SELECT 
    B.InvoiceNumber,
    CASE 
        WHEN SN.new_value = 'Matching Hold' THEN 'Matching Discrepancy Identified'
        WHEN SN.new_value = 'Pending Submission' AND SN.old_value = 'Pending Approval' THEN 'Bill Sent For Rework'
    END AS ActivityName,
    SN.date AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    U.entityid AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    SystemNotes SN ON B.transaction_id = SN.transaction_id
JOIN
    User U ON SN.author_id = U.id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    SN.field = '[Your_Custom_Status_Field_ID]' -- E.g., 'CUSTBODY_INVOICE_STATUS'
    AND (SN.new_value = 'Matching Hold' OR (SN.new_value = 'Pending Submission' AND SN.old_value = 'Pending Approval'))

UNION ALL

-- 7. Payment Block Set / 8. Payment Block Released
-- Assumes a custom checkbox field 'custbody_payment_hold'. 'T' for True, 'F' for False.
SELECT 
    B.InvoiceNumber,
    CASE WHEN SN.new_value = 'T' THEN 'Payment Block Set' ELSE 'Payment Block Released' END AS ActivityName,
    SN.date AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    U.entityid AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    SystemNotes SN ON B.transaction_id = SN.transaction_id
JOIN
    User U ON SN.author_id = U.id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    SN.field = '[Your_Payment_Hold_Field_ID]' -- E.g., 'CUSTBODY_PAYMENT_HOLD'
    AND SN.new_value IN ('T', 'F')

UNION ALL

-- 9. Bill Posted To GL
-- This typically happens upon approval in standard configurations.
SELECT 
    B.InvoiceNumber,
    'Bill Posted To GL' AS ActivityName,
    SN.date AS EventTime, -- Using approval date as posting date
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    SystemNotes SN ON B.transaction_id = SN.transaction_id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    SN.field = 'TRAN_APPROVALSTATUS' 
    AND SN.new_value_id = '2' -- 'Approved'

UNION ALL

-- 10. Payment Scheduled In Batch / 12. Vendor Payment Created
-- Using Vendor Payment creation as the event for both.
SELECT 
    B.InvoiceNumber,
    'Vendor Payment Created' AS ActivityName, 
    P.createdDate AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN PayDates.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    AppliedToTransactionLink ATL ON B.transaction_id = ATL.prev_tran_id
JOIN 
    TransactionLine APL ON ATL.appliedtolink_id = APL.transactionline_id
JOIN
    Transaction P ON APL.transaction_id = P.transaction_id
LEFT JOIN
    Payments PayDates ON B.transaction_id = PayDates.bill_id
WHERE P.type = 'VendPymt'

UNION ALL

-- 11. Early Payment Discount Missed
-- This event is created if a payment exists and was made after the discount date.
SELECT
    B.InvoiceNumber,
    'Early Payment Discount Missed' AS ActivityName,
    T.discountDate + 1 AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    'No' AS IsPaidOnTime
FROM
    BaseInvoices B
JOIN 
    Transaction T ON B.transaction_id = T.transaction_id
JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    T.discountDate IS NOT NULL
    AND P.final_payment_date > T.discountDate

UNION ALL

-- 13. Bill Paid In Full
SELECT 
    B.InvoiceNumber,
    'Bill Paid In Full' AS ActivityName,
    SN.date AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    SystemNotes SN ON B.transaction_id = SN.transaction_id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE 
    SN.field = 'TRAN_STATUS' AND SN.new_value_id = 'B' -- 'B' is 'Paid In Full' for Vendor Bills

UNION ALL

-- 14. Credit Memo Applied
SELECT 
    B.InvoiceNumber,
    'Credit Memo Applied' AS ActivityName, 
    C.createdDate AS EventTime,
    'NetSuite' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.VendorName,
    B.InvoiceAmount,
    B.PaymentDueDate,
    NULL AS Approver,
    B.InvoiceStatus,
    B.IsAutoMatched,
    CASE WHEN P.final_payment_date <= B.PaymentDueDate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
FROM 
    BaseInvoices B
JOIN 
    AppliedToTransactionLink ATL ON B.transaction_id = ATL.prev_tran_id
JOIN 
    TransactionLine APL ON ATL.appliedtolink_id = APL.transactionline_id
JOIN
    Transaction C ON APL.transaction_id = C.transaction_id
LEFT JOIN
    Payments P ON B.transaction_id = P.bill_id
WHERE C.type = 'VendCred'

ステップ

NetSuite Web Servicesを有効化：管理者としてNetSuiteにログインします。Setup > Company > Enable Featuresに移動し、SuiteCloudサブタブでREST WEB SERVICESが有効になっていることを確認します。まだ有効でない場合はSUITEQLも有効にします。
Integration Recordを作成：Setup > Integration > Manage Integrations > Newに移動します。新しいIntegration Recordを作成し、Token-Based AuthenticationとOAuth 2.0を有効にします。レコードを保存し、生成されたConsumer KeyとConsumer Secretを安全に保管します。
Access Tokenを作成：Setup > Users/Roles > Access Tokens > Newに移動します。作成したIntegration Record、適切なUser、Vendor Bill、Vendor Payment、System Notesを表示できる権限を持つRoleを選択します。トークンを保存し、Token IDとToken Secretを安全に保管します。
Python環境を設定：Python 3がインストールされていることを確認します。ターミナルで次のコマンドを実行し、必要なライブラリをインストールします：pip install requests requests-oauthlib pandas。
Pythonスクリプトを設定：提供されたPythonスクリプトを、たとえばextract_netsuite_p2p.pyというファイルにコピーします。前の手順で取得した認証情報を使い、ns_account_id、consumer_key、consumer_secret、token_id、token_secretのプレースホルダーを置き換えます。
SuiteQLクエリをカスタマイズ：スクリプト内の大きなSuiteQLクエリ文字列を確認します。custbody_payment_holdや[Matching Discrepancy Status]など、カスタムフィールドとステータスのプレースホルダーに注意してください。NetSuiteの設定に合わせて変更します。また、初回のデータ取得量を制限するため、WHERE句の日付範囲フィルターを設定します。
スクリプトを実行：ターミナルで次のコマンドを実行します：python extract_netsuite_p2p.py。スクリプトがNetSuite APIに接続し、クエリを実行して、ページネーションを処理しながらデータを取得します。
抽出状況を監視：スクリプトはコンソールに進捗を表示し、取得したレコード数を示します。データ量が多い場合は、完了まで時間がかかることがあります。
出力ファイルを確認：スクリプトが完了すると、netsuite_invoice_event_log.csvというファイルが生成されます。このCSVファイルには、抽出したイベントログが含まれます。
アップロードの準備：CSVファイルを開き、必須ヘッダーであるInvoiceNumber、ActivityName、EventTime、SourceSystem、LastDataUpdateに沿ってデータが正しく構成されていることを確認します。これでProcessMindにアップロードできます。

設定

認証情報：NetSuiteのIntegration RecordとAccess Tokenから、Account ID、Consumer Key、Consumer Secret、Token ID、Token Secretを取得しておく必要があります。
ユーザーロールの権限：アクセストークンに関連付けられたNetSuiteロールには、少なくともVendor Bill、Vendor Payment、Vendor Credit、Entity（取引先の詳細）、System Noteに対する「View」レベルの権限が必要です。
日付範囲による絞り込み：パフォーマンスとデータ量を管理するため、SuiteQLクエリ内で日付範囲フィルターを適用することが重要です。提供されているクエリには、WHERE transaction.trandate >= '[YYYY-MM-DD]'というプレースホルダーが含まれています。まずは3～6か月分のデータから始めることを推奨します。
子会社による絞り込み：NetSuite OneWorldアカウントでは、すべての法人のデータを抽出しないよう、分析対象の子会社に対するフィルターを追加する必要があります。例：AND transaction.subsidiary = [Your Subsidiary ID]。
カスタムフィールドの調整：このクエリでは、支払ブロックを示すcustbody_payment_holdなど、カスタムフィールドやステータスで追跡することが多いアクティビティにプレースホルダーを使用しています。NetSuite環境で正しいフィールドIDを特定し、クエリを更新してください。
APIのレート制限：NetSuiteのAPI同時実行数とレート制限に注意してください。非常に大規模な抽出では、APIによる制限を避けるため、スクリプトに待機時間やバックオフ処理を追加する必要があります。

a サンプルクエリ python

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

class=class="hl-string">"hl-comment"># --- Configuration: Replace with your NetSuite Credentials ---
ns_account_id = os.environ.get(class="hl-string">'NS_ACCOUNT_ID', class="hl-string">'YOUR_ACCOUNT_ID')
consumer_key = os.environ.get(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'YOUR_CONSUMER_KEY')
consumer_secret = os.environ.get(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'YOUR_CONSUMER_SECRET')
token_id = os.environ.get(class="hl-string">'NS_TOKEN_ID', class="hl-string">'YOUR_TOKEN_ID')
token_secret = os.environ.get(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'YOUR_TOKEN_SECRET')

class=class="hl-string">"hl-comment"># Construct the NetSuite REST API URL
class=class="hl-string">"hl-comment"># Use .suitetalk.api for production, .connect.api for sandbox
url_base = fclass="hl-string">"https://{ns_account_id.lower().replace('_', '-')}.suitetalk.api.netsuite.com"
query_url = fclass="hl-string">"{url_base}/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- SuiteQL Query ---
class=class="hl-string">"hl-comment"># This query unions multiple subqueries to create a complete event log.
class=class="hl-string">"hl-comment"># You MUST customize placeholders like class="hl-string">'[Matching Discrepancy Status]' and class="hl-string">'custbody_payment_hold'.
suiteql_query = class="hl-string">"""
SELECT
    InvoiceNumber,
    ActivityName,
    EventTime,
    'NetSuite' AS SourceSystem,
    BUILTIN.TO_CHAR(CURRENT_TIMESTAMP, 'YYYY-MM-DD"T"HH24:MI:SS') AS LastDataUpdate,
    VendorName,
    InvoiceAmount,
    PaymentDueDate,
    Approver,
    InvoiceStatus,
    IsAutoMatched,
    IsPaidOnTime
FROM (
    -- 1. Vendor Bill Created
    SELECT
        transaction.tranid AS InvoiceNumber,
        'Vendor Bill Created' AS ActivityName,
        transaction.trandate AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        transaction.nextapprover AS Approver,
        transaction.status AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD') -- Set your date range

    UNION ALL

    -- 2. Bill Status Changes (Submitted, Approved, Rejected, Rework) from System Notes
    SELECT
        transaction.tranid AS InvoiceNumber,
        CASE
            WHEN systemnote.newvalue = 'Pending Approval' THEN 'Bill Submitted For Approval'
            WHEN systemnote.newvalue = 'Approved' THEN 'Bill Approved'
            WHEN systemnote.newvalue = 'Rejected' THEN 'Bill Rejected'
            -- Configure the 'old value' based on your rework process
            WHEN systemnote.newvalue = 'Open' AND systemnote.oldvalue = 'Pending Approval' THEN 'Bill Sent For Rework'
            ELSE NULL
        END AS ActivityName,
        systemnote.date AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        systemnote.name AS Approver,
        systemnote.newvalue AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        SystemNote ON systemnote.transactionid = transaction.id
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND systemnote.field = 'TRAN_APPROVALSTATUS' -- This is a common field, but may vary
        AND ActivityName IS NOT NULL
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 3. Matching Discrepancy Identified
    SELECT
        transaction.tranid AS InvoiceNumber,
        'Matching Discrepancy Identified' AS ActivityName,
        systemnote.date AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        NULL AS Approver,
        systemnote.newvalue AS InvoiceStatus,
        'No' AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        SystemNote ON systemnote.transactionid = transaction.id
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND systemnote.field = 'TRAN_STATUS' -- May also be approvalstatus
        AND systemnote.newvalue = '[Matching Discrepancy Status]' -- *** CONFIGURE THIS VALUE ***
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 7 & 8. Payment Block Set/Released (using a custom field)
    SELECT
        transaction.tranid AS InvoiceNumber,
        CASE
            WHEN systemnote.newvalue = 'T' THEN 'Payment Block Set'
            WHEN systemnote.newvalue = 'F' THEN 'Payment Block Released'
        END AS ActivityName,
        systemnote.date AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        systemnote.name AS Approver,
        transaction.status AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        SystemNote ON systemnote.transactionid = transaction.id
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND systemnote.field = 'CUSTBODY_PAYMENT_HOLD' -- *** CONFIGURE YOUR CUSTOM FIELD ID ***
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 9. Bill Posted to GL (assumed to occur at approval time)
    SELECT
        transaction.tranid AS InvoiceNumber,
        'Bill Posted To GL' AS ActivityName,
        systemnote.date AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        systemnote.name AS Approver,
        'Posted' AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        SystemNote ON systemnote.transactionid = transaction.id
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND systemnote.field = 'TRAN_APPROVALSTATUS' AND systemnote.newvalue = 'Approved'
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 12. Vendor Payment Created & 10. Payment Scheduled In Batch (Approximated)
    SELECT
        bill.tranid AS InvoiceNumber,
        'Vendor Payment Created' AS ActivityName,
        payment.trandate AS EventTime,
        vendor.companyname AS VendorName,
        bill.foreignTotal AS InvoiceAmount,
        bill.duedate AS PaymentDueDate,
        payment.createdby AS Approver,
        payment.status AS InvoiceStatus,
        NULL AS IsAutoMatched,
        CASE WHEN payment.trandate <= bill.duedate THEN 'Yes' ELSE 'No' END AS IsPaidOnTime
    FROM
        Transaction AS payment
    JOIN
        TransactionLine AS paymentLine ON payment.id = paymentLine.transaction
    JOIN
        Transaction AS bill ON paymentLine.appliedToTransaction = bill.id
    JOIN
        Entity AS vendor ON bill.entity = vendor.id
    WHERE
        payment.type = 'VendPymt' AND payment.mainline = 'F' AND bill.type = 'VendBill'
        AND payment.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 13. Bill Paid In Full
    SELECT
        transaction.tranid AS InvoiceNumber,
        'Bill Paid In Full' AS ActivityName,
        systemnote.date AS EventTime,
        vendor.companyname AS VendorName,
        transaction.foreignTotal AS InvoiceAmount,
        transaction.duedate AS PaymentDueDate,
        NULL AS Approver,
        systemnote.newvalue AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction
    JOIN
        SystemNote ON systemnote.transactionid = transaction.id
    JOIN
        Entity AS vendor ON transaction.entity = vendor.id
    WHERE
        transaction.type = 'VendBill' AND transaction.mainline = 'T'
        AND systemnote.field = 'TRAN_STATUS' AND systemnote.newvalue = 'Paid In Full'
        AND transaction.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    UNION ALL

    -- 14. Credit Memo Applied
    SELECT
        bill.tranid AS InvoiceNumber,
        'Credit Memo Applied' AS ActivityName,
        credit.trandate AS EventTime,
        vendor.companyname AS VendorName,
        bill.foreignTotal AS InvoiceAmount,
        bill.duedate AS PaymentDueDate,
        credit.createdby AS Approver,
        credit.status AS InvoiceStatus,
        NULL AS IsAutoMatched,
        NULL AS IsPaidOnTime
    FROM
        Transaction AS credit
    JOIN
        TransactionLine AS creditLine ON credit.id = creditLine.transaction
    JOIN
        Transaction AS bill ON creditLine.appliedToTransaction = bill.id
    JOIN
        Entity AS vendor ON bill.entity = vendor.id
    WHERE
        credit.type = 'VendCred' AND credit.mainline = 'F' AND bill.type = 'VendBill'
        AND credit.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

    -- Note: 'Early Payment Discount Missed' is best derived in post-processing. A query for it is complex and unreliable.
)
ORDER BY
    InvoiceNumber, EventTime
"""

def execute_suiteql(query, oauth_session):
    headers = {
        class="hl-string">'Prefer': class="hl-string">'transient',
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }
    payload = json.dumps({class="hl-string">'q': query})
    all_results = []
    offset = 0
    limit = 1000  class=class="hl-string">"hl-comment"># NetSuite's max page size

    while True:
        paginated_url = fclass="hl-string">"{query_url}?limit={limit}&offset={offset}"
        try:
            response = oauth_session.post(paginated_url, headers=headers, data=payload)
            response.raise_for_status()  class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()

            if not data or class="hl-string">'items' not in data or not data[class="hl-string">'items']:
                print(class="hl-string">"No more items found.")
                break
            
            results = data.get(class="hl-string">'items', [])
            all_results.extend(results)
            print(fclass="hl-string">"Fetched {len(results)} records, total so far: {len(all_results)}")

            has_more = data.get(class="hl-string">'hasMore', False)
            if not has_more:
                break

            offset += limit

        except requests.exceptions.HTTPError as e:
            print(fclass="hl-string">"HTTP Error: {e.response.status_code} {e.response.text}")
            break
        except Exception as e:
            print(fclass="hl-string">"An error occurred: {e}")
            break

    return all_results

def main():
    print(class="hl-string">"Starting NetSuite data extraction...")
    oauth = OAuth1(
        client_key=consumer_key,
        client_secret=consumer_secret,
        resource_owner_key=token_id,
        resource_owner_secret=token_secret,
        realm=ns_account_id
    )

    results = execute_suiteql(suiteql_query, requests.Session()) class=class="hl-string">"hl-comment"># Use a basic session, OAuth1 handles auth
    class=class="hl-string">"hl-comment"># The above line needs correction, the oauth object should be passed to the session
    class=class="hl-string">"hl-comment"># Correct implementation:
    session = requests.Session()
    session.auth = oauth
    
    results = execute_suiteql(suiteql_query, session)

    if results:
        df = pd.DataFrame(results)
        class=class="hl-string">"hl-comment"># Re-map columns from the response which are often dictionaries
        for col in df.columns:
            df[col] = df[col].apply(lambda x: x[class="hl-string">'value'] if isinstance(x, dict) and class="hl-string">'value' in x else x)
        
        output_filename = class="hl-string">'netsuite_invoice_event_log.csv'
        df.to_csv(output_filename, index=False, encoding=class="hl-string">'utf-8')
        print(fclass="hl-string">"Successfully extracted {len(df)} events to {output_filename}")
    else:
        print(class="hl-string">"No data was extracted.")

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

準備はできましたか？

このテンプレートを使ってNetSuiteのデータを効率的に準備し、請求書処理の実績に関する重要な情報を明らかにしてください。今日から調達から支払いまでのサイクルを改善しましょう。

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

今日から調達から支払いまでの請求書処理を変革

NetSuiteの請求書処理サイクルタイムを30％短縮。キャッシュフローとコンプライアンスを改善します。

無料トライアルを開始

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

調達から支払いまで：請求書処理のデータテンプレート

調達から支払いまで：請求書処理のデータテンプレート

調達から支払いまで：請求書処理の属性

調達から支払いまで：請求書処理のアクティビティ

抽出ガイド

請求書処理向けNetSuite Saved Searchのエクスポート

ステップ

設定

a サンプルクエリ config

NetSuite SuiteAnalytics Connect経由の直接SQLクエリ

ステップ

設定

a サンプルクエリ sql

NetSuite REST API（SuiteQL）を使ったPython抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

今日から調達から支払いまでの請求書処理を変革

調達から支払いまで：請求書処理のデータテンプレート

調達から支払いまで：請求書処理のデータテンプレート

調達から支払いまで：請求書処理の属性

調達から支払いまで：請求書処理のアクティビティ

抽出ガイド

請求書処理向けNetSuite Saved Searchのエクスポート

ステップ

設定

a サンプルクエリ config

NetSuite SuiteAnalytics Connect経由の直接SQLクエリ

ステップ

設定

a サンプルクエリ sql

NetSuite REST API（SuiteQL）を使ったPython抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

今日から調達から支払いまでの請求書処理を変革

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