> 継続的なプロセス改善 > 支払い処理 > FIS Global > データテンプレート

支払処理データテンプレート

FIS Global

支払処理の属性(19) 支払処理のアクティビティ(13) データ抽出ガイド(1)

支払処理データテンプレート

このテンプレートでは、支払処理を効果的に分析するために必要なデータ属性とプロセスアクティビティを詳しく説明します。また、システムから必要な情報を抽出する方法も紹介します。プロセスマイニングに必要なデータを漏れなく収集するためにご利用ください。

収集を推奨する属性
追跡する主なアクティビティ
データ抽出ガイド

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

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

支払処理の属性

支払処理を詳しく分析するために、イベントログに含めることを推奨するデータ項目です。

3 必須 7 推奨 9 任意

	名前	説明
	アクティビティ名 ActivityName	発生した特定のプロセスステップまたはイベントの名称です。
説明このフィールドには、「支払い依頼の作成」や「支払い決済完了」など、特定の時点で行われた操作が記録されます。プロセスマップのノードを定義し、プロセスフローの構造を決める項目です。分析では、この属性を使って処理の順序を把握します。理想経路からの逸脱やスキップされたステップの特定、複数回の承認ループなど、重複するアクティビティの検出に欠かせません。重要な理由プロセスで何が行われたかを示し、プロセスマップの可視化やバリアント分析に役立ちます。入手先 FIS Globalの文書を参照例支払い依頼の作成支払い詳細の検証支払いの承認支払い決済完了
	イベント日時 EventTimestamp	アクティビティが発生した日時です。
説明この属性は、支払いプロセスの各イベントに時間情報を付与します。システムに操作が記録された正確な時刻を保持し、アクティビティを時系列に並べることができます。分析では、ステップ間の所要時間、全体のサイクル時間、処理率の算出に使います。プロセスの各段階で発生する遅延を明らかにし、ボトルネックを特定できます。重要な理由このフィールドがなければ時間に基づく分析はできず、パフォーマンスと効率に関するすべての重要業績評価指標（KPI）の算出にも欠かせません。入手先 FIS Globalの文書を参照例 2023-10-12T08:30:15Z2023-10-12T09:45:00Z2023-10-13T14:20:10Z
	支払い取引ID PaymentTransactionId	個々の支払い指示または取引を識別する一意のIDです。
説明この属性は、1件の支払いライフサイクルに含まれるすべてのイベントを関連付けるための中心的なキーです。最初の依頼から検証、承認、最終決済または照合まで、支払いの流れを追跡できます。分析では、このIDを使って個々のイベントをプロセスインスタンスごとにグループ化します。これにより、最初から最後までの流れを可視化でき、サイクル時間や手戻りのループなど、ケース単位のすべての指標を算出できます。重要な理由プロセスマイニングの基盤となる識別子です。個別のアクティビティを関連付け、一貫した一連の流れとして再構成できます。入手先 FIS Globalの文書を参照例 TRX-2023-899102PAY-US-99281ACH-7721-X99WIRE-2210-001
	事業部門 BusinessUnit	支払いを開始した社内の部門または部署です。
説明この属性は、支払いを「リテールバンキング」「法人融資」「財務」などの組織単位に関連付けます。部署ごとに「支払い処理量」や「平均支払いサイクル時間」などの重要業績評価指標（KPI）を集計できます。部門間のパフォーマンス比較や、リソースの適切な配分に役立ちます。重要な理由社内でのベンチマークや、プロセスのパフォーマンスに対する説明責任を支えます。入手先 FIS Globalの文書を参照例財務部門買掛金リテール業務ウェルスマネジメント
	処理ユーザー ProcessingUser	アクティビティを実行したユーザーまたはシステムエージェントのIDや名称です。
説明この属性は、プロセスステップを実行した人またはシステムを記録します。人間の担当者（例：「J.Smith」）と自動システムアカウント（例：「SYSTEM_BATCH」）を区別できます。このデータは、リソースの利用状況の分析、手作業によるボトルネックの特定、職務分掌の監査に使われます。「処理ユーザー利用率」の算出や、手動タスクと自動タスクの区別にも役立ちます。重要な理由リソース分析、自動化率の把握、コンプライアンス監査に欠かせません。入手先 FIS Globalの文書を参照例 jsmithSYSTEM_AUTOBOTmdoe_approverAPI_GATEWAY
	実際の決済日 ActualSettlementDate	支払いが実際に確定し、決済された日付です。
説明この属性は、資金が移動した日、または取引が完了したとみなされた日を記録します。処理日時とは異なり、資金の受渡日を示します。分析では、支払期日と組み合わせて「期日どおりの支払い率」を算出します。また、照合段階の開始を示すため、「支払い照合サイクル時間」の分析にも欠かせません。重要な理由支払いの財務上の完了を示し、キャッシュフロー分析の重要な指標となります。入手先 FIS Globalの文書を参照例 2023-11-022023-11-14
	支払い種別 PaymentType	支払い方法または支払い手段の分類です。
説明この属性は、電信送金、ACH、SEPA、即時決済（RTP）、小切手などに支払いを分類します。支払い種別によって処理ルールやサービスレベル合意（SLA）が異なります。分析では、このフィールドを使って決済手段ごとに「支払い照合サイクル時間」を比較します。支払いによって即時に決済されるものと数日かかるものがある理由を把握し、それぞれに適した基準でパフォーマンスを評価できます。重要な理由支払い種別ごとに経路や処理時間の特性が異なるため、プロセスフローを分類する主な軸となります。入手先 FIS Globalの文書を参照例電信送金ACHクレジットSEPA即時決済小切手
	支払い金額 PaymentAmount	支払い取引の金額です。
説明この属性は、支払い依頼に関連する金額を示します。財務上の処理量やリスクを分析する際の主な指標です。分析では、このフィールドを使って高額・少額の支払いに分けてプロセスを比較します。金額によって承認経路が異なる場合があります。「支払い処理量」ダッシュボードにも使われ、高額の支払いが厳格な審査によって長いサイクル時間を要しているかを把握できます。重要な理由プロセスマイニングに金額の観点を加え、金額に応じた優先順位付けを可能にします。入手先 FIS Globalの文書を参照例 1500.00250.501000000.0045.99
	支払期日 PaymentDueDate	支払いの決済が予定されている期日です。
説明この属性には、依頼者が指定した、または請求書の条件で定められた支払い期限が記録されます。期日どおりに処理できたかを測る基準となります。「支払期日の遵守状況」ダッシュボードに欠かせないフィールドです。この日付と実際の「支払い決済完了」日を比較することで、遅延した支払いの特定、想定される違約金の算出、取引先との契約の遵守状況の評価ができます。重要な理由サービスレベルの遵守状況と処理の適時性を測る基準となります。入手先 FIS Globalの文書を参照例 2023-11-012023-11-15
	通貨コード CurrencyCode	支払い通貨を示す3文字のISOコードです。
説明この属性は、支払い金額の通貨（例：USD、EUR、GBP）を示します。世界各地の支払いの流れを分析する際に、財務データを同じ基準にそろえるために必要です。分析では、このフィールドを使って通貨別にプロセスのパフォーマンスを比較できます。通貨によって決済システムや規制が異なる場合があり、国際送金と国内送金で決済時間に差が生じる理由の把握にも役立ちます。重要な理由複数通貨を扱う環境で、取引金額を正確に解釈するために欠かせません。入手先 FIS Globalの文書を参照例 USDEURGBPJPY
	ソースシステム SourceSystem	イベントデータの発生元となるシステムの名称です。
説明この属性は、コアバンキングエンジン、支払いゲートウェイ、制裁対象者のスクリーニングツールなど、レコードの抽出元となったソフトウェアコンポーネントまたはデータベースを特定します。データの来歴確認と検証に欠かせません。複数のプラットフォームにまたがる一連の流れを分析する際、各アクティビティがどこで行われたかを区別し、データ品質の問題を調査するのに役立ちます。重要な理由複数の支払いエンジンが連携する複雑な環境でも、追跡可能性とコンテキストを確保できます。入手先 FIS Globalの文書を参照例 FIS OPFTraxPaymentHub_01SanctionsScreeningDB
	最終データ更新日時 LastDataUpdate	レコードが最後に抽出または更新された日時です。
説明この属性は、分析に使うデータの鮮度を示します。リアルタイムのデータを見ているのか、過去のある時点のデータを見ているのかを把握できます。ダッシュボードでは、「データ基準日時」の表示に使われることがあります。利用可能な最新情報に基づく意思決定を支え、差分データの読み込み管理にも役立ちます。重要な理由データの最新性を明確にし、レポートの鮮度に対する信頼を高めます。入手先 ETLプロセスのメタデータ例 2023-10-14T00:00:00Z2023-10-15T06:00:00Z
	受取人の国 BeneficiaryCountry	支払いの受取人の国コードです。
説明この属性は、資金の送金先となる国を示し、国内送金と国際送金の区別に使われます。「支払いコンプライアンスのモニタリング」と経路分析に欠かせない情報です。国際送金では仲介機関やコンプライアンスチェックが異なり、サイクル時間も長くなることが多いため、国別に分析することで、こうした要因を切り分けられます。重要な理由地域別の分析やコンプライアンスリスクの評価に役立つ重要な軸です。入手先 FIS Globalの文書を参照例米国ドイツ中国英国
	手動介入の有無 IsManualIntervention	アクティビティに手作業が含まれていたかどうかを示すフラグです。
説明この真偽値属性は、「支払いエラーの解決」や手動承認など、人の作業が必要だったアクティビティまたはケースを示します。人手を介さずに処理する方式（STP）とは区別されます。「手動支払い介入率」ダッシュボードに欠かせません。完全自動化されていない支払いの割合を定量化し、デジタル化を進める余地を明らかにします。重要な理由自動処理量と手作業の負荷を区別でき、自動化の投資対効果の算出に役立ちます。入手先 ActivityNameまたはProcessingUserから算出例 truefalse
	承認権限 ApprovalAuthority	支払いを承認する責任を持つ役職、グループ、または個人です。
説明この属性は、金額のしきい値などに基づいて支払いの承認に必要となる権限レベルまたはユーザーグループを示します。承認ワークフローの経路を追跡するのに役立ちます。分析では、「支払い承認のボトルネック」ダッシュボードに利用できます。権限レベルごとに承認時間を分けて、特定の管理階層が遅延の原因になっていないかを確認できます。重要な理由承認階層を組織単位で分析し、ボトルネックを特定できます。入手先 FIS Globalの文書を参照例レベル1のマネージャーCFOコンプライアンスチーム自動承認システム
	支払いチャネル PaymentChannel	支払い依頼が開始されたチャネルです。
説明この属性は、オンラインバンキング、モバイルアプリ、API、支店など、支払い指示の発生元を示します。取引がどの経路から入力されたかを把握できます。分析では、チャネルごとに処理効率を比較できます。たとえば、API経由の支払いは支店で手入力された支払いよりエラー率が低いかどうかを確認できます。重要な理由チャネルの改善や顧客行動の把握に役立ちます。入手先 FIS Globalの文書を参照例オンラインバンキングモバイルアプリ法人向けゲートウェイ支店窓口
	支払い遅延の有無 IsLatePayment	支払いが期日を過ぎてから決済されたかどうかを示すフラグです。
説明計算によって求める真偽値属性です。「支払い決済完了」日が「支払期日」より後の場合にtrueを返します。この属性は、「期日どおりの支払い率」を直接算出するために使われます。可視化画面で複雑な日付条件を設定しなくても、問題のあるケースをすばやく絞り込めるため、ダッシュボードの作成が簡単になります。重要な理由例外のレポート作成とコンプライアンス分析を簡単にします。入手先 PaymentDueDateとActualSettlementDateから算出例 truefalse
	検証エラーコード ValidationErrorCode	支払いの検証に失敗した理由を示すコードまたは説明です。
説明支払いが「支払いエラーの検出」アクティビティに進んだとき、この属性に値が設定されます。「IBANが無効」「残高不足」「受取人住所が未入力」など、失敗の詳細が記録されます。このフィールドは、「支払いデータ検証エラー率」ダッシュボードに使われます。この属性でグループ化すると、手戻りの主な原因がわかり、上流のデータ入力やシステム設定を的確に修正できます。重要な理由プロセスの停滞や手戻りのループを引き起こす根本原因を特定できます。入手先 FIS Globalの文書を参照例 ERR-001：口座が無効ERR-055：制裁対象者との一致ERR-009：取引の重複
	送金元口座 SenderAccount	資金が引き落とされる口座番号です。
説明この属性は、取引の送金元口座を特定します。特定の社内口座からの支払いを詳しく分析できます。分析では、特定の資金口座でエラー（例：残高不足）や遅延が起きやすいかを確認できます。また、元帳の記録とプロセスのアクティビティを照合する際にも役立ちます。重要な理由財務照合や口座単位の問題解決に欠かせません。入手先 FIS Globalの文書を参照例 123456789987654321ACC-TREASURY-01

必須推奨任意

支払処理のアクティビティ

プロセスを正確に把握し、改善するために、イベントログに記録する主な処理手順と節目です。

6 推奨 7 任意

	アクティビティ	説明
	支払いの最終承認	高額の支払い、または最初の承認後に別の権限者による確認が必要な場合に行われる最終承認を示します。承認権限を持つユーザーが支払いを確定すると、明示的なイベントとして記録されます。
重要な理由このアクティビティは「Payment Authorization Bottlenecks」ダッシュボードの分析に欠かせません。「Payment Approved」と分けて確認することで、複数段階の承認プロセスにおける遅延箇所を特定しやすくなります。入手先監査ログまたは取引ログに記録されます。特定の承認権限を持つユーザーが支払いを処理するとイベントが発生し、ユーザーIDとタイムスタンプを含むレコードが作成されます。記録ユーザーが最終承認を行うと、明示的なログエントリが作成されます。イベントタイプ explicit
	支払いの承認	権限を持つユーザーが支払いを承認し、次の段階に進める重要な節目です。通常、ユーザーがシステムで操作した際に、承認者のIDとタイムスタンプを含む明示的なイベントとして記録されます。
重要な理由承認サイクルタイムの測定や、財務管理の遵守状況を確認するための重要なチェックポイントです。この段階で遅延が起きると、期日どおりの支払い実績に大きく影響することがあります。入手先承認ログテーブル、またはメインの取引履歴に明示的なイベントとして記録されます。イベントログにはPayment Transaction ID、承認者のユーザーID、承認タイムスタンプが関連付けられます。記録承認権限を持つユーザーが支払いに対して「approve」操作を行った際に記録されます。イベントタイプ explicit
	支払い依頼の作成	これは支払いのライフサイクルで最初に発生するイベントで、FISシステムで新しい支払い取引が開始された時点を示します。通常、ユーザーまたは自動システムが新しい支払い依頼を送信した際、取引ログテーブルに明示的な記録として残ります。
重要な理由このアクティビティは、プロセスの明確な開始点となります。支払いサイクルタイム全体の測定や、支払いの処理量と件数の分析に欠かせません。入手先中核となる取引テーブルに記録され、Payment Transaction IDに関連付けられた作成タイムスタンプで特定できます。「Payment_Transactions」や「Payment_Requests」などのテーブルで、「creation_date」または「entry_date」フィールドを確認してください。記録新しい支払い取引レコードの作成時に記録されるイベント。イベントタイプ explicit
	支払い指図の送信	FISシステムが確定した支払い指図を、ACH、Fedwire、SWIFTなどの該当する決済ネットワークに送信した時点を示します。システムによって生成される重要なイベントです。
重要な理由支払いが社内の処理環境を離れたことを示す重要な節目です。振り分けの効率や外部処理にかかる時間を分析するうえで欠かせません。入手先外部の決済ネットワークとの通信を追跡する取引ログまたはメッセージログに記録されます。タイムスタンプ付きの送信成功記録を確認してください。記録支払いメッセージが決済ネットワークに送信された際に、システムが記録するイベント。イベントタイプ explicit
	支払い決済完了	資金移動の完了を示すアクティビティです。この時点で、取引は財務上決済済みとみなされます。通常、支払いネットワークまたは決済機関から最終決済の確認を受け取ったときに記録されます。
重要な理由支払いサイクル時間と期日どおりの支払い率を測定する際の主な終点です。支払い処理の中核となる一連の業務が正常に完了したことを示します。入手先支払いレコードの最終ステータスが「決済済み」「完了」または「転記済み」に変わったことから判定します。このステータス変更は、一括決済ファイルまたは決済システムからのリアルタイムメッセージによって発生します。記録支払い取引のステータスが「決済済み」または同等の状態に変わったことを示します。イベントタイプ inferred
	支払い照合完了	支払い取引を銀行明細または社内元帳の記録と照合する、最後の会計アクティビティです。一括処理で自動的に行う場合と、ユーザーが手動で行う場合があります。
重要な理由このアクティビティは、支払いライフサイクルの最終段階を示します。「支払い照合サイクル時間」を分析することは、決算業務の効率を把握するうえで重要です。入手先多くの場合、支払いシステムと連携する財務または会計モジュールで、reconciliation_dateフィールドに値が設定されたこと、または最終ステータスが「照合済み」に変わったことから判定します。記録照合日が設定されたこと、またはステータスが「照合済み」に変わったことから判定します。イベントタイプ inferred
	支払いエラーの検出	初期検証後のプロセスのいずれかの時点で、受取銀行による拒否や社内のコンプライアンス上の警告などのエラーが検出されたことを示します。例外が発生した際に、明示的なイベントとして記録されることがよくあります。
重要な理由このアクティビティは、すべての手戻りや例外処理のループの起点です。手動介入率や支払いエラー解決時間の重要業績評価指標（KPI）を算出するうえで欠かせません。入手先例外処理モジュールまたは取引ログに記録されます。システムルールによって自動的に発生する場合と、ユーザーが問題を報告して手動で発生させる場合があります。エラーコードと日時を含むログが作成されます。記録支払い取引に関連付けて、例外またはエラーコードが記録されます。イベントタイプ explicit
	支払いエラーの解決	特定済みの支払いエラーが解決され、支払いの再処理またはキャンセルが可能になったことを示します。ユーザーが例外ステータスを解除するために行う明示的な操作です。
重要な理由このアクティビティによって例外処理のループが終了します。「エラー検出」からこのイベントまでの時間は、例外処理の業務効率を測る重要な指標です。入手先ユーザーがエラーフラグを解除したとき、または取引を例外キューから移動したときに記録されます。この操作は、日時とともに監査証跡または取引履歴ログに記録されます。記録ユーザーの操作によってエラー状態が解除され、その内容が監査ログに記録されます。イベントタイプ explicit
	支払いの却下	承認者が支払い依頼を却下した際に発生するアクティビティです。通常、修正して再申請するか、依頼全体を取り消す必要があります。監査のため、ユーザーの操作として明示的に記録されます。
重要な理由却下を追跡すると、支払いが失敗する一般的な理由、プロセス逸脱、手戻りのループを特定できます。初期データの品質やコンプライアンスに関する問題も明らかになります。入手先承認者が「reject」を選択した際、承認履歴または取引履歴テーブルに明示的なイベントとして記録されます。通常、タイムスタンプ、ユーザーID、理由コードが含まれます。記録ユーザーが支払いに対して「reject」操作を実行した際に記録されるイベント。イベントタイプ explicit
	支払いの確認	支払いネットワークまたは受取銀行から、支払いを受領した旨の確認を受け取ったことを示します。このイベントは、システムへのメッセージ受信またはステータス更新によって発生します。
重要な理由確認を受け取ることで、支払いが宛先に到達したことを把握できます。「指示送信」から「確認済み」までの時間は、外部ネットワークの遅延と処理時間を示します。入手先支払いネットワークから受信した確認メッセージを解析して記録します。システムは支払いステータスを更新し、確認日時を記録します。記録決済ネットワークからの受信メッセージにより、支払いステータスが「確認済み」に更新されます。イベントタイプ explicit
	支払いを承認に回付	検証済みの支払いが承認ワークフローに送られた時点を示します。通常、承認者の対応待ちになったことを示すステータス変更として記録されます。
重要な理由このアクティビティは、承認サブプロセスの開始を示します。この時点から「Payment Approved」までの時間を分析することは、承認のボトルネックを把握するうえで重要です。入手先ワークフローまたは取引ステータスログで、支払いのステータスフィールドが「Pending Approval」、「Submitted for Approval」または同様の状態に変わったことから推定します。記録支払い取引のステータスが「Validated」から「Pending Approval」に変わったこと。イベントタイプ inferred
	支払い詳細の検証	このアクティビティは、支払いデータが形式、完全性、正確性に関する初期の自動検証を通過したことを示します。支払いレコードのステータスが「New」から「Validated」または「Pending Approval」に変わったことから推定できる場合もあります。
重要な理由このアクティビティを追跡すると、データ入力エラーの頻度と発生箇所を特定できます。支払いデータ検証エラー率の重要業績評価指標（KPI）を分析し、手戻りの原因を把握するために必要な情報です。入手先支払い取引テーブルのステータスまたは状態の変更から推定します。初期状態から「validated」状態への変更と、それに対応するタイムスタンプがこのイベントを示します。記録支払いステータスフィールドが「Validated」または同様の値に変わったことで特定します。イベントタイプ inferred
	支払い遅延の検出	支払いが指定期日を過ぎてから決済されたことを示す派生イベントです。このアクティビティは明示的には記録されず、2つの日付フィールドを比較して算出されます。
重要な理由この算出アクティビティは、「期日どおりの支払い率」の重要業績評価指標（KPI）と「支払期日の遵守状況」ダッシュボードに直接役立ちます。プロセスの遅延が取引先との関係や遅延損害金に及ぼす影響を定量化できます。入手先データから直接抽出する項目ではありません。データ変換時に「決済日」の日時と「支払期日」フィールドを比較して算出します。決済日が支払期日より後の場合、このイベントが生成されます。記録「決済日」＞「支払期日」の場合に算出されます。イベントタイプ calculated

推奨任意

データ抽出ガイド

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

ステップ

FIS Globalの決済エンジンが、pacs.008支払指示やpacs.002支払ステータスレポートなどのISO 20022 XMLメッセージを、アクセス可能なファイルシステム上に生の形式で保管していることを確認します。アーカイブのパス、ファイル名の規則、名前空間の設定、保存期間、およびPayment Transaction IDとEndToEndId、TxId、InstrId、UETRなどのISO 20022識別子との対応関係を確認します。
Python 3.10以降と、スクリプトで使用する標準ライブラリのモジュール（pathlib、xml.etree.ElementTree、csv、datetime、decimal、collectionsなど）をインストールします。参照実装では外部パッケージは不要です。実行アカウントにXMLアーカイブの読み取り権限と、ProcessMindの出力ファイルへの書き込み権限があることを確認します。
スクリプトの設定セクションで、入力ディレクトリ、出力ファイル、開始日、終了日、タイムゾーン、会社固有のフィルターを設定します。文書化されたプレースホルダーのみを置き換えてください。代表的なファイルで識別子の対応関係を検証するまでは、ファイル名やXML要素にProcessMindのケース識別子が含まれると想定しないでください。
正常終了、却下、失敗、修復、決済済みの取引から、代表的なpacs.008およびpacs.002ファイルを確認します。XML名前空間を確認し、取引識別子、金額、通貨、希望実行日、決済日、ステータスコード、理由コード、イベントタイムスタンプ、処理ユーザーまたはシステムエージェント、支払種別、事業部門を含む要素を特定します。FIS環境で異なるパスが使われている場合は、設定済みのXPath候補を更新します。
まず短い期間を指定してスクリプトを実行します。パーサーは各XMLファイルを読み込み、メッセージ単位と取引単位のデータを抽出し、ISO 20022のステータスコードと理由コードを明示的なアクティビティに対応付けて、抽出したアクティビティごとにイベント行を出力します。また、明示的なエラーまたは修復の指標に基づいて「支払エラーを特定」「支払エラーを解決」の行を作成し、決済日が支払期日より後の場合に限り「支払遅延を特定」を作成します。
生成されたCSVと検証レポートを確認します。すべての行でPaymentTransactionId、ActivityName、EventTimestampが入力されていること、必須の13種類のアクティビティ名がすべて発生し得ること、タイムスタンプが一貫した形式に正規化されていることを確認します。抽出期間を広げる前に、識別子の欠落、未対応のステータスコード、重複イベント、日付の不整合がある取引を調査します。
イベント件数をソースアーカイブと照合し、利用できる場合はFISの業務レポートや監査データとも比較します。承認、却下、認証、指示の送信、ネットワーク応答、決済、エラー処理、照合、支払遅延の判定を含め、サンプル取引を最初から最後まで検証します。業務上の追跡が必要な場合は、監査出力にソースファイル名とソース行またはメッセージ参照を残します。
対象期間のソースアーカイブが完成した後にスクリプトを実行するようスケジュールするか、管理された重複期間を設けて増分実行し、遅れて届くpacs.002メッセージを取り込みます。PaymentTransactionId、ActivityName、EventTimestamp、ソースメッセージ識別子を使って重複を除外します。ただし、ソースに複数回記録された正当なアクティビティは保持します。
最終的なイベントログを、イベントごとに1行のUTF-8 CSVとしてエクスポートします。列はPaymentTransactionId、ActivityName、EventTimestamp、ProcessingUser、PaymentAmount、CurrencyCode、PaymentType、PaymentDueDate、ActualSettlementDate、BusinessUnitとします。ファイルをProcessMindにアップロードし、PaymentTransactionIdをケース識別子、ActivityNameをアクティビティ、EventTimestampをイベントタイムスタンプに設定します。ProcessMindはイベントログをそのまま読み込み、欠落したアクティビティを推測しません。

設定

入力アーカイブのパス：生のISO 20022 XMLファイルが格納されているディレクトリを設定します。日付、会社、メッセージ種別、処理ステータスごとにアーカイブが分割されている場合は、関連するすべてのサブディレクトリを含めます。
メッセージ種別：支払指示のpacs.008と支払ステータスレポートのpacs.002を含めます。その他のメッセージ種別は、FIS環境で識別子とステータスの意味を検証してから追加します。
識別子の対応付け：Payment Transaction IDを特定するXPath候補を設定します。FISの取引レコードと関連するすべてのISO 20022メッセージで一貫して使われている識別子を優先します。文書化された相関ルールなしに、関連のない識別子を組み合わせないでください。
アクティビティの対応付け：作成、検証、承認申請、承認、却下、認証、指示の送信、確認、決済、エラーの特定、エラーの解決、照合に関するステータスコードと理由コードの対応関係を設定します。提供されたスクリプトは設定可能な対応関係と明示的なソース指標を使い、通常のライフサイクルイベントをレコードの欠落から推測しません。
対象期間：まず3～6か月分のデータを対象にします。初期テスト時や大量のアーカイブを処理する場合は期間を短くし、ステータスメッセージが元の支払日より後に届く可能性がある場合は重複期間を設けます。
日付フィルター：利用できる場合は、ソースのイベントタイムスタンプを使って開始日と終了日を設定します。メッセージにイベントタイムスタンプがない場合、明示的に有効化したときに限り、ファイルの更新日時を代わりに使用できます。この値は業務イベントのタイムスタンプではないため、代替値として使うことを文書化してください。
会社・組織のフィルター：会社、事業部門、法人、支払商品、文書種別のフィルターは、対応するXML要素が存在し、値が検証済みの場合に限り設定します。実装固有のフィルターには[Configure based on your system]を使用します。
タイムゾーン：ソースシステムのタイムゾーン、またはUTCへの正規化方針を設定します。イベントの順序を正しく保つため、すべてのメッセージに同じ方針を適用します。
エラー・修復の指標：「支払エラーを特定」と「支払エラーを解決」に該当するステータスコード、理由コード、明示的な修復または例外の指標を設定します。承認済みの業務定義でない限り、却下をすべてエラーに分類しないでください。
照合の指標：FIS環境で使われている明示的な照合ステータス、照合メッセージ、台帳との一致を示すマーカー、またはバッチ結果を設定します。照合情報がXMLアーカイブ以外に保存されている場合は、承認済みの別ソースと相関ルールを指定します。
パフォーマンス：アーカイブ全体をメモリに読み込まず、ファイルを順次処理します。大量の処理は日付またはディレクトリで分割し、中間出力を保存して、十分な空き容量のあるローカルのステージング領域を使用します。非常に大きなアーカイブを並列処理する場合は、出力順序と重複排除を適切に管理できることを確認してから、独立したディレクトリ単位で実行します。
前提条件：XMLアーカイブへの読み取りアクセス、出力先への書き込みアクセス、Pythonの実行権限、支払データへの承認済みアクセス、FISの識別子とステータスコードの検証済み対応表が必要です。このファイルベースの方法では、特定のFIS取引コード、メニューの場所、APIエンドポイント、テーブル名、ライセンスを前提としていません。

クエリの例 python

from __future__ import annotations

import csv
import hashlib
import re
import sys
import xml.etree.ElementTree as ET
from collections import defaultdict
from datetime import date, datetime, timezone
from decimal import Decimal, InvalidOperation
from pathlib import Path
from typing import Dict, Iterable, List, Optional, Tuple

class=class="hl-string">"hl-comment"># Replace only these documented placeholders.
INPUT_DIRECTORY = Path(class="hl-string">"[Your XML archive directory]")
OUTPUT_FILE = Path(class="hl-string">"[Your ProcessMind event log output path].csv")
START_DATE = class="hl-string">"[YYYY-MM-DD]"
END_DATE = class="hl-string">"[YYYY-MM-DD]"
SOURCE_TIMEZONE = timezone.utc
COMPANY_FILTER = class="hl-string">""  class=class="hl-string">"hl-comment"># Leave empty unless a validated company or business-unit value is required.

class=class="hl-string">"hl-comment"># Update these candidates after inspecting representative FIS XML files.
IDENTIFIER_PATHS = [
    class="hl-string">"EndToEndId", class="hl-string">"TxId", class="hl-string">"InstrId", class="hl-string">"UETR", class="hl-string">"PaymentTransactionId",
    class="hl-string">"PaymentId", class="hl-string">"TransactionId"
]
AMOUNT_PATHS = [class="hl-string">"InstdAmt", class="hl-string">"IntrBkSttlmAmt", class="hl-string">"Amt", class="hl-string">"Amount"]
CURRENCY_PATHS = [class="hl-string">"InstdAmt", class="hl-string">"IntrBkSttlmAmt", class="hl-string">"Amt", class="hl-string">"Currency", class="hl-string">"Ccy"]
DUE_DATE_PATHS = [class="hl-string">"ReqdExctnDt", class="hl-string">"ReqdColltnDt", class="hl-string">"DueDate", class="hl-string">"RequestedExecutionDate"]
SETTLEMENT_DATE_PATHS = [class="hl-string">"SttlmDt", class="hl-string">"SettlementDate", class="hl-string">"ActualSettlementDate"]
TIMESTAMP_PATHS = [
    class="hl-string">"CreDtTm", class="hl-string">"AccptncDtTm", class="hl-string">"AccptncDt", class="hl-string">"OrgnlCreDtTm", class="hl-string">"TxDtTm",
    class="hl-string">"SttlmDt", class="hl-string">"SettlementDate", class="hl-string">"EventTimestamp", class="hl-string">"Timestamp"
]
USER_PATHS = [class="hl-string">"UserId", class="hl-string">"UserID", class="hl-string">"Operator", class="hl-string">"Approver", class="hl-string">"ProcessingUser", class="hl-string">"Initiator"]
PAYMENT_TYPE_PATHS = [class="hl-string">"PmtMtd", class="hl-string">"SvcLvl", class="hl-string">"LclInstrm", class="hl-string">"CtgyPurp", class="hl-string">"PaymentType"]
BUSINESS_UNIT_PATHS = [class="hl-string">"BusinessUnit", class="hl-string">"CompanyCode", class="hl-string">"Company", class="hl-string">"OrgUnit", class="hl-string">"LegalEntity"]
STATUS_PATHS = [class="hl-string">"TxSts", class="hl-string">"GrpSts", class="hl-string">"Status", class="hl-string">"PaymentStatus", class="hl-string">"TransactionStatus"]
REASON_PATHS = [class="hl-string">"Cd", class="hl-string">"Rsn", class="hl-string">"ReasonCode", class="hl-string">"StatusReason", class="hl-string">"AddtlInf"]
ERROR_PATHS = [class="hl-string">"Error", class="hl-string">"Exception", class="hl-string">"Failure", class="hl-string">"ErrorCode", class="hl-string">"ExceptionCode"]
REPAIR_PATHS = [class="hl-string">"Repair", class="hl-string">"Resolved", class="hl-string">"Resolution", class="hl-string">"ErrorResolved", class="hl-string">"ExceptionResolved"]
RECONCILIATION_PATHS = [class="hl-string">"Reconciled", class="hl-string">"ReconciliationStatus", class="hl-string">"LedgerMatched", class="hl-string">"BankStatementMatched"]

class=class="hl-string">"hl-comment"># Validate and extend these mappings against the FIS implementation.
STATUS_ACTIVITY_MAP = {
    class="hl-string">"NEW": class="hl-string">"Payment Request Created",
    class="hl-string">"RECEIVED": class="hl-string">"Payment Request Created",
    class="hl-string">"VALIDATED": class="hl-string">"Payment Details Validated",
    class="hl-string">"PENDING_APPROVAL": class="hl-string">"Payment Sent For Approval",
    class="hl-string">"AWAITING_APPROVAL": class="hl-string">"Payment Sent For Approval",
    class="hl-string">"APPROVAL_PENDING": class="hl-string">"Payment Sent For Approval",
    class="hl-string">"APPROVED": class="hl-string">"Payment Approved",
    class="hl-string">"REJECTED": class="hl-string">"Payment Rejected",
    class="hl-string">"AUTHORIZED": class="hl-string">"Payment Authorized",
    class="hl-string">"SENT": class="hl-string">"Payment Instruction Sent",
    class="hl-string">"DISPATCHED": class="hl-string">"Payment Instruction Sent",
    class="hl-string">"ACCP": class="hl-string">"Payment Confirmed",
    class="hl-string">"ACCEPTED": class="hl-string">"Payment Confirmed",
    class="hl-string">"CONFIRMED": class="hl-string">"Payment Confirmed",
    class="hl-string">"SETTLED": class="hl-string">"Payment Settled",
    class="hl-string">"BOOK": class="hl-string">"Payment Settled",
    class="hl-string">"RECONCILED": class="hl-string">"Payment Reconciled",
}
ERROR_STATUS_CODES = {class="hl-string">"RJCT", class="hl-string">"REJECTED", class="hl-string">"FAILED", class="hl-string">"ERROR", class="hl-string">"EXCEPTION", class="hl-string">"CANCELLED"}
RESOLVED_STATUS_CODES = {class="hl-string">"REPAIRED", class="hl-string">"RESOLVED", class="hl-string">"CORRECTED", class="hl-string">"REPROCESSING", class="hl-string">"REPROCESSED"}

OUTPUT_COLUMNS = [
    class="hl-string">"PaymentTransactionId", class="hl-string">"ActivityName", class="hl-string">"EventTimestamp", class="hl-string">"ProcessingUser",
    class="hl-string">"PaymentAmount", class="hl-string">"CurrencyCode", class="hl-string">"PaymentType", class="hl-string">"PaymentDueDate",
    class="hl-string">"ActualSettlementDate", class="hl-string">"BusinessUnit"
]


def local_name(tag: str) -> str:
    return tag.rsplit(class="hl-string">"}", 1)[-1].lower()


def text_values(root: ET.Element, candidates: Iterable[str]) -> List[str]:
    wanted = {candidate.lower() for candidate in candidates}
    values: List[str] = []
    for element in root.iter():
        if local_name(element.tag) in wanted:
            value = (element.text or class="hl-string">"").strip()
            if value:
                values.append(value)
            for key, attribute_value in element.attrib.items():
                if key.rsplit(class="hl-string">"}", 1)[-1].lower() in {class="hl-string">"ccy", class="hl-string">"currency"} and attribute_value.strip():
                    values.append(attribute_value.strip())
    return values


def first_value(root: ET.Element, candidates: Iterable[str]) -> str:
    values = text_values(root, candidates)
    return values[0] if values else class="hl-string">""


def normalize_code(value: str) -> str:
    return re.sub(rclass="hl-string">"[^A-Z0-9_]", class="hl-string">"", value.upper().replace(class="hl-string">"-", class="hl-string">"_"))


def parse_datetime(value: str) -> Optional[datetime]:
    if not value:
        return None
    candidate = value.strip()
    if candidate.endswith(class="hl-string">"Z"):
        candidate = candidate[:-1] + class="hl-string">"+00:00"
    try:
        parsed = datetime.fromisoformat(candidate)
    except ValueError:
        for fmt in (class="hl-string">"%Y-%m-%d %H:%M:%S", class="hl-string">"%Y-%m-%d", class="hl-string">"%Y%m%d%H%M%S", class="hl-string">"%Y%m%d"):
            try:
                parsed = datetime.strptime(value.strip(), fmt)
                break
            except ValueError:
                parsed = None
        if parsed is None:
            return None
    if parsed.tzinfo is None:
        parsed = parsed.replace(tzinfo=SOURCE_TIMEZONE)
    return parsed.astimezone(timezone.utc)


def output_timestamp(value: Optional[datetime]) -> str:
    return value.astimezone(timezone.utc).isoformat().replace(class="hl-string">"+00:00", class="hl-string">"Z") if value else class="hl-string">""


def output_date(value: str) -> str:
    parsed = parse_datetime(value)
    return parsed.date().isoformat() if parsed else (value[:10] if re.match(rclass="hl-string">"^\d{4}-\d{2}-\d{2}", value) else class="hl-string">"")


def normalize_amount(value: str) -> str:
    if not value:
        return class="hl-string">""
    try:
        return format(Decimal(value.replace(class="hl-string">",", class="hl-string">"").strip()), class="hl-string">"f")
    except InvalidOperation:
        return value.strip()


def source_message_id(path: Path, root: ET.Element) -> str:
    raw = path.as_posix() + class="hl-string">"|" + first_value(root, [class="hl-string">"MsgId", class="hl-string">"MessageId", class="hl-string">"BizMsgIdr"])
    return hashlib.sha256(raw.encode(class="hl-string">"utf-8")).hexdigest()


def in_date_range(event_time: Optional[datetime]) -> bool:
    if not event_time:
        return True
    start = datetime.fromisoformat(START_DATE).replace(tzinfo=timezone.utc)
    end = datetime.fromisoformat(END_DATE).replace(tzinfo=timezone.utc)
    return start <= event_time < end.replace(hour=23, minute=59, second=59, microsecond=999999)


def add_event(events: List[Dict[str, str]], seen: set, transaction_id: str, activity: str,
              event_time: Optional[datetime], user: str, amount: str, currency: str,
              payment_type: str, due_date: str, settlement_date: str, business_unit: str,
              message_id: str) -> None:
    if not transaction_id or not event_time or not in_date_range(event_time):
        return
    row = {
        class="hl-string">"PaymentTransactionId": transaction_id,
        class="hl-string">"ActivityName": activity,
        class="hl-string">"EventTimestamp": output_timestamp(event_time),
        class="hl-string">"ProcessingUser": user,
        class="hl-string">"PaymentAmount": amount,
        class="hl-string">"CurrencyCode": currency,
        class="hl-string">"PaymentType": payment_type,
        class="hl-string">"PaymentDueDate": output_date(due_date),
        class="hl-string">"ActualSettlementDate": output_date(settlement_date),
        class="hl-string">"BusinessUnit": business_unit,
    }
    key = (transaction_id, activity, row[class="hl-string">"EventTimestamp"], message_id)
    if key not in seen:
        seen.add(key)
        events.append(row)


def parse_file(path: Path, events: List[Dict[str, str]], seen: set) -> None:
    try:
        root = ET.parse(path).getroot()
    except (ET.ParseError, OSError) as exc:
        print(fclass="hl-string">"Could not parse {path}: {exc}", file=sys.stderr)
        return
    message_id = source_message_id(path, root)
    transaction_id = first_value(root, IDENTIFIER_PATHS)
    if not transaction_id:
        return
    business_unit = first_value(root, BUSINESS_UNIT_PATHS)
    if COMPANY_FILTER and business_unit != COMPANY_FILTER:
        return
    amount = normalize_amount(first_value(root, AMOUNT_PATHS))
    currency = first_value(root, CURRENCY_PATHS)
    if len(currency) != 3 and currency:
        currency = currency.upper()
    due_date = first_value(root, DUE_DATE_PATHS)
    settlement_date = first_value(root, SETTLEMENT_DATE_PATHS)
    user = first_value(root, USER_PATHS)
    payment_type = first_value(root, PAYMENT_TYPE_PATHS)
    status_values = text_values(root, STATUS_PATHS)
    reason_values = text_values(root, REASON_PATHS)
    error_values = text_values(root, ERROR_PATHS)
    repair_values = text_values(root, REPAIR_PATHS)
    reconciliation_values = text_values(root, RECONCILIATION_PATHS)
    event_time = parse_datetime(first_value(root, TIMESTAMP_PATHS))
    if not event_time:
        return

    message_name = next((local_name(element.tag) for element in root.iter() if local_name(element.tag) in {class="hl-string">"pacs.008", class="hl-string">"pacs.002", class="hl-string">"document"}), class="hl-string">"")
    normalized_statuses = [normalize_code(value) for value in status_values + reason_values]
    normalized_text = class="hl-string">" ".join(normalize_code(value) for value in error_values)
    normalized_repairs = class="hl-string">" ".join(normalize_code(value) for value in repair_values)
    normalized_reconciliation = class="hl-string">" ".join(normalize_code(value) for value in reconciliation_values)

    if message_name or status_values:
        add_event(events, seen, transaction_id, class="hl-string">"Payment Request Created", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"NEW", class="hl-string">"RECEIVED"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Details Validated", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if class="hl-string">"VALIDATED" in normalized_statuses else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Sent For Approval", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"PENDING_APPROVAL", class="hl-string">"AWAITING_APPROVAL", class="hl-string">"APPROVAL_PENDING"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Approved", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if class="hl-string">"APPROVED" in normalized_statuses else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Rejected", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"REJECTED", class="hl-string">"RJCT"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Authorized", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if class="hl-string">"AUTHORIZED" in normalized_statuses else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Instruction Sent", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"SENT", class="hl-string">"DISPATCHED"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Confirmed", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"ACCP", class="hl-string">"ACCEPTED", class="hl-string">"CONFIRMED"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Settled", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if any(code in {class="hl-string">"SETTLED", class="hl-string">"BOOK"} for code in normalized_statuses) else None
        add_event(events, seen, transaction_id, class="hl-string">"Payment Reconciled", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id) if class="hl-string">"RECONCILED" in normalized_statuses or any(code in normalized_reconciliation for code in {class="hl-string">"TRUE", class="hl-string">"MATCHED", class="hl-string">"RECONCILED"}) else None

    if any(code in ERROR_STATUS_CODES for code in normalized_statuses) or normalized_text:
        add_event(events, seen, transaction_id, class="hl-string">"Payment Error Identified", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id)
    if any(code in RESOLVED_STATUS_CODES for code in normalized_statuses) or any(code in normalized_repairs for code in {class="hl-string">"TRUE", class="hl-string">"RESOLVED", class="hl-string">"REPAIRED", class="hl-string">"CORRECTED"}):
        add_event(events, seen, transaction_id, class="hl-string">"Payment Error Resolved", event_time, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id)

    due = parse_datetime(due_date)
    settled = parse_datetime(settlement_date)
    if due and settled and settled.date() > due.date():
        add_event(events, seen, transaction_id, class="hl-string">"Late Payment Identified", settled, user, amount, currency, payment_type, due_date, settlement_date, business_unit, message_id)


def main() -> None:
    events: List[Dict[str, str]] = []
    seen = set()
    for path in sorted(INPUT_DIRECTORY.rglob(class="hl-string">"*.xml")):
        parse_file(path, events, seen)
    events.sort(key=lambda row: (row[class="hl-string">"PaymentTransactionId"], row[class="hl-string">"EventTimestamp"], row[class="hl-string">"ActivityName"]))
    OUTPUT_FILE.parent.mkdir(parents=True, exist_ok=True)
    with OUTPUT_FILE.open(class="hl-string">"w", newline=class="hl-string">"", encoding=class="hl-string">"utf-8") as handle:
        writer = csv.DictWriter(handle, fieldnames=OUTPUT_COLUMNS)
        writer.writeheader()
        writer.writerows(events)
    print(fclass="hl-string">"Wrote {len(events)} event rows to {OUTPUT_FILE}")


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

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

このテンプレートを使ってデータ収集を効率化し、支払処理の改善に取り組みましょう。プロセスの状況を正確に把握し、業務効率と財務管理を向上させる方法を見つけられます。

改善ガイドに戻る

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

FIS Globalの支払処理を今すぐ改善

ストレートスルー処理率98％を達成し、照合の問題を解消しましょう。

今すぐ無料トライアルを開始しましょう。

クレジットカード不要。数分で開始できます。

支払処理データテンプレート

支払処理データテンプレート

支払処理の属性

支払処理のアクティビティ

データ抽出ガイド

ISO 20022 XMLログファイルをPythonで解析

ステップ

設定

クエリの例 python

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

FIS Globalの支払処理を今すぐ改善