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

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

SAP S/4HANA

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

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

収集を推奨する属性
追跡する主要なアクティビティ
データ抽出の手順

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

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

売掛金の属性

売掛金プロセスを詳しく分析するために、イベントログに含めることを推奨するデータ項目と分析軸です。

5 必須 10 推奨 5 任意

	名前	説明
	アクティビティ Activity	プロセス内で実行された具体的なイベントまたは操作です。
説明この属性は、請求書の作成、一部入金の転記、請求書の消込など、売掛金プロセスで実行されたステップを示します。通常、トランザクションコード（TCODE）または変更ログテーブルに記録された伝票ステータスの変更から導出されます。重要な理由プロセスの流れを把握し、イベントの順序を特定するために欠かせません。入手先 SAP TSTCT（トランザクションコード）またはCDHDR/CDPOS（変更伝票）から導出例売掛金請求書を作成一部入金を記帳請求書を消し込む異議申し立て案件を作成
	イベント時刻 EventTime	アクティビティが発生した日時です。
説明この属性には、アクティビティが実行された正確な日時が記録されます。取引データの場合、ヘッダーテーブルの入力日付（CPUDT）と入力時刻（CPUTM）を組み合わせて取得することがよくあります。サイクルタイムや処理時間の計算に利用できます。重要な理由正確なタイムスタンプは、売上債権回転日数の計算やボトルネックの特定に欠かせません。入手先 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
	会社コード通貨での金額 AmountInLocalCurrency	会社コードの通貨で表した請求書または支払いの金額です。
説明この属性（DMBTR）には、取引の金額が格納されます。未消込請求書、貸方票、支払いの合計金額の計算に使用します。「貸方票と訂正分析」ダッシュボードでは、金額を把握するために利用します。重要な理由財務への影響を分析し、高額な債権回収を優先するために必要です。入手先 SAPテーブル BSEG-DMBTR または ACDOCA-DMBTR 例 1500.00250.5010000.00
	伝票タイプ DocumentType	会計伝票の種類（請求書、支払い、貸方票など）を分類します。
説明伝票タイプ（BLART）は取引を分類します。たとえば、「DR」は顧客請求書、「DZ」は顧客からの入金、「DG」は貸方票を表します。「貸方票と訂正分析」で特定のケースを絞り込むために重要です。重要な理由データを請求書、支払い、調整に分類します。入手先 SAPテーブル BKPF-BLART 例 DRDZDGRV
	売上債権回転日数 DaysSalesOutstanding	請求書の転記から消込までにかかる期間です。
説明消込済み明細について、転記日から消込日までの日数を計算します。「売上債権回転日数の概要」ダッシュボードで中心となる指標であり、キャッシュフローの効率を測る重要な指標です。重要な理由売掛金プロセスにおける経営層向けの主要な重要業績評価指標（KPI）です。入手先計算式：消込日 - 転記日例 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
	自動処理フラグ IsAutomated	アクティビティがシステムユーザーによって実行されたかどうかを示すフラグです。
説明この真偽値属性は、ユーザー属性に基づいて算出されます。ユーザーIDが既知のシステムアカウントまたはバッチアカウント（例：「BNK_BSM」）と一致する場合、フラグはtrueになります。「入金照合の自動化率」ダッシュボードに直接反映されます。重要な理由デジタルトランスフォーメーションと自動化の成果を測定するためのキーです。入手先ユーザー属性から導出例 truefalse
	顧客番号 CustomerNumber	顧客アカウントを一意に識別する番号です。
説明この属性は、請求書に関連付けられた顧客番号（KUNNR）を示します。支払い行動を詳しく分析でき、「顧客の支払い行動分析」ダッシュボードに欠かせません。重要な理由特定の顧客アカウントの実績をドリルダウンして確認できます。入手先 SAPテーブル BSEG-KUNNR または KNA1-KUNNR 例 CUST100230001004500WALMART_US
	国 Country	顧客の所在国です。
説明この属性（LAND1）は顧客マスタデータから取得します。地域や国ごとの貸方票率など、重要業績評価指標（KPI）を地域別に分析できます。重要な理由地域ごとのコンプライアンスと実績の分析に利用します。入手先 SAPテーブル KNA1-LAND1 例米国ドイツフランス日本
	地域 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
	貸方票フラグ IsCreditMemo	伝票が貸方票かどうかを示すフラグです。
説明この真偽値属性は、伝票タイプ（例：タイプが「DG」の場合）から導出されます。訂正取引をすばやく絞り込み、「訂正貸方票率」の重要業績評価指標（KPI）を確認できます。重要な理由手戻りや請求処理の誤りを特定します。入手先伝票タイプから導出例 truefalse

必須推奨任意

売掛金のアクティビティ

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

6 推奨 7 任意

	アクティビティ	説明
	一部入金を記帳	請求額の全額に満たない入金があり、顧客勘定に残余項目が残る状態です。
重要な理由不足入金の解決期間に影響します。一部入金が頻繁に発生すると、処理が複雑になり、手作業での照合が増えます。入手先テーブルBSEG。消込文書（AUGBL）によって新しい残余項目が作成され、残高が残る場合に推定します。参照文書は元の請求書と一致します。記録残余項目を伴う消込文書の作成から推定イベントタイプ inferred
	全額の入金を受領	未払いの請求額を全額カバーする入金です。多くの場合、顧客の支払い義務が実質的に終了したことを示します。
重要な理由実際の支払日と支払期日の比較に使います。支払い条件からの逸脱や顧客の行動を分析するうえで重要です。入手先テーブルBSEGから取得します。消込文書（AUGBL）に消込日（AUGDT）が設定され、残高がゼロになった状態を確認します。記録消込文書の記帳時に記録イベントタイプ explicit
	売掛金請求書を作成	財務システムで顧客向け請求書文書を最初に作成するアクティビティです。文書ヘッダーの作成タイムスタンプから記録します。
重要な理由売掛金プロセスの開始点であり、経過日数の計測開始点です。売上債権回転日数（DSO）の算出に欠かせません。入手先テーブルBKPF（会計文書ヘッダー）のフィールドCPUDT（入力日）およびCPUTM（入力時刻）。文書タイプ（BLART）で、顧客請求書に該当するもの（例：DR、RV）に絞り込みます。記録取引がBKPFに確定記録された時点で記録イベントタイプ explicit
	支払いリマインダーを送信	支払期限を過ぎた請求書に対して、督促通知またはリマインダー文書を作成します。組織による債権回収の取り組みを追跡します。
重要な理由督促コンプライアンス率の重要業績評価指標（KPI）に欠かせないアクティビティです。回収方針に沿って債権回収が実行されているかを確認できます。入手先テーブルMHND（督促データ）のフィールドLAUFD（督促実行日）。会社コードと顧客を使って関連付けます。記録督促実行（F150）の実行時に記録イベントタイプ explicit
	請求書の送信データを発行	請求書を顧客に送るための送信データ（メール、印刷、EDI）を生成するアクティビティです。顧客に正式な請求が届いたことを確認できます。
重要な理由作成から送信までの遅れは、顧客が実際に支払いに使える期間に影響します。請求書が社内処理で滞留していないかを確認できます。入手先テーブルNAST（メッセージステータス）を使用し、オブジェクトキー（OBJKY）を請求書文書番号と照合します。タイムスタンプはDATVRおよびUHRVRから取得します。記録送信データの生成時にNASTテーブルへ記録イベントタイプ explicit
	請求書を消し込む	未消込項目を入金またはクレジットと照合し、ステータスを「消込済み」に変更する会計上の処理です。
重要な理由システム上のプロセスインスタンスの最終終了点です。最終的な売上債権回転日数（DSO）の算出に必要です。入手先テーブルBSEGまたはACDOCAを使用します。フィールドAUGDT（消込日）が入力されていることを確認します。USNAMを使って自動処理か手動処理かを判別します。記録フィールドAUGDTの入力時に記録イベントタイプ explicit
	クレジットメモを記帳	請求額を減額するクレジットメモを発行し、請求書と関連付けます。通常、誤りの修正や返品処理に使います。
重要な理由訂正用クレジットメモ率の重要業績評価指標（KPI）に関わるアクティビティです。発生頻度が高い場合、販売や請求など上流プロセスの品質に問題がある可能性があります。入手先テーブルBSEGの文書タイプ「DG」または「KG」。フィールド「請求書参照」（REBZG）が元の請求書を指しているかどうかで特定します。記録クレジットメモ文書が請求書を参照した時点で記録イベントタイプ explicit
	支払い約束を記録	回収担当者が、顧客から特定の金額を特定の日付までに支払うという正式な約束を記録します。
重要な理由回収担当者による対応が実を結んだことを示します。短期キャッシュフローの予測や、回収担当者の処理件数の測定に使います。入手先テーブルUDM_P2P（支払い約束）のフィールドCREATED_AT。案件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。設定に応じて使用します。記録案件のステータスが「クローズ」または「無効」に設定された時点で記録イベントタイプ 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などの専用ビューを結合します。紛争管理と出力管理を利用できるかどうかは、S/4HANAの構成によって異なります。
銀行照合の処理：「銀行明細を照合」アクティビティはI_BankStatementLineItemから取得し、外部の銀行明細を内部の会計伝票に関連付けます。
出力列の標準化：すべてのタイムスタンプを標準形式に変換し、必要な列（InvoiceNumber、アクティビティ、EventTime）に値が入るようにします。金額は共通の浮動小数点数または小数形式に変換します。
実行と検証：まず、少量のデータ（例：会社コード1つ、1か月分）でクエリを実行し、ロジックを検証します。行数が想定される取引量と一致することを確認します。
データのエクスポート：結果をCSVまたはParquetファイルとして保存します。ユーザー名やテキストの説明に含まれる特殊文字を正しく扱えるよう、文字コードをUTF-8に設定します。
ProcessMindへのインポート：抽出したファイルをProcessMindにアップロードします。インポート設定で「InvoiceNumber」列をケースIDフィールドに、「EventTime」列をタイムスタンプフィールドに割り当てます。

設定

ソースビュー：標準のS/4HANA CDSビュー（I_JournalEntryItem、I_DunningHistory、I_DisputeCase、I_OutputRequestItem）を使用します。
日付範囲：未決済請求書のライフサイクル全体を把握するため、直近12か月分のデータ抽出を推奨します。
フィルター：会社コード（CompanyCode）と会計年度（FiscalYear）で絞り込み、データ量を制限します。
勘定タイプ：得意先／売掛金データのみを取得するため、AccountType = 'D'で必ず絞り込みます。
処理性能：CDSビューは仮想データモデルです。非常に大きなデータセットの場合は、結果の実体化、または負荷の低い時間帯での抽出を検討してください。
カスタマイズ：このロジックでは、標準的なSAP伝票タイプ（例：請求書のRV、支払いのDZ）を想定しています。組織で独自の伝票タイプを使用している場合は、クエリ内のCASE文を調整してください。

クエリの例 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のリリースと利用可能なフィールドを確認してください。出力管理、督促、紛争管理、支払い約束、銀行明細照合のデータは、通常ACDOCAとBKPFだけでは網羅できません。実装前に、これらのアクティビティに使用する承認済みのソーステーブルまたはビューを特定してください。
接続文字列、認証情報、抽出開始日、抽出終了日、会社コードフィルター、必要な伝票タイプフィルターを設定します。最初は3～6か月分を対象とし、照合と性能テストの後に期間を延長してください。
承認済みのSAP HANAスキーマに対して、以下のクエリを実行します。このクエリはACDOCAとBKPFから会計伝票イベントを抽出し、出力管理、督促、紛争管理、支払い約束、銀行明細、その他のアプリケーションデータを必要とするアクティビティには、設定可能なソースオブジェクトを使用します。実行前に、角括弧で示した各ソースオブジェクトとフィールドのプレースホルダーを、システムで承認されたオブジェクトに置き換えてください。SAPオブジェクト名を推測して記載することはありません。
各ソースの処理結果が、共通のイベントログスキーマに従うことを確認します。各アクティビティは明示的な行として出力します。ProcessMindは、他の行から出力、督促、紛争、支払い、消込、取消、照合のイベントを推測しません。
結合条件と識別子を検証します。必要に応じて、会計伝票番号、会社コード、会計年度、得意先番号を使用します。請求書番号はケース識別子として保持してください。支払い、クレジットメモ、消込、および関連伝票については、承認済みの関連付けロジックで使用する請求書または会計伝票の識別子をInvoiceNumberに設定します。
必要に応じて、抽出後にデータを変換します。タイムスタンプのタイムゾーンを統一し、アクティビティ名を指定どおりに正規化し、金額の小数型を統一します。ソースに属性がない場合はNULL値を保持してください。DaysSalesOutstandingは、請求書の転記時刻と消込日付の両方がある場合にのみ計算します。
結果をSAPの伝票件数、未消込明細レポート、消込情報、出力ログ、督促記録、紛争記録、支払い約束記録、支払い伝票、クレジットメモ、銀行明細照合記録と照合します。重複行、欠落したアクティビティ、通貨の不整合、指定した日付範囲外の伝票を調査してください。
最終データセットをUTF-8のCSV、またはProcessMindがサポートする別の表形式でエクスポートします。InvoiceNumber、Activity、EventTime、SourceSystem、LastDataUpdate、CompanyCode、CustomerNumber、AmountInLocalCurrency、User、DocumentType、PaymentTerms、DueDate、ClearingDate、IsAutomated、DaysSalesOutstandingの各列を含めます。ファイルをアップロードするか、承認済みの定期抽出を設定し、13種類すべてのアクティビティが明示的なイベント行としてProcessMindに表示されることを確認してください。

設定

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

クエリの例 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）に接続でき、ファイアウォールで通信が許可されていることを確認します。
スクリプトの設定：クエリのセクションにある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）を結合し、統合されたイベントログを作成します。日付変換に加え、消込ロジックに基づいて「一部入金を転記」と「全額入金を受ける」などのアクティビティを判定します。
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の利用可否：スクリプトは紛争管理用のUDM_テーブルを読み取ろうとします。S/4HANAシステムでこれらのモジュールが有効でない場合、該当部分の処理結果は空になるため、スクリプトから該当部分を削除してください。
日付の処理：SAPの日付はYYYYMMDD形式の文字列で保存されます。スクリプトが自動的にPythonのdatetimeオブジェクトに変換します。

クエリの例 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ソースシステムを選択します。
コンポーネントタイプの選択：カスタムSQLのコンポーネントタイプを選択します。これにより、UNION ALLクエリを実行し、複数のSAPテーブルからさまざまなアクティビティを一度に取得できます。
クエリの指定：この文書のクエリセクションにあるコードをコピーし、Xtract Universal Designer内のSQLエディターに貼り付けます。
パラメーターの設定：抽出の「パラメーター」タブで、データを絞り込んで処理性能を高めるため、YEAR_STARTというパラメーターを定義します（例：「20230101」）。スクリプトを動的にする場合は、SQLスクリプト内のWHERE句でこのパラメーターを参照するように更新します。動的にしない場合は、スクリプト内の日付プレースホルダーを手動で置き換えます。
出力先の設定：希望する出力先（例：ローカルCSV、Azure Blob、AWS S3、SQL Server）を設定します。SQLで定義した出力列（InvoiceNumber、アクティビティなど）を出力先のフィールドに割り当てます。出力先で形式の指定が必要な場合は、日付をYYYY-MM-DD、タイムスタンプをYYYY-MM-DD HH:MM:SSに設定してください。
大量データの処理：初回の読み込みでは、会計年度ごとなどに分割して抽出することを推奨します。日次の差分抽出では、WHERE句を変更し、システム日付を基準にCPUDT（入力日）またはAEDAT（変更日）で絞り込みます（例：BKPF.CPUDT >= sy-datum - 1）。
プレビューと検証：Xtract Universalの実行またはプレビューボタンをクリックし、最初の100行を取得します。アクティビティ列に「売掛金請求書を作成」や「請求書を消し込む」などの値が含まれていることを確認します。InvoiceNumberに一貫して値が入っていることも確認してください。
抽出の実行：抽出全体を実行します。タイムアウトやメモリーエラーが発生していないか、Xtract Universalのログを確認してください。
後処理：生成されたファイルをProcessMindにインポートします。インポート時のマッピングで、InvoiceNumberをケースID、アクティビティをアクティビティ名、EventTimeをタイムスタンプに設定します。

設定

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

クエリの例 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ビューからのデータ抽出

ステップ

設定

クエリの例 sql

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

ステップ

設定

クエリの例 sql

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

ステップ

設定

クエリの例 python

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

ステップ

設定

クエリの例 sql

準備はできましたか？

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