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

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

FIS Global

決済処理の属性 (19) 決済処理のアクティビティ (13) 抽出ガイド (1)

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

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

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

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

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

決済処理の属性

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

3 必須 7 推奨 9 任意

	名前	説明
	アクティビティ名 ActivityName	発生した特定のプロセスステップまたはイベントの名称です。
説明このフィールドには、特定の時点で実行された操作が記録されます。たとえば、「Payment Request Created」や「Payment Settled」などです。プロセスマップのノードを定義し、プロセスフローの構造を決めます。分析では、操作の順序を把握するためにこの属性を使います。標準経路からの逸脱、スキップされたステップ、複数回の承認ループのような重複アクティビティを特定するうえで重要です。重要な理由プロセスの「何が行われたか」を定義し、プロセスマップの可視化とバリアント分析を可能にします。入手先 FIS Globalのドキュメントを参照例支払い依頼を作成支払い詳細を検証支払いを承認支払い決済完了
	イベント日時 EventTimestamp	アクティビティが発生した具体的な日付と時刻です。
説明この属性は、支払いプロセスのすべてのイベントに時間的な文脈を与えます。システムに操作が記録された正確な時点を保持し、アクティビティを時系列に並べられるようにします。分析では、ステップ間の所要時間、合計サイクル時間、処理量を算出するために使います。プロセスステージ間の遅延を明らかにし、ボトルネックの特定にも役立ちます。重要な理由このフィールドがなければ時間に基づく分析はできません。すべてのパフォーマンスおよび効率性KPIの基盤となります。入手先 FIS Globalのドキュメントを参照例 2023-10-12T08:30:15Z2023-10-12T09:45:00Z2023-10-13T14:20:10Z
	支払い取引ID PaymentTransactionId	特定の支払い指図または取引を一意に識別する識別子です。
説明単一の支払いライフサイクルに含まれるすべてのイベントを関連付ける中心的なキーとなる属性です。初回依頼から検証、承認、最終決済または照合まで、支払いを追跡できます。分析では、このIDが個別のイベントをプロセスインスタンスごとにグループ化するために欠かせません。エンドツーエンドのフローを可視化でき、サイクル時間や手戻りループなど、ケース単位のすべての指標の基盤となります。重要な理由プロセスマイニングにおける基本的な連結要素です。異なるアクティビティを一貫した一連の流れとして再構成できます。入手先 FIS Globalのドキュメントを参照例 TRX-2023-899102PAY-US-99281ACH-7721-X99WIRE-2210-001
	事業部門 BusinessUnit	支払いを起票した社内の部門または部署です。
説明「リテールバンキング」、「コマーシャルレンディング」、「トレジャリー」など、支払いを特定の組織単位に関連付ける属性です。部門別に「支払い処理量」や「平均支払いサイクル時間」などのKPIを集計するために使います。経営層が部門間のパフォーマンスを比較し、リソースを適切に配分するのに役立ちます。重要な理由社内ベンチマーキングとプロセスパフォーマンスに対する説明責任を可能にします。入手先 FIS Globalのドキュメントを参照例トレジャリー買掛金リテールオペレーションウェルスマネジメント
	処理ユーザー ProcessingUser	アクティビティを実行したユーザーまたはシステムエージェントの識別子または名称です。
説明この属性は、プロセスステップを実行した主体またはシステムを記録します。人のオペレーター（例：「J.Smith」）と自動化されたシステムアカウント（例：「SYSTEM_BATCH」）を区別できます。リソース利用状況の分析、手動処理のボトルネックの特定、職務分掌の監査に使います。「処理ユーザー利用率」の算出や、手動タスクと自動タスクの区別にも役立ちます。重要な理由リソース分析、自動化率、コンプライアンス監査に欠かせません。入手先 FIS Globalのドキュメントを参照例 jsmithSYSTEM_AUTOBOTmdoe_approverAPI_GATEWAY
	実際の決済日 ActualSettlementDate	支払いが実際に確定し、決済された日付です。
説明資金が移動した、または取引が完了したとみなされた実効日を記録する属性です。価値日を反映するため、処理日時とは異なります。分析では、支払期日と組み合わせて「期限内支払い率」を算出します。また、照合フェーズの開始条件となるため、「支払い照合サイクル時間」の分析にも欠かせません。重要な理由支払いの財務上の完了を表し、キャッシュフロー分析の重要な要素となります。入手先 FIS Globalのドキュメントを参照例 2023-11-022023-11-14
	支払い種別 PaymentType	支払い方法または支払い手段の分類です。
説明この属性は、Wire、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のドキュメントを参照例 USDECNGB
	手動介入フラグ IsManualIntervention	アクティビティに手動作業が含まれていたかどうかを示すフラグです。
説明人による入力が必要だったアクティビティまたはケースを示す真偽値属性です。たとえば、「支払いエラーの解決」や手動承認などが該当し、STP（ストレートスルー処理）とは区別されます。「手動支払い介入率」ダッシュボードに欠かせません。完全自動化されていない支払いの割合を定量化し、デジタルトランスフォーメーションの機会を明らかにします。重要な理由自動化された処理量と手作業の負荷を区別し、自動化のROI算出を支援します。入手先 ActivityNameまたはProcessingUserから派生例 truefalse
	承認権限 ApprovalAuthority	支払いの承認を担当する役割、グループ、または個人です。
説明この属性は、支払い金額のしきい値などに基づき、支払いの承認に必要な権限レベルまたは特定のユーザーグループを示します。承認ワークフローの経路を追跡するのに役立ちます。「支払い承認ボトルネック」ダッシュボードを支える情報です。権限レベル別に承認時間を分解し、特定の管理階層が遅延を引き起こしていないかを確認できます。重要な理由承認階層の組織分析とボトルネックの検出を可能にします。入手先 FIS Globalのドキュメントを参照例レベル1マネージャーCFOコンプライアンスチーム自動承認システム
	支払いチャネル PaymentChannel	支払い依頼が開始された経路です。
説明オンラインバンキング、モバイルアプリ、API、支店など、支払い指図の発生元を示す属性です。取引の入力経路を把握できます。分析では、チャネルごとの処理効率を比較するために使います。たとえば、支店で手入力された支払いと比べて、API経由の支払いでエラー率が低いかを確認できます。重要な理由チャネルの最適化と顧客行動の把握に役立ちます。入手先 FIS Globalのドキュメントを参照例オンラインバンキングモバイルアプリ法人向けゲートウェイ支店窓口
	支払い遅延フラグ IsLatePayment	支払いが支払期日を過ぎて決済されたかどうかを示すフラグです。
説明算出される真偽値属性です。「支払い決済完了」日が「支払期日」より後の場合にtrueを返します。「期限内支払い率」KPIを直接算出する属性です。可視化レイヤーで複雑な日付ロジックを設定しなくても、問題のあるケースをすばやく絞り込めるため、ダッシュボード作成が容易になります。重要な理由例外レポートとコンプライアンス分析を簡素化します。入手先 PaymentDueDateとActualSettlementDateから派生例 truefalse
	検証エラーコード ValidationErrorCode	支払いの検証に失敗した理由を示すコードまたは理由です。
説明この属性は、支払いが「支払いエラーの特定」アクティビティに入ったときに設定されます。「無効なIBAN」、「残高不足」、「受取人住所の欠落」など、失敗の具体的な内容を含みます。「支払いデータ検証エラー率」ダッシュボードの基盤となります。この属性でグループ化すると、手戻りの主な原因が明らかになり、上流のデータ入力やシステム設定を対象とした改善が可能になります。重要な理由プロセス上の障害と手戻りループの根本原因を特定します。入手先 FIS Globalのドキュメントを参照例 ERR-001：口座が無効ですERR-055：制裁対象に該当しましたERR-009：取引が重複しています
	送金元口座 SenderAccount	資金が引き落とされる口座番号です。
説明この属性は、取引の資金元口座を識別します。特定の社内口座からの支払いを詳細に分析できます。分析では、特定の資金口座でエラー（残高不足など）や遅延が発生しやすいかを確認できます。元帳の記録とプロセスアクティビティを照合できるため、照合処理にも役立ちます。重要な理由財務照合と口座単位の問題解決に欠かせません。入手先 FIS Globalのドキュメントを参照例 123456789987654321ACC-TREASURY-01

必須推奨任意

決済処理のアクティビティ

正確なプロセスディスカバリーと最適化に向けて、イベントログに記録すべき主要なプロセス手順と節目です。

6 推奨 7 任意

	アクティビティ	説明
	支払いを承認	承認権限を持つユーザーが支払いを承認し、次の段階へ進められるようにする重要なマイルストーンです。通常は、ユーザーがシステム上で操作した時点で、承認者のIDとタイムスタンプを含む明示的なイベントとして記録されます。
重要な理由承認サイクル時間を測定し、財務統制への準拠を確認するための重要なチェックポイントです。この段階の遅延は、期日どおりの支払い実績に大きく影響する可能性があります。入手先承認ログテーブル、またはメインの取引履歴に明示的なイベントとして記録されます。イベントログには、Payment Transaction ID、承認者のユーザーID、承認タイムスタンプが記録されます。取得承認権限を持つユーザーが支払いに対して「approve」操作を行った時点で記録されます。イベントタイプ explicit
	支払いを認証	最終認証のステップを示します。高額な支払いや、初回承認後に別の権限者による確認が必要な場合に実施されます。認証資格を持つユーザーが支払いを確定した時点で、明示的なイベントとして記録されます。
重要な理由「Payment Authorization Bottlenecks」ダッシュボードの重要なアクティビティです。「Payment Approved」と分けて分析することで、複数段階の承認プロセスにおける遅延箇所を特定できます。入手先監査ログまたは取引ログに記録されます。特定の認証権限を持つユーザーが支払いに対して操作するとイベントが発生し、ユーザーIDとタイムスタンプを含むレコードが作成されます。取得ユーザーが最終認証操作を実行すると、明示的なログエントリが作成されます。イベントタイプ explicit
	支払い依頼を作成	支払いライフサイクルの最初のイベントで、FISシステムで新しい支払い取引が開始された時点を示します。通常は、ユーザーまたは自動システムが新しい支払い依頼を送信した際に、取引ログテーブルへ明示的なレコードとして記録されます。
重要な理由このアクティビティがプロセスの確定した開始点になります。支払いサイクル全体の時間を測定し、支払いの処理量と件数を分析するうえで欠かせません。入手先 Payment Transaction IDに関連付けられた作成タイムスタンプによって識別され、主要な取引テーブルに記録されます。「Payment_Transactions」や「Payment_Requests」のようなテーブルで、「creation_date」または「entry_date」フィールドを確認してください。取得新しい支払い取引レコードの作成時に記録されるイベントです。イベントタイプ explicit
	支払い指示を送信	FISシステムが確定した支払い指示を、ACH、Fedwire、SWIFTなどの該当する決済ネットワークへ送信した時点を示します。システムが生成する重要なイベントです。
重要な理由支払いが社内の処理環境を離れたことを示す主要なマイルストーンです。振り分けの効率や、外部処理にかかる時間を分析するうえで重要です。入手先外部の決済ネットワークとの通信を追跡する取引ログまたはメッセージログに記録されます。タイムスタンプ付きの送信成功メッセージを示すレコードを確認してください。取得支払いメッセージが決済ネットワークへ送信された際に、システムが生成するイベントです。イベントタイプ explicit
	支払い決済完了	このアクティビティは、資金移動の完了を示します。取引が財務上決済された状態です。通常は、支払いネットワークまたはクリアリングハウスから最終決済の確認を受け取った時点で記録されます。
重要な理由支払いサイクル時間と期限内支払い率を測定するための主要な終点です。支払い実行の中核プロセスが正常に完了したことを示します。入手先支払いレコードの最終ステータスが「Settled」、「Completed」、または「Posted」に変更されたことから推定されます。このステータス変更は、決済ファイルまたはクリアリングシステムからのリアルタイムメッセージによって発生します。取得支払い取引のステータスが「Settled」または同等の状態に変更されます。イベントタイプ inferred
	支払い照合完了	支払い取引を銀行取引明細または社内元帳の記録と照合する、最終的な会計アクティビティです。自動化された一括処理の場合と、ユーザーが手動で実行する場合があります。
重要な理由支払いライフサイクルの完全な終点を示すアクティビティです。「支払い照合サイクル時間」を分析することは、財務締め処理の効率を把握するうえで重要です。入手先多くの場合、「reconciliation_date」フィールドへの値の設定、または支払いシステムに接続された財務・会計モジュールでの最終ステータス「Reconciled」への変更から推定されます。取得照合日が設定されたこと、またはステータスが「Reconciled」に変更されたことによって特定されます。イベントタイプ inferred
	支払いエラーの特定	初期検証後のプロセスのいずれかの時点でエラーが検出されたことを示します。たとえば、受取銀行による拒否や、社内のコンプライアンスフラグなどです。通常は、例外が発生した際に明示的なイベントとして記録されます。
重要な理由すべての手戻りと例外処理ループの起点となるアクティビティです。手動介入率と支払いエラー解決時間のKPIを算出するために欠かせません。入手先例外処理モジュールまたは取引ログに記録されます。システムルールによって自動的に発生する場合と、ユーザーが問題を示すフラグを手動で設定して発生する場合があり、エラーコードと日時を含むログが作成されます。取得支払い取引に対して、例外コードまたはエラーコードが記録されます。イベントタイプ explicit
	支払いエラーの解決	特定済みの支払いエラーが解決されたことを示し、支払いの再処理またはキャンセルを可能にします。ユーザーが例外ステータスを解除するために明示的に実行する操作です。
重要な理由例外処理ループを終了するアクティビティです。「Error Identified」からこのイベントまでの時間は、例外処理における業務効率を測る重要な指標です。入手先ユーザーがエラーフラグを解除したとき、または取引を例外キューから移動したときに記録されます。この操作は、監査証跡または取引履歴ログに日時とともに記録されます。取得ユーザーの操作によってエラー状態が解除され、その内容が監査ログに記録されます。イベントタイプ explicit
	支払いを却下	承認者が支払い依頼を拒否した際に発生するアクティビティです。通常は、支払いを修正して再申請するか、完全にキャンセルする必要があります。監査目的で記録される明示的なユーザー操作です。
重要な理由却下を追跡すると、支払いが失敗する一般的な理由、プロセスの逸脱、やり直しループを特定できます。初期データの品質やコンプライアンスに関する問題も明らかになります。入手先承認者が「reject」オプションを選択した際に、承認履歴または取引履歴テーブルへ明示的なイベントとして記録されます。通常は、タイムスタンプ、ユーザーID、理由コードが含まれます。取得ユーザーが支払いに対して「reject」操作を実行した時点で記録されるイベントです。イベントタイプ explicit
	支払いを承認に回付	検証済みの支払いが承認ワークフローに送信された時点を示します。通常は、支払いが承認者の対応を待つ状態になったことを示すステータス変更として記録されます。
重要な理由このアクティビティが承認サブプロセスの開始点になります。ここから「Payment Approved」までの時間を分析することは、承認のボトルネックを把握するうえで重要です。入手先ワークフローまたは取引ステータスログで、支払いのステータスが「Pending Approval」、「Submitted for Approval」、または同様の状態に変わったことから推測します。取得支払い取引のステータスが「Validated」から「Pending Approval」に変わったことを示します。イベントタイプ inferred
	支払いを確認	支払いネットワークまたは受取人の銀行から、支払いを受領したことを示す確認を受け取ったことを表します。このイベントは、システムからの受信メッセージまたはステータス更新によって発生します。
重要な理由確認により、支払いが送金先に到達したことを確実に把握できます。「Instruction Sent」から「Confirmed」までの時間は、外部ネットワークの遅延と処理時間を測定します。入手先支払いネットワークから受信した確認メッセージを解析して生成されます。システムは支払いステータスを更新し、確認日時を記録します。取得クリアリングネットワークからの受信メッセージにより、支払いステータスが「Confirmed」に更新されます。イベントタイプ explicit
	支払い詳細を検証	支払いデータが、形式、完全性、正確性について初期の自動検証チェックに合格したことを示すアクティビティです。通常は、支払いレコードのステータスが「New」から「Validated」または「Pending Approval」へ変わったことから推測できます。
重要な理由このアクティビティを追跡すると、データ入力エラーの頻度と発生箇所を特定できます。Payment Data Validation Error Rate KPIを分析し、やり直しの原因を把握するための前提となります。入手先支払い取引テーブルのステータスまたは状態変更フィールドから推測します。初期状態から「validated」状態への変更と、それに対応するタイムスタンプによって、このイベントを特定できます。取得支払いステータスフィールドが「Validated」または同様の値に変更されたことで識別します。イベントタイプ inferred
	支払い遅延の特定	支払いが指定された支払期日を過ぎて決済されたことを示す派生イベントです。このアクティビティは明示的には記録されず、2つの日付フィールドを比較して算出されます。
重要な理由この算出アクティビティは、「期限内支払い率」KPIと「支払期日遵守状況」ダッシュボードを直接支えます。プロセスの遅延が取引先との関係や遅延損害金の可能性に与える影響を定量化できます。入手先直接抽出されるデータではありません。データ変換時に、「Settlement Date」の日時と「Payment Due Date」フィールドを比較して算出されます。決済日が支払期日より後の場合、このイベントが生成されます。取得「Settlement Date」>「Payment Due Date」の場合に算出されます。イベントタイプ 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のステータスコードと理由コードを明示的なアクティビティに対応付け、抽出したアクティビティごとに1行のイベントを出力します。また、明示的なエラーまたは修復の指標からPayment Error IdentifiedとPayment Error Resolvedの行を作成し、期日後に決済された場合に限りLate Payment Identifiedを作成します。
生成された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要素が存在し、値を検証できる場合に限り設定します。実装固有のフィルターには［システムに応じて設定］を使用します。
タイムゾーン：ソースシステムのタイムゾーンまたはUTCへの正規化方針を設定します。イベントの順序を正しく保つため、すべてのメッセージに同じ方針を適用します。
エラーおよび修復の指標：Payment Error IdentifiedとPayment Error Resolvedを表すステータスコード、理由コード、明示的な修復または例外マーカーを設定します。承認済みの業務定義でない限り、すべての拒否をエラーとして分類しないでください。
照合の指標：FISの実装で使用される明示的な照合ステータス、照合メッセージ、台帳一致マーカー、バッチ結果を設定します。照合がXMLアーカイブの外部に保存されている場合は、承認済みの別ソースと相関ルールを用意します。
パフォーマンス：アーカイブ全体をメモリに読み込まず、ファイルを順次処理します。大量の実行は日付またはディレクトリで分割し、中間出力を書き込み、十分なディスク容量があるローカルのステージング領域を使用します。非常に大規模なアーカイブでは、出力順序と重複除去を管理できることを確認してから、独立したディレクトリ単位で並列処理します。
前提条件：XMLアーカイブへの読み取りアクセス、出力先への書き込みアクセス、Pythonの実行権限、支払データへの承認済みアクセス、FISの識別子とステータスコードの検証済み対応表が必要です。このファイルベースの方法では、特定のFIS取引コード、メニューのパス、APIエンドポイント、テーブル名、ライセンスを前提としません。

a サンプルクエリ 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解析

ステップ

設定

a サンプルクエリ python

準備はできましたか？

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

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