> 継続的なプロセス改善 > 売掛金 > SAP S/4HANA > データテンプレート

売掛金データテンプレート

SAP S/4HANA

売掛金データテンプレート

このテンプレートは、SAP S/4HANA内の回収および入金プロセスをマッピングするための詳細な枠組みを提供します。収集すべき主要な属性、追跡対象となる一連のプロセスアクティビティ、財務テーブルからデータを抽出するための技術的な手順をまとめています。この構成に沿ってデータを整理することで、資金回収サイクルを明確に把握し、手作業による対応や入金遅延が発生している箇所を特定できます。

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

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

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

売掛金の属性

売掛金プロセスを詳細に分析するため、イベントログに含めることを推奨するデータ項目とディメンション属性です。

5 必須 10 推奨 5 任意

	名前	説明
	アクティビティ Activity	プロセス内で実行された具体的なイベントまたはアクションです。
説明この属性は、請求書の作成、一部支払いの転記、請求書の消込など、売掛金プロセスで実行されたステップを表します。通常は、トランザクションコード（TCODE）または変更ログテーブルに記録された伝票ステータスの変更内容から導出されます。重要な理由プロセスフローのマッピングとイベント順序の特定に欠かせません。入手先 SAP TSTCT（トランザクションコード）またはCDHDR/CDPOS（変更伝票）から導出例売掛金請求書を作成一部入金を転記請求書を消込異議申し立て案件を作成
	イベント時刻 EventTime	アクティビティが発生した時点のタイムスタンプです。
説明この属性は、アクティビティが実行された正確な日付と時刻を記録します。取引データでは、ヘッダーテーブルの登録日（CPUDT）と登録時刻（CPUTM）を組み合わせて表すことが一般的です。サイクルタイムと処理時間の計算に利用できます。重要な理由正確なタイムスタンプは、DSOの計算とボトルネックの特定に欠かせません。入手先 SAPテーブルBKPF-CPUDTおよびBKPF-CPUTM 例 2023-10-12T08:30:00Z2023-10-15T14:45:12Z2023-11-01T09:15:00Z
	請求書番号 InvoiceNumber	請求書または会計伝票を一意に識別する番号です。
説明この属性は、売掛金プロセスにおける一意のケースIDとして機能します。通常は、抽出ロジックに応じて、SAP FIモジュールの会計伝票番号（BELNR）またはSDの請求伝票（VBELN）に対応します。支払い、紛争、消込など、その後のすべてのアクティビティを元の金銭債務に関連付けます。重要な理由すべての取引について、エンドツーエンドのプロセスフローを再構築するために必要な中心キーです。入手先 SAPテーブルBKPF-BELNRまたはVBRK-VBELN 例 1400000234900004321014000002351800000099
	ソースシステム SourceSystem	データの生成元となったシステムです。
説明この属性は、レコードが作成されたSAP S/4HANAの特定のインスタンスまたは外部システムを識別します。複数のERPインスタンスが存在する環境で、データの系譜を追跡する際に役立ちます。重要な理由複数システム環境で分析を分離できます。入手先システムID（SY-SYSID）または抽出時にハードコード例 SAP_S4H_PRODSAP_S4H_01LEGACY_ERP
	最終データ更新 LastDataUpdate	データが最後に抽出または更新された時点のタイムスタンプです。
説明この属性は、データがプロセスマイニングツールに読み込まれた時点を示します。期間末照合ステータスなどのダッシュボードに表示されるデータの鮮度を把握するのに役立ちます。重要な理由分析担当者は、リアルタイムデータを見ているのか、履歴データを見ているのかを確認できます。入手先 ETLメタデータ例 2023-11-05T00:00:00Z2023-11-05T06:00:00Z
	ユーザー名 User	アクティビティを実行したユーザーのIDです。
説明この属性（USNAM）は、イベントを実行したユーザーまたはシステムエージェントを識別します。人のユーザーとシステムのバッチユーザーを区別し、自動支払照合率を計算するために分析します。重要な理由自動化率とユーザーの生産性を把握するために重要です。入手先 SAPテーブルBKPF-USNAMまたはCDHDR-USERNAME 例 JSMITHBATCH_USERSAP_WFALEX_D
	会社コード CompanyCode	請求書が属する財務エンティティまたは事業部門です。
説明会社コード（BUKRS）は、SAPシステムにおける外部会計の中心的な組織単位です。異なる事業部門を対象とした顧客支払行動プロファイリングなどのダッシュボードで、分析を分けるために使用します。重要な理由異なる法人間でパフォーマンスを比較・絞り込むために必要です。入手先 SAPテーブルBKPF-BUKRSまたはT001-BUKRS 例 1000US01DE012000
	伝票タイプ DocumentType	会計伝票を分類します（例：請求書、支払い、クレジットメモ）。
説明伝票タイプ（BLART）は取引を分類します。例として、顧客請求書の「DR」、顧客支払いの「DZ」、クレジットメモの「DG」があります。クレジットメモ・訂正分析の対象となるケースタイプを絞り込むために重要です。重要な理由データを請求書、支払い、調整に分類します。入手先 SAPテーブルBKPF-BLART 例 DRDZDGRV
	売上債権回転日数 DaysSalesOutstanding	請求書の転記から消込までの期間です。
説明消込済み明細について、消込日から転記日を差し引いて計算します。売上債権回転日数概要ダッシュボードの主要な値であり、キャッシュフロー効率を測る重要な指標です。重要な理由売掛金プロセスにおける経営層向けの主要KPIです。入手先計算式：ClearingDate - PostingDate 例 30日45日15日
	支払期日 DueDate	請求書の支払いが必要となる計算上の日付です。
説明この属性は正味支払期日を表します。SAPでは、基準日（ZFBDT）に支払条件（ZTERM）で定義された日数を加えて算出することが一般的です。督促コンプライアンス・実行ダッシュボードの基準となります。重要な理由支払いが遅延しているかどうかを判定する基準日です。入手先 BSEG-ZFBDTおよびBSEG-ZTERMから導出例 2023-11-302023-12-15
	支払条件 PaymentTerms	合意された支払条件を表すキーです。
説明この属性（ZTERM）は、支払期日や現金割引を含む、顧客が支払う際の条件を定義します。早期支払割引最適化ダッシュボードの主要なデータソースです。重要な理由支払期日の計算と割引適用条件の分析における基準です。入手先 SAPテーブルBSEG-ZTERMまたはKNB1-ZTERM 例 NT300001Z015
	消込日 ClearingDate	請求書が消込または決済された日付です。
説明この属性（AUGDT）は、通常は支払いによって未決済明細が消込された日付を記録します。売掛金プロセスの主要サイクルにおける終了時刻であり、売上債権回転日数の計算における主要な変数です。重要な理由回収サイクルの完了を示します。入手先 SAPテーブルBSEG-AUGDTまたはBSAD-AUGDT 例 2023-11-012023-11-10
	現地通貨金額 AmountInLocalCurrency	会社コードの通貨で表した請求書または支払いの金額です。
説明この属性（DMBTR）は、取引の財務金額を保持します。未決済請求書、クレジットメモ、支払いの合計金額の計算に使用します。金額を定量化し、クレジットメモ・訂正分析ダッシュボードを支えます。重要な理由財務影響の分析と高額債権の回収優先順位付けに必要です。入手先 SAPテーブルBSEG-DMBTRまたはACDOCA-DMBTR 例 1500.00250.5010000.00
	自動化済み IsAutomated	アクティビティがシステムユーザーによって実行されたかどうかを示すフラグです。
説明このブール属性は、ユーザー属性に基づいて計算します。ユーザーIDが既知のシステムアカウントまたはバッチアカウント（例：「BNK_BSM」）と一致する場合、このフラグはtrueに設定されます。支払照合自動化率ダッシュボードに直接反映されます。重要な理由デジタル化と自動化の成果を測定するための重要な指標です。入手先ユーザー属性から導出例 truefalse
	顧客番号 CustomerNumber	顧客勘定を一意に識別する番号です。
説明この属性は、請求書に関連付けられた顧客番号（KUNNR）を表します。支払行動の詳細な分析を可能にし、顧客支払行動プロファイリングダッシュボードに欠かせません。重要な理由特定の顧客勘定のパフォーマンスをドリルダウンして確認できます。入手先 SAPテーブルBSEG-KUNNRまたはKNA1-KUNNR 例 CUST100230001004500WALMART_US
	クレジットメモ IsCreditMemo	伝票がクレジットメモかどうかを示すフラグです。
説明このブール属性は伝票タイプから導出します（例：タイプが「DG」の場合）。訂正取引をすばやく絞り込み、訂正クレジットメモ率KPIを支援できます。重要な理由手戻りと請求エラーを特定します。入手先 DocumentTypeから導出例 truefalse
	国 Country	顧客の所在国です。
説明この属性（LAND1）は顧客マスターデータに由来します。地域または国別にクレジットメモ率などのKPIを分析し、地理的に分類できます。重要な理由地域別のコンプライアンスとパフォーマンスの分析に使用します。入手先 SAPテーブルKNA1-LAND1 例 USDEFRJP
	地域 Region	顧客の州、都道府県、または地域です。
説明この属性（REGIO）は、国よりも詳細な地理情報を提供します。クレジットメモ・訂正分析で、地域ごとの処理上の問題を特定する際に役立ちます。重要な理由詳細な地理分析に使用します。入手先 SAPテーブルKNA1-REGIO 例 CANYTXBY
	督促レベル DunningLevel	請求書の現在の督促レベルです。
説明この属性（MAHNS）は、顧客に支払いを督促した回数を示します。回収活動のエスカレーションを追跡し、督促コンプライアンス・実行ダッシュボードに表示します。重要な理由支払遅延の深刻度と督促方針の遵守状況を監視します。入手先 SAPテーブルMHNK-MAHNSまたはKNB5（顧客マスターの督促情報）例 1230
	紛争ケースID DisputeCaseId	請求書に関連付けられた紛争ケースの識別子です。
説明この属性は、紛争ケースが存在する場合にそのID（UDM_CASE）を保持します。財務伝票を紛争管理モジュールに関連付けます。紛争解決サイクル効率ダッシュボードに必要です。重要な理由売掛金伝票を紛争解決ワークフローに関連付けます。入手先 SAPテーブルFDM_DCPROCまたはUDM_CASE_ATTR 例 0000056789DISP-2023-001

必須推奨任意

売掛金のアクティビティ

正確なプロセスディスカバリーとボトルネック特定のため、イベントログに取得すべき主要なプロセス手順と取引上の節目です。

6 推奨 7 任意

	アクティビティ	説明
	一部入金を転記	請求金額の全額を満たさない入金を受け取り、勘定に残余明細が残ります。
重要な理由一部入金解決サイクルに影響します。一部入金が頻繁に発生すると、複雑さと手作業による照合負荷が増します。入手先 BSEGテーブルを使用します。消込伝票（AUGBL）によって新しい残余明細が作成され、残高が残っている場合に推定します。参照伝票が元の請求書と一致することを確認します。取得残余がある消込伝票の作成から導出イベントタイプ inferred
	全額入金を受領	未払いの請求金額を全額満たす入金を受け取ります。顧客の支払義務が実質的に終了する時点となることが多い処理です。
重要な理由実際の支払日と支払期日の差を判定します。支払条件の逸脱や顧客行動の分析に欠かせません。入手先 BSEGテーブルを使用します。消込伝票（AUGBL）から導出し、消込日（AUGDT）が設定され、残高がゼロになったことを確認します。取得消込伝票の転記時に記録イベントタイプ explicit
	売掛金請求書を作成	財務システム内で顧客向け請求書伝票を最初に作成する処理です。伝票ヘッダーの作成日時から取得します。
重要な理由売掛金プロセスと経過日数の計測を開始します。売上債権回転日数（DSO）の計算に欠かせません。入手先 BKPFテーブル（会計伝票ヘッダー）のCPUDT（入力日）およびCPUTM（入力時刻）フィールドを使用します。伝票タイプ（BLART）で顧客請求書に該当するもの（例：DR、RV）に絞り込みます。取得取引がBKPFに確定記録された時点で記録イベントタイプ explicit
	支払督促を送信	期限超過請求書に対して督促通知または督促状を生成します。組織が行った回収活動を追跡します。
重要な理由督促コンプライアンス率KPIに欠かせません。回収戦略がポリシーに従って実行されているかを確認します。入手先 MHNDテーブル（督促データ）のLAUFDフィールド（督促処理日）を使用します。会社コードと顧客で関連付けます。取得督促処理（F150）の実行時に記録イベントタイプ explicit
	請求書を消込	未消込明細を入金またはクレジットと照合し、ステータスをClearedに変更する技術的な会計処理です。
重要な理由システム上のプロセスインスタンスの確定的な終了です。最終的なDSO指標の計算に必要です。入手先 BSEGまたはACDOCAテーブルを使用します。AUGDT（消込日）フィールドに値が設定されていることを確認します。USNAMで自動処理か手動処理かを判定します。取得 AUGDTフィールドに値が設定された時点で記録イベントタイプ explicit
	請求書出力を発行	請求書を顧客に送るための出力メッセージ（メール、印刷、EDI）を生成する明示的な処理です。顧客が請求通知を正式に受け取ったことを確認します。
重要な理由作成から送付までの遅れは、顧客が実際に利用できる支払条件の期間に影響します。監視することで、請求書が社内処理で滞留していないか確認できます。入手先 NASTテーブル（メッセージステータス）を使用し、請求書伝票番号と一致するオブジェクトキー（OBJKY）で関連付けます。DATVRおよびUHRVRのタイムスタンプを使用します。取得出力生成時にNASTテーブルへ記録イベントタイプ explicit
	クレジットメモを転記	請求書に関連付けられたクレジットメモを発行し、支払額を減額します。通常は、誤りの修正や返品処理に使います。
重要な理由訂正クレジットメモ率KPIの主要項目です。頻度が高い場合、販売または請求における上流工程の品質問題を示します。入手先 BSEGテーブルを使用します。伝票タイプ「DG」または「KG」で、元の請求書を指す「請求書参照」（REBZG）フィールドによって特定します。取得クレジットメモ伝票が請求書を参照した時点で記録イベントタイプ explicit
	支払約束を記録	回収担当者が、顧客から特定の金額を特定の日付までに支払うという正式な約束を記録します。
重要な理由回収担当者による活動が成功したことを示します。短期キャッシュフローの予測や、回収担当者の処理量の測定に使います。入手先 UDM_P2Pテーブル（支払約束）のCREATED_ATフィールドを使用します。Case GUIDまたは伝票キーで請求書に関連付けます。取得 FSCM Collections Managementに記録イベントタイプ explicit
	異議申し立てステータスを更新	既存の異議申し立て案件のステータスが変更されます。たとえば、「新規」から「処理中」または「確認中」へ移行します。
重要な理由異議申し立て解決ワークフローを詳細に把握し、承認または調査の段階にあるボトルネックを特定できます。入手先異議申し立て案件の変更伝票（S/4HANA Case Managementのログ）を使用します。UDM_CASE_ATTRの変更を分析します。取得案件履歴でステータスフィールドの変更を比較イベントタイプ inferred
	異議申し立て案件を作成	通常はSAP FSCM Dispute Managementを通じて、請求書に対する異議申し立て案件を開始します。顧客が請求内容に異議を唱えたことを示します。
重要な理由通常の回収における計測を停止し、異議申し立て解決サイクルの計測を開始します。この件数が多いと、キャッシュフローの予測しやすさに影響します。入手先 UDM_CASE_ATTRテーブル（案件属性）またはUDM_DISPUTEテーブル（異議申し立て案件）を使用します。CASE_GUIDで財務伝票キーに関連付けます。取得 FSCM Dispute Managementのテーブルに記録イベントタイプ explicit
	異議申し立て案件を解決	異議申し立て案件を終了し、クレジット、償却、または債務の再確認のいずれかを行います。例外処理の終了を示します。
重要な理由異議申し立て平均解決時間KPIの終了時刻です。この処理を効率化すると、滞留していた運転資本を直接回収できます。入手先 UDM_CASE_ATTRテーブルを使用します。設定に応じてESCALATION_DATEまたはCLOSED_DATEフィールドを参照します。取得案件ステータスがClosedまたはVoidに設定された時点で記録イベントタイプ explicit
	請求書を取消	重大な誤りが発生したため、元の請求書をシステム上で取消または反対仕訳します。
重要な理由失敗したプロセスインスタンスを示します。データ品質を確保するには、これらを除外するか、別に分析することが重要です。入手先 BKPFテーブルを使用します。元の請求書レコードのSTBLG（反対仕訳伝票番号）フィールドに値が設定されていることを確認します。取得 STBLGフィールドに値が設定された時点で記録イベントタイプ explicit
	銀行明細を照合	銀行明細の明細行を元帳の入金伝票と正常に照合し、キャッシュポジションを確定します。
重要な理由銀行明細照合のリードタイムを追跡します。ここでの遅れは財務決算の速さに影響します。入手先 FEBEPテーブル（電子銀行明細の明細行）を使用します。入金伝票と銀行明細の取引を照合します。取得 EBSテーブル（FEBEP／FEBKO）に記録イベントタイプ explicit

推奨任意

抽出ガイド

SAP S/4HANAからデータを取得する方法

ステップ

データソースを特定する：この抽出では、SAP S/4HANA標準のCore Data Services（CDS）ビューを使用します。主要なビューはI_JournalEntryItemです。請求書、入金、消込イベントを含むすべての財務取引について、明細レベルのデータを保持しています。
SQL環境を準備する：SAP HANAデータベースへのSQLアクセスを用意します。SAP HANA Studio、DBACOCKPITトランザクション、またはS/4HANAインスタンスにODBC／JDBC接続するよう設定した外部ETLツールを利用できます。
対象範囲とフィルターを定義する：抽出対象の会社コードと会計年度を決めます。以下のクエリには、パフォーマンスと関連性を高めるためのプレースホルダーが含まれています。
財務アクティビティを抽出する：クエリの最初のブロックでは、I_JournalEntryItemビューを対象にします。勘定タイプ「D」（顧客）で絞り込み、売掛金だけを抽出します。財務勘定タイプと伝票タイプをもとに、請求書、貸方票、入金を区別します。
消込と決済を抽出する：クエリでは、I_JournalEntryItemに対する自己結合、または別の選択処理を行い、請求書が消し込まれた時点を特定します。消込のタイムスタンプをもとに、「請求書を消し込む」と「全額入金を受け取る」のアクティビティを作成します。
業務イベントを統合する：「入金リマインダーを送信」や「紛争案件を作成」などの財務以外のアクティビティを記録するには、I_DunningHistory、I_DisputeCase、I_OutputRequestItemなどの専用ビューを結合します。Dispute ManagementとOutput Managementを利用できるかどうかは、S/4HANAの構成によって異なります。
銀行照合を処理する：「銀行明細を照合」アクティビティはI_BankStatementLineItemから取得し、外部の銀行明細と内部の会計伝票を関連付けます。
出力列を標準化する：すべてのタイムスタンプを標準形式に変換し、必要な列（InvoiceNumber、Activity、EventTime）が入力されていることを確認します。金額は共通の浮動小数点または10進数形式に変換します。
実行して検証する：まず、データの小さな範囲（例：1つの会社コード、1か月分）に対してクエリを実行し、ロジックを検証します。行数が想定される取引量と一致することを確認します。
データをエクスポートする：結果をCSVまたはParquetファイルとして保存します。ユーザー名やテキスト説明に含まれる特殊文字を処理できるよう、エンコードはUTF-8に設定します。
ProcessMindにインポートする：抽出したファイルをProcessMindにアップロードします。インポート設定で、InvoiceNumber列をCase IDフィールドに、EventTime列をTimestampフィールドにマッピングします。

設定

ソースビュー：標準のS/4HANA CDSビュー（I_JournalEntryItem、I_DunningHistory、I_DisputeCase、I_OutputRequestItem）を使用します。
期間：未決済請求書のライフサイクル全体を把握するため、過去12か月分の抽出を推奨します。
フィルタリング：会社コード（CompanyCode）と会計年度（FiscalYear）で絞り込み、データ量を制限します。
勘定タイプ：AccountType = 'D'で厳密に絞り込み、顧客／売掛金データだけを取得します。
パフォーマンス：CDSビューは仮想データモデルです。非常に大規模なデータセットでは、結果をマテリアライズするか、業務の繁忙時間帯を避けて抽出してください。
カスタマイズ：標準的なSAP伝票タイプ（例：請求書はRV、入金はDZ）を前提としています。組織で独自の伝票タイプを使用している場合は、クエリ内のCASE文を調整してください。

a サンプルクエリ sql

/* ACCOUNTS RECEIVABLE EXTRACTION - SAP S/4HANA CDS VIEWS */
/* METHOD: SQL Union of multiple CDS Views */

/* 1. Create AR Invoice */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Create AR Invoice' AS Activity,
    JE.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE.CompanyCode,
    JE.Customer AS CustomerNumber,
    CAST(JE.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE.CreatedByUser AS "User",
    JE.AccountingDocumentType AS DocumentType,
    JE.PaymentTerms,
    JE.NetDueDate AS DueDate,
    JE.ClearingDate,
    'False' AS IsAutomated,
    CASE 
        WHEN JE.ClearingDate IS NOT NULL THEN DAYS_BETWEEN(JE.PostingDate, JE.ClearingDate) 
        ELSE NULL 
    END AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE
WHERE JE.FinancialAccountType = 'D' -- Customer
  AND JE.AccountingDocumentType IN ('RV', 'DR') -- Invoice Types
  AND JE.Ledger = '0L' -- Leading Ledger
  AND JE.CompanyCode IN ('[Your Company Code]')
  AND JE.FiscalYear >= '[Your Start Year]'

UNION ALL

/* 2. Issue Invoice Output (Requires S/4 Output Management) */
SELECT 
    CAST(B.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Issue Invoice Output' AS Activity,
    O.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    B.CompanyCode,
    B.SoldToParty AS CustomerNumber,
    CAST(B.TotalNetAmount AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    O.CreatedByUser AS "User",
    B.BillingDocumentType AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_BillingDocument AS B
JOIN I_OutputRequestItem AS O ON O.BillingDocument = B.BillingDocument
WHERE B.CompanyCode IN ('[Your Company Code]')
  AND B.FiscalYear >= '[Your Start Year]'

UNION ALL

/* 3. Send Payment Reminder */
SELECT 
    CAST(D.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Send Payment Reminder' AS Activity,
    D.DunningDate AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    D.CompanyCode,
    D.Customer AS CustomerNumber,
    CAST(D.AmountInLocalCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    'System' AS "User",
    'Dunning' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_DunningHistory AS D
WHERE D.CompanyCode IN ('[Your Company Code]')
  AND D.DunningDate >= '[Your Start Date]'

UNION ALL

/* 4. Create Dispute Case (Requires FSCM) */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Create Dispute Case' AS Activity,
    DC.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    DC.CompanyCode,
    DC.Customer AS CustomerNumber,
    CAST(DC.DisputedAmount AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    DC.CreatedByUser AS "User",
    'Dispute' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_DisputeCase AS DC
JOIN I_JournalEntryItem AS JE ON DC.CompanyCode = JE.CompanyCode AND DC.Customer = JE.Customer
/* Note: Join logic simplified. Ideally link via Case ID reference in JE if configured */
WHERE DC.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 5. Update Dispute Status */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Update Dispute Status' AS Activity,
    DC.LastChangeDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    DC.CompanyCode,
    DC.Customer AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    DC.LastChangedByUser AS "User",
    'Dispute' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_DisputeCase AS DC
JOIN I_JournalEntryItem AS JE ON DC.CompanyCode = JE.CompanyCode AND DC.Customer = JE.Customer
WHERE DC.LastChangeDateTime IS NOT NULL
  AND DC.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 6. Resolve Dispute Case */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Resolve Dispute Case' AS Activity,
    DC.ClosingDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    DC.CompanyCode,
    DC.Customer AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    DC.LastChangedByUser AS "User",
    'Dispute' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_DisputeCase AS DC
JOIN I_JournalEntryItem AS JE ON DC.CompanyCode = JE.CompanyCode AND DC.Customer = JE.Customer
WHERE DC.ClosingDateTime IS NOT NULL
  AND DC.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 7. Record Promise To Pay */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Record Promise To Pay' AS Activity,
    PP.PromiseToPayDate AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    PP.CompanyCode,
    PP.Customer AS CustomerNumber,
    CAST(PP.PromiseAmount AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    PP.CreatedByUser AS "User",
    'Promise' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_PromiseToPay AS PP
JOIN I_JournalEntryItem AS JE ON PP.CompanyCode = JE.CompanyCode AND PP.Customer = JE.Customer
WHERE PP.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 8. Post Partial Payment (Logic: Payment Doc exists but invoice not fully cleared immediately) */
SELECT 
    CAST(JE_INV.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Post Partial Payment' AS Activity,
    JE_PAY.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE_PAY.CompanyCode,
    JE_PAY.Customer AS CustomerNumber,
    CAST(JE_PAY.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE_PAY.CreatedByUser AS "User",
    JE_PAY.AccountingDocumentType AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    JE_INV.ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE_PAY
JOIN I_JournalEntryItem AS JE_INV ON JE_PAY.ClearingJournalEntry = JE_INV.AccountingDocument 
     AND JE_PAY.CompanyCode = JE_INV.CompanyCode
     AND JE_PAY.FiscalYear = JE_INV.FiscalYear
WHERE JE_PAY.AccountingDocumentType IN ('DZ', 'ZP') -- Payment Types
  AND JE_INV.ClearingDate IS NULL -- Invoice still open
  AND JE_PAY.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 9. Post Credit Memo */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Post Credit Memo' AS Activity,
    JE.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE.CompanyCode,
    JE.Customer AS CustomerNumber,
    CAST(JE.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE.CreatedByUser AS "User",
    JE.AccountingDocumentType AS DocumentType,
    JE.PaymentTerms,
    JE.NetDueDate AS DueDate,
    JE.ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE
WHERE JE.FinancialAccountType = 'D'
  AND JE.AccountingDocumentType IN ('DG') -- Credit Memo
  AND JE.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 10. Receive Full Payment */
SELECT 
    CAST(JE_INV.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Receive Full Payment' AS Activity,
    JE_PAY.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE_PAY.CompanyCode,
    JE_PAY.Customer AS CustomerNumber,
    CAST(JE_PAY.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE_PAY.CreatedByUser AS "User",
    JE_PAY.AccountingDocumentType AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    JE_INV.ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE_PAY
JOIN I_JournalEntryItem AS JE_INV ON JE_PAY.ClearingJournalEntry = JE_INV.AccountingDocument 
     AND JE_PAY.CompanyCode = JE_INV.CompanyCode
     AND JE_PAY.FiscalYear = JE_INV.FiscalYear
WHERE JE_PAY.AccountingDocumentType IN ('DZ', 'ZP')
  AND JE_INV.ClearingDate IS NOT NULL -- Fully cleared
  AND JE_PAY.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 11. Clear Invoice */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Clear Invoice' AS Activity,
    CAST(JE.ClearingDate AS TIMESTAMP) AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE.CompanyCode,
    JE.Customer AS CustomerNumber,
    CAST(JE.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE.CreatedByUser AS "User",
    'Clearing' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    JE.ClearingDate,
    'True' AS IsAutomated,
    DAYS_BETWEEN(JE.PostingDate, JE.ClearingDate) AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE
WHERE JE.FinancialAccountType = 'D'
  AND JE.ClearingDate IS NOT NULL
  AND JE.AccountingDocumentType IN ('RV', 'DR')
  AND JE.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 12. Reconcile Bank Statement */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Reconcile Bank Statement' AS Activity,
    BS.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE.CompanyCode,
    JE.Customer AS CustomerNumber,
    CAST(BS.AmountInTransactionCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    BS.CreatedByUser AS "User",
    'BankStmt' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    JE.ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_BankStatementLineItem AS BS
JOIN I_JournalEntryItem AS JE ON BS.BankStatementShortID = JE.Reference1IDByBusinessPartner -- Check mapping in your system
WHERE JE.CompanyCode IN ('[Your Company Code]')

UNION ALL

/* 13. Reverse Invoice */
SELECT 
    CAST(JE.AccountingDocument AS VARCHAR(20)) AS InvoiceNumber,
    'Reverse Invoice' AS Activity,
    JE.CreationDateTime AS EventTime,
    'SAP S/4HANA' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    JE.CompanyCode,
    JE.Customer AS CustomerNumber,
    CAST(JE.AmountInCompanyCodeCurrency AS DECIMAL(19,2)) AS AmountInLocalCurrency,
    JE.CreatedByUser AS "User",
    JE.AccountingDocumentType AS DocumentType,
    JE.PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM I_JournalEntryItem AS JE
WHERE JE.IsReversal = 'X' 
  OR JE.IsReversed = 'X'
  AND JE.CompanyCode IN ('[Your Company Code]')

ステップ

承認済みのSQLクライアント、データベースビュー、または抽出ツールを通じて、SAP HANAへの直接読み取りアクセスが可能であることを確認します。ACDOCAとBKPFへの権限を取得し、対象となるSAP S/4HANAのリリースとフィールドの利用可否を確認します。Output Management、Dunning、Dispute Management、Promise to Pay、銀行明細照合の情報は、通常ACDOCAとBKPFだけでは完全に表現されません。実装前に、これらのアクティビティに使用する承認済みのソーステーブルまたはビューを特定してください。
接続文字列、認証情報、抽出開始日、抽出終了日、会社コードフィルター、必要な伝票タイプフィルターを設定します。最初は3～6か月の期間を使用し、照合とパフォーマンステストの後に期間を延長してください。
承認済みのSAP HANAスキーマに対して、以下のクエリを実行します。クエリはACDOCAとBKPFから会計伝票イベントを抽出し、Output Management、Dunning、Dispute Management、Promise to Pay、銀行明細、その他のアプリケーションデータが必要なアクティビティには、設定可能なソースオブジェクトを使用します。実行前に、角括弧で示された各ソースオブジェクトとフィールドのプレースホルダーを、システムで承認されたオブジェクトに置き換えてください。このクエリでは、SAPオブジェクト名を推測していません。
各ソースブランチが共通のイベントログスキーマを返すことを確認します。すべてのアクティビティは明示的な行として出力します。ProcessMindは、他の行から出力、督促、紛争、入金、消込、反転、照合のイベントを推測しません。
結合と識別子を検証します。必要に応じて、会計伝票番号、会社コード、会計年度、顧客番号を使用します。請求書番号はケース識別子として保持します。入金、貸方票、消込、および関連伝票については、承認済みの関連付けロジックで使用する請求書または会計伝票の識別子をInvoiceNumberに設定します。
必要に応じて、抽出後にデータ変換を行います。タイムスタンプを一貫したタイムゾーンに変換し、アクティビティ名を指定どおりに正規化し、金額を統一した10進数型に変換します。ソースに属性がない場合はNULL値を保持します。DaysSalesOutstandingは、請求書の転記時刻と消込日が両方利用できる場合にのみ計算します。
結果をSAPの伝票件数、未決済明細レポート、消込情報、出力ログ、督促記録、紛争記録、Promise to Pay記録、入金伝票、貸方票、銀行明細照合記録と照合します。重複行、欠落したアクティビティ、通貨の不整合、指定期間外の伝票を調査します。
最終データセットをUTF-8のCSV、またはProcessMindが対応する別の表形式でエクスポートします。InvoiceNumber、Activity、EventTime、SourceSystem、LastDataUpdate、CompanyCode、CustomerNumber、AmountInLocalCurrency、User、DocumentType、PaymentTerms、DueDate、ClearingDate、IsAutomated、DaysSalesOutstandingの列を含めます。ファイルをアップロードするか、承認済みの定期抽出を設定し、ProcessMindに13種類のアクティビティが明示的なイベント行として表示されることを確認します。

設定

抽出方法：ACDOCAとBKPFに対してSAP HANA SQLを直接実行し、これらのテーブルに完全には保存されていないアクティビティについては、システムで承認された補助ソースオブジェクトを追加します。
期間：最初は3～6か月を対象にします。業務上の問いに適した転記日または作成タイムスタンプの範囲を使用し、期間の開始近くに作成された請求書に関連する消込、紛争、督促、入金イベントを記録できるだけの履歴を含めます。
会社コード：必要なCompanyCodeの値に絞り込みます。複数の法人が同じSAPシステムを共有している場合は、法人ごとのフィルタープレースホルダーを使用します。
伝票タイプ：対象システムで設定されている請求書、入金、貸方票、反転、消込に関連する伝票タイプに限定します。伝票タイプコードがすべての環境で共通だと仮定しないでください。
ケース識別子：InvoiceNumberを一貫して使用します。請求書伝票、入金伝票、貸方票、消込伝票、紛争記録の関係を定義し、文書化します。
タイムスタンプの処理：タイムゾーンと精度を統一します。ソースが日付しか提供しない場合は、合意した業務上の既定時刻でイベントを表し、その制約を文書化します。
LastDataUpdate：会計転記日ではなく、クエリまたはオーケストレーション層が生成した抽出時刻または更新時刻を設定します。
出力と督促のソース：請求書の出力生成と入金リマインダーに使用する承認済みのソースオブジェクトを設定します。ACDOCAとBKPFだけでは、請求書が送信されたことや督促通知が生成されたことを確実に証明できません。
紛争とPromise to Payのソース：紛争の作成、ステータス変更、解決、支払約束に使用する承認済みのSAP FSCMまたはシステム固有のソースオブジェクトを設定します。紛争記録とInvoiceNumberの関係を確認します。
銀行照合のソース：「銀行明細を照合」に使用する承認済みの銀行明細またはキャッシュマネジメントのソースを設定します。元帳への転記だけでは、銀行明細との照合が正常に完了したことを証明できません。
パフォーマンス：日付とCompanyCodeで絞り込み、必要な列だけを選択し、無制限の全テーブルスキャンを避け、承認されたレポート時間帯に実行します。利用できる場合は、パーティションプルーニングと承認済みの計算ビューまたは抽出レイヤーを使用します。
権限：ACDOCA、BKPF、および設定したすべての補助ソースに対するデータベースまたは分析用の読み取り権限を確認します。プライバシー、職務分掌、本番環境へのアクセスに関するポリシーが抽出を許可していることも確認します。
前提条件：必要なアクティビティに関係するSAPコンポーネント、Output Management、Dunning、Dispute Management、入金処理、銀行明細処理、データ保持設定が有効であることを確認します。実行前に、角括弧で示されたすべてのプレースホルダーを対象システムで検証してください。

a サンプルクエリ sql

WITH
params AS (
    SELECT
        CAST('[Start date and time]' AS TIMESTAMP) AS start_ts,
        CAST('[End date and time]' AS TIMESTAMP) AS end_ts,
        CAST('[Last data update timestamp]' AS TIMESTAMP) AS last_data_update
    FROM DUMMY
),
base_acdoca AS (
    SELECT
        a.RBUKRS AS CompanyCode,
        a.BELNR AS AccountingDocumentNumber,
        a.GJAHR AS FiscalYear,
        a.BUZEI AS LineItem,
        a.KUNNR AS CustomerNumber,
        a.HSL AS AmountInLocalCurrency,
        a.BLART AS DocumentType,
        a.ZTERM AS PaymentTerms,
        a.BUDAT AS PostingDate,
        a.AUGDT AS ClearingDate,
        a.AUGBL AS ClearingDocumentNumber,
        a.USNAM AS UserName,
        a.BELNR AS InvoiceNumber,
        CAST(a.BUDAT AS TIMESTAMP) AS PostingTimestamp
    FROM ACDOCA a
    CROSS JOIN params p
    WHERE CAST(a.BUDAT AS TIMESTAMP) >= p.start_ts
      AND CAST(a.BUDAT AS TIMESTAMP) < p.end_ts
      AND a.RBUKRS = '[Company Code filter]'
),
base_bkpf AS (
    SELECT
        b.BUKRS AS CompanyCode,
        b.BELNR AS AccountingDocumentNumber,
        b.GJAHR AS FiscalYear,
        b.CPUDT AS CreationDate,
        b.CPUTM AS CreationTime,
        b.USNAM AS UserName,
        b.BLART AS DocumentType
    FROM BKPF b
),
invoice_events AS (
    SELECT
        x.InvoiceNumber,
        'Create AR Invoice' AS Activity,
        CAST(TO_TIMESTAMP(TO_VARCHAR(h.CreationDate) || TO_VARCHAR(h.CreationTime), 'YYYYMMDDHH24MISS') AS TIMESTAMP) AS EventTime,
        'SAP S/4HANA' AS SourceSystem,
        p.last_data_update AS LastDataUpdate,
        x.CompanyCode,
        x.CustomerNumber,
        x.AmountInLocalCurrency,
        COALESCE(h.UserName, x.UserName) AS UserName,
        x.DocumentType,
        x.PaymentTerms,
        CAST(NULL AS DATE) AS DueDate,
        x.ClearingDate,
        CAST(NULL AS NVARCHAR(1)) AS IsAutomated,
        CAST(NULL AS DECIMAL(18,2)) AS DaysSalesOutstanding
    FROM base_acdoca x
    INNER JOIN base_bkpf h ON h.CompanyCode = x.CompanyCode AND h.AccountingDocumentNumber = x.AccountingDocumentNumber AND h.FiscalYear = x.FiscalYear
    CROSS JOIN params p
    WHERE x.CustomerNumber IS NOT NULL
),
output_events AS (
    SELECT InvoiceNumber, 'Issue Invoice Output' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved invoice output source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
dunning_events AS (
    SELECT InvoiceNumber, 'Send Payment Reminder' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved dunning source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
dispute_create_events AS (
    SELECT InvoiceNumber, 'Create Dispute Case' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved dispute case source object]
    WHERE ActivityCode = '[Dispute creation activity code]' AND EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
dispute_update_events AS (
    SELECT InvoiceNumber, 'Update Dispute Status' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved dispute status history source object]
    WHERE ActivityCode = '[Dispute status update activity code]' AND EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
dispute_resolve_events AS (
    SELECT InvoiceNumber, 'Resolve Dispute Case' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved dispute case source object]
    WHERE ActivityCode = '[Dispute resolution activity code]' AND EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
promise_events AS (
    SELECT InvoiceNumber, 'Record Promise To Pay' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved promise to pay source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
partial_payment_events AS (
    SELECT InvoiceNumber, 'Post Partial Payment' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved payment relationship source object]
    WHERE PaymentClassification = '[Partial payment classification]' AND EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
credit_memo_events AS (
    SELECT InvoiceNumber, 'Post Credit Memo' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved credit memo relationship source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
full_payment_events AS (
    SELECT InvoiceNumber, 'Receive Full Payment' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved payment relationship source object]
    WHERE PaymentClassification = '[Full payment classification]' AND EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
clear_events AS (
    SELECT InvoiceNumber, 'Clear Invoice' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved clearing relationship source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
reconcile_events AS (
    SELECT InvoiceNumber, 'Reconcile Bank Statement' AS Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName, DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding
    FROM [Approved bank statement reconciliation source object]
    WHERE EventTime >= (SELECT start_ts FROM params) AND EventTime < (SELECT end_ts FROM params)
),
reverse_events AS (
    SELECT
        x.InvoiceNumber,
        'Reverse Invoice' AS Activity,
        CAST(TO_TIMESTAMP(TO_VARCHAR(h.CreationDate) || TO_VARCHAR(h.CreationTime), 'YYYYMMDDHH24MISS') AS TIMESTAMP) AS EventTime,
        'SAP S/4HANA' AS SourceSystem,
        p.last_data_update AS LastDataUpdate,
        x.CompanyCode,
        x.CustomerNumber,
        x.AmountInLocalCurrency,
        COALESCE(h.UserName, x.UserName) AS UserName,
        x.DocumentType,
        x.PaymentTerms,
        CAST(NULL AS DATE) AS DueDate,
        x.ClearingDate,
        CAST(NULL AS NVARCHAR(1)) AS IsAutomated,
        CAST(NULL AS DECIMAL(18,2)) AS DaysSalesOutstanding
    FROM base_acdoca x
    INNER JOIN base_bkpf h ON h.CompanyCode = x.CompanyCode AND h.AccountingDocumentNumber = x.AccountingDocumentNumber AND h.FiscalYear = x.FiscalYear
    CROSS JOIN params p
    WHERE x.DocumentType = '[Reversal document type]'
)
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM invoice_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM output_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM dunning_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM dispute_create_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM dispute_update_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM dispute_resolve_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM promise_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM partial_payment_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM credit_memo_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM full_payment_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM clear_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM reconcile_events
UNION ALL
SELECT InvoiceNumber, Activity, EventTime, SourceSystem, LastDataUpdate, CompanyCode, CustomerNumber, AmountInLocalCurrency, UserName AS "User", DocumentType, PaymentTerms, DueDate, ClearingDate, IsAutomated, DaysSalesOutstanding FROM reverse_events
ORDER BY InvoiceNumber, EventTime, Activity;

ステップ

前提条件の設定：抽出用マシンにPython 3.xがインストールされていることを確認します。SAP NetWeaver RFC SDK（PyRFCに必要）をインストールし、pipでPythonライブラリpyrfcとpandasをインストールします。
SAPユーザーの設定：SAPユーザーアカウントに、リモートファンクションコール用のS_RFC権限と、テーブル読み取り用のS_TABU_DIS権限があることを確認します。ユーザーには、関数モジュールRFC_READ_TABLEへのアクセス権も必要です。
ネットワークの設定：スクリプトを実行するマシンからSAPアプリケーションサーバーのポート（通常は33xx）に接続でき、ファイアウォールでこの通信が許可されていることを確認します。
スクリプトの設定：Queryセクションに記載されたPythonスクリプトを開きます。sap_config辞書のApplication Server Host（ASHOST）、System Number（SYSNR）、Client（CLIENT）、User、Passwordを、固有の接続情報に更新します。
フィルターの定義：スクリプトのTARGET_BUKRS（会社コード）とTARGET_GJAHR（会計年度）を変更し、データ範囲を限定します。BSEGのような大規模なテーブルを読み取る際のタイムアウトを防ぐために重要です。
実行：コマンドラインからスクリプトを実行します（例：python extract_ar.py）。スクリプトが接続を確認し、テーブルのデータをチャンク単位で順番にダウンロードします。
データ変換：スクリプトはPandasを使用して、生のSAPテーブル（BKPF、BSEG、NAST、MHND、UDMテーブル、FEBEP）を1つのイベントログに統合します。日付を変換し、消込ロジックに基づいて「一部支払い計上」と「全額入金」などのアクティビティを導出します。
CSV出力：処理が完了すると、現在のディレクトリにAR_Event_Log.csvというファイルが生成されます。
検証：CSVファイルを開き、EventTime列とアクティビティ列に正しく値が入力されていることを確認します。特定の請求書番号に、ライフサイクル（作成 → 出力 → 支払い）に対応する複数の行があることを確認します。
ProcessMindへのインポート：AR_Event_Log.csvをProcessMindにアップロードします。InvoiceNumberをケースID、アクティビティをアクティビティ、EventTimeをタイムスタンプにマッピングします。

設定

RFC_READ_TABLEの制限：標準SAP関数モジュールには行幅の制限（通常512バイト）があります。スクリプトでは、必要な列だけを明示的に選択し、この制限を超えないようにしています。
会計年度フィルター：パフォーマンスを維持するため、財務テーブル（BKPF、BSEG）をクエリする際は必ずGJAHR（会計年度）で絞り込みます。
会社コード：複数法人でSAPインスタンスを共有している場合、BUKRSによる制限が必須です。
分割取得：非常に大規模なデータセットでは、結果をページ単位で取得するため、read_table関数にROWCOUNTとSKIPオプションを実装する必要があります（ここでは簡略化のため省略していますが、本番環境では推奨します）。
FSCMの利用可否：スクリプトはDispute Management用のUDM_テーブルを読み取ろうとします。S/4HANAシステムでこれらのモジュールが有効でない場合、該当部分は空のデータフレームを返すか、コメントアウトしてください。
日付の処理：SAPの日付はYYYYMMDD形式の文字列で保存されます。スクリプトが自動的にPythonのdatetimeオブジェクトへ変換します。

a サンプルクエリ python

import pandas as pd
from pyrfc import Connection
from datetime import datetime

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
sap_config = {
    class="hl-string">'user': class="hl-string">'YOUR_USER',
    class="hl-string">'passwd': class="hl-string">'YOUR_PASSWORD',
    class="hl-string">'ashost': class="hl-string">'192.168.0.1',  class=class="hl-string">"hl-comment"># SAP App Server IP
    class="hl-string">'sysnr': class="hl-string">'00',            class=class="hl-string">"hl-comment"># Instance Number
    class="hl-string">'client': class="hl-string">'100',          class=class="hl-string">"hl-comment"># Client
    class="hl-string">'lang': class="hl-string">'EN'
}

TARGET_BUKRS = class="hl-string">'1000'  class=class="hl-string">"hl-comment"># Company Code
TARGET_GJAHR = class="hl-string">'2023'  class=class="hl-string">"hl-comment"># Fiscal Year

class=class="hl-string">"hl-comment"># === HELPER FUNCTIONS ===
def read_table(conn, table_name, fields, options=[]):
    class="hl-string">"""Reads an SAP table via RFC_READ_TABLE."""
    print(fclass="hl-string">"Reading {table_name}...")
    try:
        result = conn.call(class="hl-string">'RFC_READ_TABLE',
                           QUERY_TABLE=table_name,
                           DELIMITER=class="hl-string">';',
                           FIELDS=[{class="hl-string">'FIELDNAME': f} for f in fields],
                           OPTIONS=[{class="hl-string">'TEXT': o} for o in options])
        data_str = result[class="hl-string">'DATA']
        headers = [f[class="hl-string">'FIELDNAME'] for f in result[class="hl-string">'FIELDS']]
        
        class=class="hl-string">"hl-comment"># Parse delimiter separated values
        rows = [row[class="hl-string">'WA'].split(class="hl-string">';') for row in data_str]
        df = pd.DataFrame(rows, columns=headers)
        return df
    except Exception as e:
        print(fclass="hl-string">"Error reading {table_name}: {e}")
        return pd.DataFrame(columns=fields)

def sap_date_to_datetime(date_str, time_str=class="hl-string">'000000'):
    class="hl-string">"""Converts SAP YYYYMMDD and HHMMSS strings to datetime."""
    try:
        return pd.to_datetime(date_str + time_str, format=class="hl-string">'%Y%m%d%H%M%S')
    except:
        return pd.NaT

class=class="hl-string">"hl-comment"># === MAIN EXTRACTION ===
def main():
    conn = Connection(**sap_config)
    
    class=class="hl-string">"hl-comment"># 1. Fetch Header Data (BKPF) - Invoices and Payments
    class=class="hl-string">"hl-comment"># Document Types for Invoices: DR (Customer Invoice), RV (Billing Doc)
    fields_bkpf = [class="hl-string">'BUKRS', class="hl-string">'BELNR', class="hl-string">'GJAHR', class="hl-string">'BLART', class="hl-string">'CPUDT', class="hl-string">'CPUTM', class="hl-string">'USNAM', class="hl-string">'WAERS', class="hl-string">'STBLG']
    options_bkpf = [fclass="hl-string">"BUKRS = '{TARGET_BUKRS}' AND GJAHR = '{TARGET_GJAHR}'"]
    df_bkpf = read_table(conn, class="hl-string">'BKPF', fields_bkpf, options_bkpf)

    class=class="hl-string">"hl-comment"># 2. Fetch Segment Data (BSEG) - Customer Line Items (KOART = D)
    fields_bseg = [class="hl-string">'BUKRS', class="hl-string">'BELNR', class="hl-string">'GJAHR', class="hl-string">'BUZEI', class="hl-string">'KOART', class="hl-string">'KUNNR', class="hl-string">'WRBTR', class="hl-string">'AUGBL', class="hl-string">'AUGDT', class="hl-string">'ZLSPR', class="hl-string">'ZTERM', class="hl-string">'SKFBT']
    class=class="hl-string">"hl-comment"># Note: Querying BSEG directly can be slow. Ensure filters are strict.
    options_bseg = [fclass="hl-string">"BUKRS = '{TARGET_BUKRS}' AND GJAHR = '{TARGET_GJAHR}' AND KOART = 'D'"]
    df_bseg = read_table(conn, class="hl-string">'BSEG', fields_bseg, options_bseg)

    class=class="hl-string">"hl-comment"># Merge Header and Item to form base document list
    df_docs = pd.merge(df_bseg, df_bkpf, on=[class="hl-string">'BUKRS', class="hl-string">'BELNR', class="hl-string">'GJAHR'])
    
    class=class="hl-string">"hl-comment"># Filter strictly for AR Invoices (Simplification: Doc Types DR, RV)
    df_invoices = df_docs[df_docs[class="hl-string">'BLART'].isin([class="hl-string">'DR', class="hl-string">'RV', class="hl-string">'DG'])].copy()

    class=class="hl-string">"hl-comment"># === ACTIVITY GENERATION ===
    events = []

    class=class="hl-string">"hl-comment"># Activity 1: Create AR Invoice
    for _, row in df_invoices.iterrows():
        timestamp = sap_date_to_datetime(row[class="hl-string">'CPUDT'], row[class="hl-string">'CPUTM'])
        events.append({
            class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
            class="hl-string">'Activity': class="hl-string">'Create AR Invoice',
            class="hl-string">'EventTime': timestamp,
            class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
            class="hl-string">'CompanyCode': row[class="hl-string">'BUKRS'],
            class="hl-string">'CustomerNumber': row[class="hl-string">'KUNNR'],
            class="hl-string">'AmountInLocalCurrency': row[class="hl-string">'WRBTR'],
            class="hl-string">'User': row[class="hl-string">'USNAM'],
            class="hl-string">'DocumentType': row[class="hl-string">'BLART']
        })

    class=class="hl-string">"hl-comment"># Activity 2: Issue Invoice Output (NAST)
    class=class="hl-string">"hl-comment"># Get unique Invoice numbers to filter NAST
    invoice_nums = df_invoices[class="hl-string">'BELNR'].unique().tolist()
    if invoice_nums:
        class=class="hl-string">"hl-comment"># NAST keys: KAPPL=class="hl-string">'V3' (Billing), OBJKY = Invoice Number
        class=class="hl-string">"hl-comment"># Note: In production, batch this query if list is long
        fields_nast = [class="hl-string">'OBJKY', class="hl-string">'KSCHL', class="hl-string">'DATVR', class="hl-string">'UHRVR', class="hl-string">'USNAM']
        options_nast = [class="hl-string">"KAPPL = 'V3'"] class=class="hl-string">"hl-comment"># Add OBJKY IN (...) logic for optimization
        df_nast = read_table(conn, class="hl-string">'NAST', fields_nast, options_nast)
        
        for _, row in df_nast.iterrows():
            if row[class="hl-string">'OBJKY'] in invoice_nums:
                events.append({
                    class="hl-string">'InvoiceNumber': row[class="hl-string">'OBJKY'],
                    class="hl-string">'Activity': class="hl-string">'Issue Invoice Output',
                    class="hl-string">'EventTime': sap_date_to_datetime(row[class="hl-string">'DATVR'], row[class="hl-string">'UHRVR']),
                    class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
                    class="hl-string">'User': row[class="hl-string">'USNAM']
                })

    class=class="hl-string">"hl-comment"># Activity 3: Send Payment Reminder (MHND/MHNK)
    fields_mhnd = [class="hl-string">'LAUFD', class="hl-string">'LAUFI', class="hl-string">'KUNNR', class="hl-string">'BUKRS', class="hl-string">'KOART']
    class=class="hl-string">"hl-comment"># MHND links dunning run to customer, difficult to link exact invoice item in RFC without join
    class=class="hl-string">"hl-comment"># We will approximate by reading MHND (Dunning Data) where KOART=D
    class=class="hl-string">"hl-comment"># To get Invoice link, we need to know if item is in dunning. 
    class=class="hl-string">"hl-comment"># Simplified: Assuming we can fetch MHND for our customers.
    options_mhnd = [fclass="hl-string">"BUKRS = '{TARGET_BUKRS}' AND KOART = 'D'"]
    df_mhnd = read_table(conn, class="hl-string">'MHND', fields_mhnd + [class="hl-string">'BELNR'], options_mhnd)
    
    for _, row in df_mhnd.iterrows():
        if row[class="hl-string">'BELNR'] in invoice_nums:
            events.append({
                class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                class="hl-string">'Activity': class="hl-string">'Send Payment Reminder',
                class="hl-string">'EventTime': sap_date_to_datetime(row[class="hl-string">'LAUFD']), class=class="hl-string">"hl-comment"># Dunning date
                class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
                class="hl-string">'User': class="hl-string">'SYSTEM'
            })

    class=class="hl-string">"hl-comment"># Activity 4, 5, 6: Dispute Management (UDM_CASE_ATTR)
    class=class="hl-string">"hl-comment"># Requires FSCM. Linking via UDM_RELATION or knowing CASE_GUID.
    class=class="hl-string">"hl-comment"># We assume class="hl-string">'FIN_DISPUTE' case type.
    fields_udm = [class="hl-string">'CASE_GUID', class="hl-string">'CASE_ID', class="hl-string">'FIN_KUNNR', class="hl-string">'CREATE_TIME', class="hl-string">'CLOSE_TIME', class="hl-string">'ESCAL_REASON', class="hl-string">'PROCESSOR']
    df_udm = read_table(conn, class="hl-string">'UDM_CASE_ATTR', fields_udm, options=[])
    
    class=class="hl-string">"hl-comment"># UDM_RELATION links Case to Object (Invoice)
    fields_rel = [class="hl-string">'CASE_GUID', class="hl-string">'OBJ_KEY']
    df_rel = read_table(conn, class="hl-string">'UDM_RELATION', fields_rel, options=[])
    
    class=class="hl-string">"hl-comment"># Merge Dispute info
    df_disputes = pd.merge(df_udm, df_rel, on=class="hl-string">'CASE_GUID')
    
    for _, row in df_disputes.iterrows():
        inv_num = row[class="hl-string">'OBJ_KEY'] class=class="hl-string">"hl-comment"># Needs parsing usually (RefKey), assuming raw match for simplicity
        if inv_num in invoice_nums:
            class=class="hl-string">"hl-comment"># 4. Create Dispute Case
            events.append({
                class="hl-string">'InvoiceNumber': inv_num,
                class="hl-string">'Activity': class="hl-string">'Create Dispute Case',
                class="hl-string">'EventTime': pd.to_datetime(row[class="hl-string">'CREATE_TIME']),
                class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
                class="hl-string">'User': row[class="hl-string">'PROCESSOR']
            })
            class=class="hl-string">"hl-comment"># 5. Update Dispute Status (Approximation via Change Time or attribute check)
            class=class="hl-string">"hl-comment"># Omitted for brevity: requires CDHDR/CDPOS lookup
            
            class=class="hl-string">"hl-comment"># 6. Resolve Dispute Case
            if pd.notna(row[class="hl-string">'CLOSE_TIME']) and row[class="hl-string">'CLOSE_TIME'] != class="hl-string">'0.0000000E+00':
                 events.append({
                    class="hl-string">'InvoiceNumber': inv_num,
                    class="hl-string">'Activity': class="hl-string">'Resolve Dispute Case',
                    class="hl-string">'EventTime': pd.to_datetime(row[class="hl-string">'CLOSE_TIME']),
                    class="hl-string">'SourceSystem': class="hl-string">'SAP_S4'
                })

    class=class="hl-string">"hl-comment"># Activities 8-11: Payments and Clearing
    class=class="hl-string">"hl-comment"># We look at the class="hl-string">'AUGBL' (Clearing Doc) in the Invoice BSEG row.
    for _, row in df_invoices.iterrows():
        if row[class="hl-string">'AUGBL'] and row[class="hl-string">'AUGBL'] != class="hl-string">'':
            clearing_doc = row[class="hl-string">'AUGBL']
            clearing_date = row[class="hl-string">'AUGDT']
            
            class=class="hl-string">"hl-comment"># 11. Clear Invoice
            events.append({
                class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                class="hl-string">'Activity': class="hl-string">'Clear Invoice',
                class="hl-string">'EventTime': sap_date_to_datetime(clearing_date),
                class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
                class="hl-string">'ClearingDate': sap_date_to_datetime(clearing_date)
            })
            
            class=class="hl-string">"hl-comment"># Analyze Clearing Document to determine if it was Payment or Credit Memo
            class=class="hl-string">"hl-comment"># Fetch the header of the clearing document
            class=class="hl-string">"hl-comment"># In a real run, batch these fetches. Here we simulate availability.
            class=class="hl-string">"hl-comment"># We check if we already fetched it in df_bkpf (if within same year)
            clear_header = df_bkpf[(df_bkpf[class="hl-string">'BELNR'] == clearing_doc) & (df_bkpf[class="hl-string">'BUKRS'] == row[class="hl-string">'BUKRS'])]
            
            if not clear_header.empty:
                doc_type = clear_header.iloc[0][class="hl-string">'BLART']
                class=class="hl-string">"hl-comment"># 8. Post Partial Payment / 10. Receive Full Payment
                if doc_type in [class="hl-string">'DZ', class="hl-string">'ZP']: class=class="hl-string">"hl-comment"># Payment Types
                    class=class="hl-string">"hl-comment"># Logic: If residual items exist, it's Partial. 
                    class=class="hl-string">"hl-comment"># Check if clearing doc created new open items. Complex in basic script.
                    class=class="hl-string">"hl-comment"># Simplified: Assume Full Payment for standard clearing.
                    events.append({
                        class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                        class="hl-string">'Activity': class="hl-string">'Receive Full Payment',
                        class="hl-string">'EventTime': sap_date_to_datetime(clearing_date),
                        class="hl-string">'SourceSystem': class="hl-string">'SAP_S4',
                        class="hl-string">'DocumentType': doc_type
                    })
                class=class="hl-string">"hl-comment"># 9. Post Credit Memo
                elif doc_type == class="hl-string">'DG':
                     events.append({
                        class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                        class="hl-string">'Activity': class="hl-string">'Post Credit Memo',
                        class="hl-string">'EventTime': sap_date_to_datetime(clearing_date),
                        class="hl-string">'SourceSystem': class="hl-string">'SAP_S4'
                    })

    class=class="hl-string">"hl-comment"># Activity 12: Reconcile Bank Statement (FEBEP)
    class=class="hl-string">"hl-comment"># Check for Electronic Bank Statement items matching the Payment Doc
    class=class="hl-string">"hl-comment"># Requires knowing the Payment Doc number (AUGBL from invoice)
    fields_febep = [class="hl-string">'KUKEY', class="hl-string">'ESNUM', class="hl-string">'NBBLN']
    options_febep = [fclass="hl-string">"BUKRS = '{TARGET_BUKRS}'"] 
    df_febep = read_table(conn, class="hl-string">'FEBEP', fields_febep, options_febep)
    
    for _, row in df_invoices.iterrows():
        payment_doc = row[class="hl-string">'AUGBL']
        if payment_doc:
            match = df_febep[df_febep[class="hl-string">'NBBLN'] == payment_doc]
            if not match.empty:
                events.append({
                    class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                    class="hl-string">'Activity': class="hl-string">'Reconcile Bank Statement',
                    class="hl-string">'EventTime': sap_date_to_datetime(row[class="hl-string">'AUGDT']), class=class="hl-string">"hl-comment"># Proxy time
                    class="hl-string">'SourceSystem': class="hl-string">'SAP_S4'
                })

    class=class="hl-string">"hl-comment"># Activity 13: Reverse Invoice
    class=class="hl-string">"hl-comment"># Check if STBLG (Reversal Doc) is filled in header
    for _, row in df_invoices.iterrows():
        if row[class="hl-string">'STBLG'] and row[class="hl-string">'STBLG'] != class="hl-string">'':
             events.append({
                class="hl-string">'InvoiceNumber': row[class="hl-string">'BELNR'],
                class="hl-string">'Activity': class="hl-string">'Reverse Invoice',
                class="hl-string">'EventTime': sap_date_to_datetime(row[class="hl-string">'CPUDT']), class=class="hl-string">"hl-comment"># Using updated time
                class="hl-string">'SourceSystem': class="hl-string">'SAP_S4'
            })

    class=class="hl-string">"hl-comment"># 7. Record Promise To Pay (UDM_P2P_ATTR)
    class=class="hl-string">"hl-comment"># Similar to Dispute, requires P2P table fetch
    class=class="hl-string">"hl-comment"># Implementation logic similar to UDM_CASE_ATTR

    class=class="hl-string">"hl-comment"># === EXPORT ===
    df_events = pd.DataFrame(events)
    df_events[class="hl-string">'LastDataUpdate'] = datetime.now()
    
    print(fclass="hl-string">"Extracted {len(df_events)} events.")
    df_events.to_csv(class="hl-string">'AR_Event_Log.csv', index=False)

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

ステップ

前提条件の確認：Theobald Xtract Universal Designerがインストールされ、SAP S/4HANAのソースシステムへの有効な接続が設定されていることを確認します。接続に使用するSAPユーザーアカウントに、テーブルBKPF、BSEG、BSAD、NAST、MHND、SCMG_T_CASE_ATTR、UDM_P2P_ATTR、FEBEPへの読み取り権限（S_TABU_DISまたはS_TABU_NAM）があることを確認します。
新しい抽出の作成：Xtract Universal Designerを開きます。新規をクリックして新しい抽出を作成します。AR_Process_Mining_EventLogという名前を付け、SAPソースシステムを選択します。
コンポーネントタイプの選択：コンポーネントタイプとしてCustom SQLを選択します。これにより、UNION ALLクエリを実行し、異なるSAPテーブルから複数のアクティビティを一度に取得できます。
クエリの定義：この文書のQueryセクションにあるコードをコピーします。Xtract Universal Designer内のSQLエディターに貼り付けます。
パラメーターの設定：抽出の「Parameters」タブで、データの絞り込みと性能向上のためにYEAR_STARTというパラメーターを定義します（例：'20230101'）。スクリプトを動的にする場合は、SQLスクリプトのWHERE句がこのパラメーターを参照するように更新します。手動でスクリプト内のプレースホルダーの日付を置き換えることもできます。
出力先の設定：希望する出力先（例：Local CSV、Azure Blob、AWS S3、SQL Server）を設定します。SQLで定義された出力列（InvoiceNumber、アクティビティなど）を出力先のフィールドにマッピングします。出力先で特定の型が必要な場合は、日付フィールドをYYYY-MM-DD、タイムスタンプをYYYY-MM-DD HH:MM:SSとしてフォーマットします。
大量データの処理：初回ロードでは、会計年度などの単位で抽出を分割して実行することをお勧めします。日次の差分を取得する場合は、システム日付を基準にCPUDT（入力日）またはAEDAT（変更日）で絞り込むようにWHERE句を変更します（例：BKPF.CPUDT >= sy-datum - 1）。
プレビューと検証：Xtract UniversalでRunまたはプレビューボタンをクリックし、最初の100行を取得します。アクティビティ列に「Create AR Invoice」や「Clear Invoice」などの値が含まれていることを確認します。InvoiceNumberに一貫して値が入っていることも確認します。
抽出の実行：完全な抽出を実行します。Xtract Universalのログを監視し、タイムアウトやメモリエラーが発生していないことを確認します。
後処理：結果ファイルをProcessMindにインポートします。インポート時のマッピングで、InvoiceNumberをケースID、アクティビティをアクティビティ名、EventTimeをタイムスタンプに設定します。

設定

抽出タイプ：Custom SQL（Legacy）またはTable Joinを使用します。ソース側でイベントログを直接整形できるため、Custom SQLを推奨します。
パッケージサイズ：20,000～50,000行に設定します。SAP S/4HANAではより大きな取得にも対応できますが、ネットワークの安定性がボトルネックになることがあります。
タイムアウト：大量の履歴データを抽出する場合は、標準のタイムアウトを600秒以上に延長します。
WHERE句のフィルター：
- BUKRS（会社コード）で絞り込み、対象となる法人のデータだけを取得します。
- GJAHR（会計年度）で絞り込み、履歴データの範囲を制限します。
列の型変換：出力先の設定で、AmountInLocalCurrencyをDecimal／Doubleとして扱い、端数を保持できるようにします。
差分ロジック：増分ロードでは、対応している場合はCustom SQLロジックでSAPサーバー変数@sy-datumを使用するか、呼び出し元のワークフローツールから動的パラメーターを渡します。

a サンプルクエリ sql

SELECT 
    BKPF.BELNR AS InvoiceNumber,
    'Create AR Invoice' AS Activity,
    CONCAT(BKPF.CPUDT, BKPF.CPUTM) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BKPF.BUKRS AS CompanyCode,
    BSEG.KUNNR AS CustomerNumber,
    BSEG.DMBTR AS AmountInLocalCurrency,
    BKPF.USNAM AS "User",
    BKPF.BLART AS DocumentType,
    BSEG.ZTERM AS PaymentTerms,
    BSEG.ZFBDT AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    0 AS DaysSalesOutstanding
FROM BKPF
INNER JOIN BSEG ON BKPF.BUKRS = BSEG.BUKRS AND BKPF.BELNR = BSEG.BELNR AND BKPF.GJAHR = BSEG.GJAHR
WHERE BKPF.BLART IN ('DR', 'RV', 'RE') 
  AND BSEG.KOART = 'D' 
  AND BKPF.GJAHR >= '2023' -- [Configure based on your system]

UNION ALL

SELECT 
    LEFT(NAST.OBJKY, 10) AS InvoiceNumber,
    'Issue Invoice Output' AS Activity,
    CONCAT(NAST.DATVR, NAST.UHRVR) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    NAST.KAPPL AS CompanyCode,
    NAST.PARNR AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    NAST.USNAM AS "User",
    NAST.KSCHL AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM NAST
WHERE NAST.KAPPL = 'V3' 
  AND NAST.OBJKY IS NOT NULL
  AND NAST.DATVR >= '20230101' -- [Configure based on your system]

UNION ALL

SELECT 
    MHND.BELNR AS InvoiceNumber,
    'Send Payment Reminder' AS Activity,
    CONCAT(MHND.LAUFD, '120000') AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    MHND.BUKRS AS CompanyCode,
    MHND.KUNNR AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    NULL AS "User",
    MHND.MANSP AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM MHND
WHERE MHND.KOART = 'D'
  AND MHND.LAUFD >= '20230101' -- [Configure based on your system]

UNION ALL

SELECT 
    SCMG.EXTERNAL_KEY AS InvoiceNumber,
    'Create Dispute Case' AS Activity,
    CONCAT(SUBSTRING(SCMG.CREATE_TIME, 1, 8), SUBSTRING(SCMG.CREATE_TIME, 9, 6)) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    NULL AS CompanyCode,
    NULL AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    SCMG.CREATE_USER AS "User",
    SCMG.CASE_TYPE AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM SCMG_T_CASE_ATTR AS SCMG
WHERE SCMG.CASE_TYPE = 'F_01'

UNION ALL

SELECT 
    SCMG.EXTERNAL_KEY AS InvoiceNumber,
    'Update Dispute Status' AS Activity,
    CONCAT(SUBSTRING(SCMG.CHANGE_TIME, 1, 8), SUBSTRING(SCMG.CHANGE_TIME, 9, 6)) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    NULL AS CompanyCode,
    NULL AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    SCMG.CHANGE_USER AS "User",
    SCMG.STAT_ORDERNO AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM SCMG_T_CASE_ATTR AS SCMG
WHERE SCMG.CASE_TYPE = 'F_01' AND SCMG.CHANGE_TIME > SCMG.CREATE_TIME

UNION ALL

SELECT 
    SCMG.EXTERNAL_KEY AS InvoiceNumber,
    'Resolve Dispute Case' AS Activity,
    CONCAT(SUBSTRING(SCMG.CHANGE_TIME, 1, 8), SUBSTRING(SCMG.CHANGE_TIME, 9, 6)) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    NULL AS CompanyCode,
    NULL AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    SCMG.CHANGE_USER AS "User",
    SCMG.STAT_ORDERNO AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM SCMG_T_CASE_ATTR AS SCMG
WHERE SCMG.CASE_TYPE = 'F_01' AND SCMG.STAT_ORDERNO >= '30' -- [Adjust status code for Closed]

UNION ALL

SELECT 
    P2P.INVOICE_REF AS InvoiceNumber,
    'Record Promise To Pay' AS Activity,
    CONCAT(SUBSTRING(P2P.PROMISE_TIME, 1, 8), SUBSTRING(P2P.PROMISE_TIME, 9, 6)) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    NULL AS CompanyCode,
    P2P.CUSTOMER AS CustomerNumber,
    P2P.AMOUNT_PROMISED AS AmountInLocalCurrency,
    P2P.USER_CREATED AS "User",
    P2P.STATE AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM UDM_P2P_ATTR AS P2P

UNION ALL

SELECT 
    BKPF.BELNR AS InvoiceNumber,
    'Post Partial Payment' AS Activity,
    CONCAT(BKPF.CPUDT, BKPF.CPUTM) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BKPF.BUKRS AS CompanyCode,
    BSEG.KUNNR AS CustomerNumber,
    BSEG.DMBTR AS AmountInLocalCurrency,
    BKPF.USNAM AS "User",
    BKPF.BLART AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM BKPF
INNER JOIN BSEG ON BKPF.BUKRS = BSEG.BUKRS AND BKPF.BELNR = BSEG.BELNR AND BKPF.GJAHR = BSEG.GJAHR
WHERE BKPF.BLART = 'DZ' AND BSEG.XREF3 IS NOT NULL -- [Assumption: XREF3 implies partial link, or customize logic]

UNION ALL

SELECT 
    BSEG.REBZG AS InvoiceNumber, -- Reference to original invoice
    'Post Credit Memo' AS Activity,
    CONCAT(BKPF.CPUDT, BKPF.CPUTM) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BKPF.BUKRS AS CompanyCode,
    BSEG.KUNNR AS CustomerNumber,
    BSEG.DMBTR AS AmountInLocalCurrency,
    BKPF.USNAM AS "User",
    BKPF.BLART AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM BKPF
INNER JOIN BSEG ON BKPF.BUKRS = BSEG.BUKRS AND BKPF.BELNR = BSEG.BELNR AND BKPF.GJAHR = BSEG.GJAHR
WHERE BKPF.BLART = 'DG' AND BSEG.REBZG IS NOT NULL

UNION ALL

SELECT 
    BSAD.BELNR AS InvoiceNumber,
    'Receive Full Payment' AS Activity,
    CONCAT(BKPF.CPUDT, BKPF.CPUTM) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BKPF.BUKRS AS CompanyCode,
    BSAD.KUNNR AS CustomerNumber,
    BSAD.DMBTR AS AmountInLocalCurrency,
    BKPF.USNAM AS "User",
    BKPF.BLART AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    BSAD.AUGDT AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM BKPF
INNER JOIN BSAD ON BKPF.BUKRS = BSAD.BUKRS AND BKPF.BELNR = BSAD.AUGBL AND BKPF.GJAHR = BSAD.AUGGJ
WHERE BKPF.BLART = 'DZ' -- Customer Payment

UNION ALL

SELECT 
    BSAD.BELNR AS InvoiceNumber,
    'Clear Invoice' AS Activity,
    CONCAT(BSAD.AUGDT, '235959') AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BSAD.BUKRS AS CompanyCode,
    BSAD.KUNNR AS CustomerNumber,
    BSAD.DMBTR AS AmountInLocalCurrency,
    NULL AS "User",
    BSAD.BLART AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    BSAD.AUGDT AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM BSAD
WHERE BSAD.AUGDT >= '20230101' -- [Configure based on your system]

UNION ALL

SELECT 
    BSEG.BELNR AS InvoiceNumber,
    'Reconcile Bank Statement' AS Activity,
    CONCAT(FEB.BUDAT, '120000') AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    FEB.BUKRS AS CompanyCode,
    NULL AS CustomerNumber,
    FEB.KWERT AS AmountInLocalCurrency,
    NULL AS "User",
    'EBS' AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'True' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM FEBEP AS FEB
INNER JOIN BSEG ON FEB.BELNR = BSEG.BELNR AND FEB.BUKRS = BSEG.BUKRS
WHERE FEB.BUDAT >= '20230101' -- [Configure based on your system]

UNION ALL

SELECT 
    BKPF.BELNR AS InvoiceNumber,
    'Reverse Invoice' AS Activity,
    CONCAT(BKPF.CPUDT, BKPF.CPUTM) AS EventTime,
    'SAP_S4' AS SourceSystem,
    CURRENT_TIMESTAMP AS LastDataUpdate,
    BKPF.BUKRS AS CompanyCode,
    NULL AS CustomerNumber,
    NULL AS AmountInLocalCurrency,
    BKPF.USNAM AS "User",
    BKPF.BLART AS DocumentType,
    NULL AS PaymentTerms,
    NULL AS DueDate,
    NULL AS ClearingDate,
    'False' AS IsAutomated,
    NULL AS DaysSalesOutstanding
FROM BKPF
WHERE BKPF.STBLG IS NOT NULL AND BKPF.STBLG <> ''

準備はできましたか？

財務データを具体的な改善案につなげ、売上債権回転日数の短縮を今日から始めましょう。プロセスマイニングの導入を、各ステップで当社チームが支援します。

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

SAP S/4HANAの売掛金プロセスを改善し、キャッシュフローを向上

当社ツールで売上債権回転日数を15～20日短縮している企業に続きましょう

無料トライアルを開始

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

売掛金データテンプレート

売掛金データテンプレート

売掛金の属性

売掛金のアクティビティ

抽出ガイド

SAP S/4HANA標準CDSビューからのデータ抽出

ステップ

設定

a サンプルクエリ sql

ACDOCAテーブルに対するSAP HANA SQLクエリの直接実行

ステップ

設定

a サンプルクエリ sql

PyRFCコネクターを使用したPython抽出スクリプト

ステップ

設定

a サンプルクエリ python

Theobald Xtract Universal SAPコネクターの使用方法

ステップ

設定

a サンプルクエリ sql

準備はできましたか？

SAP S/4HANAの売掛金プロセスを改善し、キャッシュフローを向上

売掛金データテンプレート

売掛金データテンプレート

売掛金の属性

売掛金のアクティビティ

抽出ガイド

SAP S/4HANA標準CDSビューからのデータ抽出

ステップ

設定

a サンプルクエリ sql

ACDOCAテーブルに対するSAP HANA SQLクエリの直接実行

ステップ

設定

a サンプルクエリ sql

PyRFCコネクターを使用したPython抽出スクリプト

ステップ

設定

a サンプルクエリ python

Theobald Xtract Universal SAPコネクターの使用方法

ステップ

設定

a サンプルクエリ sql

準備はできましたか？

SAP S/4HANAの売掛金プロセスを改善し、キャッシュフローを向上

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