您的支付处理数据模板

FIS Global

← 返回改进指南

支付处理属性 (19) 支付处理活动 (13) 提取指南 (1)

您的支付处理数据模板

此模板全面介绍了开展支付处理分析所需的关键数据属性和流程活动，并提供了从系统中提取这些关键信息的实用指导。使用此资源，确保采集完整数据，为流程挖掘项目打下坚实基础。

建议采集的属性
需要跟踪的关键活动
提取指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

支付处理属性

以下是建议纳入事件日志的数据字段，用于全面分析支付处理。

3 必需 7 建议 9 可选

	名称	说明
	事件时间戳 EventTimestamp	活动发生的具体日期和时间。
说明此属性为支付流程中的每个事件提供时间背景，记录系统记录操作的准确时刻，从而支持按时间顺序排列活动。在分析中，它用于计算步骤间持续时间、总周期时间和吞吐率，并通过突出流程阶段之间的延迟来识别瓶颈。为什么重要没有此字段就无法进行基于时间的分析；所有绩效和效率KPI都依赖于它。获取位置 Consult FIS Global documentation 示例 2023-10-12T08:30:15Z2023-10-12T09:45:00Z2023-10-13T14:20:10Z
	支付交易ID PaymentTransactionId	特定支付指令或交易的唯一标识符。
说明此属性是连接单笔支付生命周期内所有事件的核心键。它支持分析人员从初始请求开始，跟踪支付经过验证、审批，直至最终结算或对账的全过程。在分析中，此ID对于将离散事件归组为流程实例至关重要。它支持端到端流程可视化，也是周期时间、返工循环等案例级指标的基础。为什么重要它是流程挖掘的基础连接字段，可将分散的活动还原为连贯的业务旅程。获取位置 Consult FIS Global documentation 示例 TRX-2023-899102PAY-US-99281ACH-7721-X99WIRE-2210-001
	活动名称 ActivityName	已发生的具体流程步骤或事件的名称。
说明此字段记录特定时间点执行的具体操作，例如“Payment Request Created”或“Payment Settled”。它定义流程图中的节点，并决定流程顺序的结构。分析人员使用此属性了解操作顺序。它对于识别偏离理想路径的情况、发现跳过的步骤，或检测多次审批循环等冗余活动至关重要。为什么重要它定义流程中的“做什么”，支持流程图可视化和变体分析。获取位置 Consult FIS Global documentation 示例创建付款请求验证付款详情付款已批准支付已结算
	业务部门 BusinessUnit	发起支付的内部事业部或部门。
说明此属性将支付映射到具体组织单元，例如“Retail Banking”、“Commercial Lending”或“Treasury”。它用于按部门汇总“Payment Throughput”和“Average Payment Cycle Time”等KPI，帮助管理层比较不同部门的绩效并有效分配资源。为什么重要它支持内部基准比较和流程绩效责任管理。获取位置 Consult FIS Global documentation 示例资金管理应付账款零售运营财富管理
	付款到期日 PaymentDueDate	预计完成支付结算的日期。
说明此属性记录发起方要求或发票条款规定的支付截止日期，是衡量按时完成情况的目标基准。此字段对于“Payment Due Date Adherence”仪表板至关重要。通过将该日期与实际“Payment Settled”日期比较，分析人员可以标记逾期支付、计算潜在罚金，并评估供应商协议的合规情况。为什么重要它为衡量服务水平达成率和及时性提供基准。获取位置 Consult FIS Global documentation 示例 2023-11-012023-11-15
	处理用户 ProcessingUser	执行活动的用户或系统代理的标识符或名称。
说明此属性记录执行流程步骤的人员或系统。它可以区分人工操作员（如“J.Smith”）和自动化系统账户（如“SYSTEM_BATCH”）。这些数据用于分析资源利用率、识别人工瓶颈，以及审计职责分离情况。它有助于计算“Processing User Utilization Rate”，并区分人工任务和自动化任务。为什么重要对于资源分析、自动化率和合规审计不可或缺。获取位置 Consult FIS Global documentation 示例 jsmithSYSTEM_AUTOBOTmdoe_approverAPI_GATEWAY
	实际结算日期 ActualSettlementDate	支付实际完成并结算的日期。
说明此属性记录资金转移生效或交易被视为完成的日期。它不同于处理时间戳，因为它反映的是起息日。在分析中，它与到期日结合使用，用于计算“On-Time Payment Rate”。它也是触发对账阶段的依据，对于分析“Payment Reconciliation Cycle Time”至关重要。为什么重要它代表支付的财务结论，是现金流分析的关键字段。获取位置 Consult FIS Global documentation 示例 2023-11-022023-11-14
	支付类型 PaymentType	支付方式或支付工具的分类。
说明此属性将支付分类为Wire、ACH、SEPA、Real-Time Payment（RTP）或Check等类型。不同支付类型遵循明显不同的处理规则和SLA。分析人员利用此字段比较不同支付通道的“Payment Reconciliation Cycle Time”。它有助于解释为何部分支付可即时结算，而其他支付需要数天，并确保绩效评估采用正确基准。为什么重要这是划分流程的主要维度，因为每种类型都有独特的路由和时间特征。获取位置 Consult FIS Global documentation 示例电汇ACH贷记SEPA即时支付支票
	支付金额 PaymentAmount	支付交易的货币金额。
说明此属性表示支付请求对应的财务价值，是分析财务吞吐量和风险的主要指标。分析人员利用此字段按高价值和低价值支付对流程进行分组，因为两者通常遵循不同的审批路径。它支持“Payment Throughput”仪表板，并帮助识别高价值支付是否因更严格的审查而具有更长的周期时间。为什么重要它为流程挖掘增加财务维度，支持按价值确定优先级。获取位置 Consult FIS Global documentation 示例 1500.00250.501000000.0045.99
	货币代码 CurrencyCode	表示支付币种的3位ISO代码。
说明此属性指定Payment Amount使用的币种，例如USD、EUR、GBP。在分析全球支付流时，它对于统一财务数据至关重要。在分析中，此字段支持按币种细分流程绩效，而币种通常与不同的清算系统和监管要求相关。它有助于解释跨境支付与境内支付在结算时间上的差异。为什么重要对于多币种环境下准确解读财务金额至关重要。获取位置 Consult FIS Global documentation 示例 USDEURGBPJPY
	付款方账户 SenderAccount	扣款资金来源账户的账号。
说明此属性标识交易的来源账户，为分析特定内部账户发起的支付提供细粒度信息。在分析中，它有助于识别特定资金账户是否容易出现错误（如资金不足）或延迟，并通过将分类账记录与流程活动匹配来支持对账。为什么重要它是财务对账和账户级问题排查的基础。获取位置 Consult FIS Global documentation 示例 123456789987654321ACC-TREASURY-01
	审批权限 ApprovalAuthority	负责授权支付的角色、群组或个人。
说明此属性表示审批支付所需的权限级别或具体用户群组，通常取决于金额阈值。它有助于追踪审批工作流的路由。分析人员利用此字段支持“Payment Authorization Bottlenecks”仪表板，并按权限级别拆分审批时间，判断特定管理层级是否造成延迟。为什么重要它支持审批层级的组织分析和瓶颈检测。获取位置 Consult FIS Global documentation 示例一级经理CFO合规团队自动审批系统
	支付渠道 PaymentChannel	发起支付请求的渠道。
说明此属性描述支付指令的来源，例如Online Banking、Mobile App、API或Branch，有助于了解交易的输入渠道。分析人员利用此字段比较不同渠道的处理效率。例如，可以判断通过API发起的支付是否比网点手动录入的支付具有更低的错误率。为什么重要它有助于优化渠道并了解客户行为。获取位置 Consult FIS Global documentation 示例网上银行移动应用企业网关网点柜员
	收款人国家 BeneficiaryCountry	支付收款方所在国家的代码。
说明此属性用于识别资金目的地国家，以区分境内付款和国际付款。这一背景对于“Payment Compliance Monitoring”和路由分析至关重要。国际付款通常涉及不同的中介机构、一致性检查和更长的周期时间，因此按国家分析绩效有助于隔离这些变量。为什么重要它是地理分析和合规风险评估的重要维度。获取位置 Consult FIS Global documentation 示例 USDECNGB
	数据最后更新时间 LastDataUpdate	记录最近一次提取或刷新的时间戳。
说明此属性表示分析所用数据的新鲜度，帮助用户了解当前查看的是实时数据，还是上一时期的快照。在仪表板中，此字段通常用于显示“数据截至”标签，确保决策基于当前可用的相关信息，并协助管理增量数据加载。为什么重要它明确数据时效性，增强报告及时性的可信度。获取位置 ETL流程元数据示例 2023-10-14T00:00:00Z2023-10-15T06:00:00Z
	是否逾期付款 IsLatePayment	表示支付是否在到期日之后完成结算的标记。
说明这是一个计算得出的布尔属性。当“Payment Settled”日期晚于“Payment Due Date”时返回true。此属性直接驱动“On-Time Payment Rate”KPI。它简化了仪表板分析，使用户无需在可视化层编写复杂日期逻辑即可快速筛选问题案例。为什么重要它简化异常报告和合规分析。获取位置 Derived from PaymentDueDate and ActualSettlementDate 示例 truefalse
	是否需要人工干预 IsManualIntervention	表示活动是否涉及人工操作的标记。
说明此布尔属性标记需要人工输入的活动或案例，例如“Payment Error Resolved”或人工审批，以区别于直通式处理（STP）。它对于“Manual Payment Intervention Rate”仪表板至关重要，有助于量化未完全自动化的支付比例，发现数字化转型机会。为什么重要它区分自动化吞吐量和人工投入，为计算自动化投资回报率提供依据。获取位置 Derived from ActivityName or ProcessingUser 示例 truefalse
	源系统 SourceSystem	事件数据来源系统的名称。
说明此属性标识提取记录的具体软件组件或数据库，例如核心银行引擎、支付网关或制裁筛查工具。它对数据血缘和验证至关重要。在分析跨越多个平台的端到端流程时，此字段有助于区分具体活动发生的平台，并协助排查数据质量问题。为什么重要它确保数据的可追溯性和上下文，尤其适用于集成多个支付引擎的复杂环境。获取位置 Consult FIS Global documentation 示例 FIS OPFTraxPaymentHub_01SanctionsScreeningDB
	验证错误代码 ValidationErrorCode	表示支付验证失败原因的代码或说明。
说明当支付进入“Payment Error Identified”活动时填充。它包含失败的具体原因，例如“Invalid IBAN”、“Insufficient Funds”或“Missing Beneficiary Address”。此字段驱动“Payment Data Validation Error Rates”仪表板。按此属性分组可以发现最常见的返工原因，从而针对上游数据录入或系统配置进行改进。为什么重要它用于识别造成流程阻滞和返工循环的根本原因。获取位置 Consult FIS Global documentation 示例 ERR-001：账户无效ERR-055：命中制裁名单ERR-009：交易重复

必需建议可选

支付处理活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，用于准确发现流程并进行优化。

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
	支付已对账	这是最终的会计活动，将支付交易与银行对账单或内部分类账记录进行匹配。该过程可以自动批量执行，也可以由用户手动完成。
为什么重要此活动标志着支付生命周期的最终结束。分析“Payment Reconciliation Cycle Time”对于了解财务结账流程的效率至关重要。获取位置通常根据“reconciliation_date”字段已填充，或支付系统关联的财务或会计模块中最终状态变更为“Reconciled”推断得出。采集根据对账日期已填充或状态变更为“Reconciled”识别。事件类型 inferred
	支付已结算	此活动标志着资金转账完成，交易被视为已完成财务结算。通常在收到支付网络或清算机构发出的最终结算确认后记录。
为什么重要这是衡量支付周期时间和按时支付率的主要终点，表示核心支付执行流程已成功完成。获取位置根据支付记录最终状态变更为“Settled”、“Completed”或“Posted”推断得出。此状态变更由批量结算文件或清算系统的实时消息驱动。采集支付交易状态变更为“Settled”或等效状态。事件类型 inferred
	付款已拒绝	当审批人拒绝付款请求时会发生该活动，通常需要修正后重新提交，或直接取消付款。这是为审计目的而记录的明确用户操作。
为什么重要跟踪拒绝情况有助于识别付款失败、流程偏差和返工循环的常见原因，也能突出初始数据质量或合规方面的问题。获取位置当审批人在审批历史或交易历史表中选择“reject”选项时，系统会记录一条明确事件。该记录通常包含时间戳、用户ID以及原因代码。采集用户对付款执行“reject”操作时记录的事件。事件类型 explicit
	付款已确认	表示收到支付网络或收款银行发出的确认，表明支付已被接收。此事件由传入的系统消息或状态更新触发。
为什么重要确认可确保支付已到达目的地。“Instruction Sent”与“Confirmed”之间的时间用于衡量外部网络延迟和处理时间。获取位置通过解析支付网络传入的确认消息生成。系统会更新支付状态并记录确认时间戳。采集清算网络传入的消息将支付状态更新为“Confirmed”。事件类型 explicit
	付款提交审批	表示已验证的付款被提交至审批工作流的时点。通常通过状态变更记录，表明付款正在等待审批人处理。
为什么重要该活动标志着审批子流程的开始。分析它与“Payment Approved”之间的时间，对于了解审批瓶颈至关重要。获取位置根据工作流或交易状态日志中付款状态变更为“Pending Approval”、“Submitted for Approval”或类似状态进行推断。采集付款交易状态从“Validated”变更为“Pending Approval”。事件类型 inferred
	已识别延迟支付	表示支付在指定到期日之后完成结算的派生事件。此活动不会直接记录，而是通过比较两个日期字段计算得出。
为什么重要此计算活动直接支持“On-Time Payment Rate”KPI和“Payment Due Date Adherence”仪表板，有助于量化流程延迟对供应商关系和潜在滞纳金的影响。获取位置不会直接提取，而是在数据转换期间将“Settlement Date”时间戳与“Payment Due Date”字段进行比较后计算得出。如果结算日期晚于到期日，则生成此事件。采集如果“Settlement Date”>“Payment Due Date”，则计算得出。事件类型 calculated
	已识别支付错误	表示初始验证后流程中的某个环节检测到错误，例如收款银行拒绝或内部合规标记。通常在引发异常时作为明确事件记录。
为什么重要此活动是所有返工和异常处理循环的入口，也是计算人工干预率和支付错误解决时间KPI的基础。获取位置记录在异常处理模块或交易日志中。系统规则可自动触发，也可由用户手动标记问题触发，并生成包含错误代码和时间戳的日志。采集支付交易记录中写入异常或错误代码。事件类型 explicit
	支付错误已解决	标志着此前发现的支付错误已解决，使支付可以重新处理或取消。这是用户清除异常状态时执行的明确操作。
为什么重要此活动关闭异常处理循环。“Error Identified”与此事件之间的持续时间，是衡量异常处理运营效率的重要指标。获取位置用户清除错误标记或将交易移出异常队列时记录。此操作会以时间戳形式保存在审计轨迹或交易历史日志中。采集用户操作清除错误状态，并记录在审计日志中。事件类型 explicit
	验证付款详情	该活动表示付款数据已通过格式、完整性和正确性的初始自动验证检查。通常可通过付款记录的状态变更推断，例如从“New”变为“Validated”或“Pending Approval”。
为什么重要跟踪该活动有助于识别数据录入错误的发生频率和位置。这也是分析Payment Data Validation Error Rate KPI、了解返工来源的前提。获取位置根据付款交易表中的状态或状态变更字段推断。当初始状态变为“validated”状态，并同时记录相应时间戳时，即表示该事件发生。采集通过付款状态字段变更为“Validated”或类似值进行识别。事件类型 inferred

建议可选

提取指南

如何从FIS Global获取数据

步骤

确认FIS Global付款引擎会将原始ISO 20022 XML消息归档到可访问的文件系统位置，包括pacs.008付款指令和pacs.002付款状态报告。获取归档路径、文件命名规则、命名空间配置、保留期限，以及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状态码和原因码映射为明确活动，并为每个提取到的活动写入一行事件记录。脚本还会根据明确的错误或修复标识生成Payment Error Identified和Payment Error Resolved记录，并仅在结算晚于到期日期时生成Late Payment Identified记录。
检查生成的CSV和验证报告。确认每一行都已填充PaymentTransactionId、ActivityName和EventTimestamp，13个必需活动名称均可出现，并且时间戳已统一规范化。在扩大提取窗口前，调查缺少标识符、包含不支持状态码、存在重复事件或日期冲突的交易。
将事件数量与源归档进行核对，并在可用时与FIS运营报告或审计提取结果进行比对。端到端验证部分交易，包括审批、拒绝、授权、指令发送、网络确认、结算、错误处理、对账和逾期付款逻辑。如果需要运营可追溯性，请在审计输出中保留源文件名及源行号或消息引用。
在所选期间的源归档完成后安排脚本运行，或使用受控的重叠窗口增量运行，以捕获延迟到达的pacs.002消息。使用PaymentTransactionId、ActivityName、EventTimestamp和源消息标识进行去重，同时保留源记录中确实发生多次的合法重复活动。
将最终事件日志导出为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规范化策略。对所有消息采用相同策略，确保事件排序可靠。
错误和修复标识：配置代表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%的直通式处理，消除对账问题。

立即开始免费试用

无需信用卡，几分钟即可开始

您的支付处理数据模板

您的支付处理数据模板

支付处理属性

支付处理活动

提取指南

使用Python解析ISO 20022 XML日志文件

步骤

配置

a 示例查询 python

准备好开始了吗？

立即优化您的FIS Global支付处理流程

我们重视您的隐私