> Melhoria Contínua de Processos > Pagamentos em Processamento > FIS Global > Modelo de Dados

Seu Template de Dados de Processamento de Pagamentos

FIS Global

Atributos de Processamento de Pagamentos (20) Atividades de Processamento de Pagamentos (13) Guias de Extração (1)

Seu Template de Dados de Processamento de Pagamentos

Este template oferece um guia completo sobre os atributos de dados e atividades essenciais para uma análise eficaz do processamento de pagamentos. Inclui orientações práticas de como extrair essas informações dos seus sistemas. Use este recurso para garantir que você tenha todos os dados necessários para uma iniciativa de Process Mining robusta.

Atributos recomendados para coletar
Atividades-chave a monitorizar
Orientação para Extração

É novo em event logs? Saiba como criar um event log para Process Mining.

Baixar Modelo

Atributos de Processamento de Pagamentos

Estes são os campos de dados recomendados para incluir no seu log de eventos para uma análise completa do processamento de pagamentos.

3 Obrigatório 7 Recomendado 10 Opcional

	Nome	Descrição
	Event Timestamp EventTimestamp	A data e hora específica em que a atividade ocorreu.
Descrição Este atributo fornece o contexto temporal para cada evento no processo. Registra o momento exato em que uma ação foi logada, permitindo a ordenação cronológica. Na análise, é usado para calcular durações entre etapas, tempos de ciclo totais e taxas de processamento. Permite identificar gargalos ao destacar atrasos entre fases específicas do processo. Por que é importante Análises temporais são impossíveis sem este campo; ele alimenta todos os KPIs de desempenho e eficiência. Onde obter Consulte a documentação do FIS Global Exemplos 2023-10-12T08:30:15Z2023-10-12T09:45:00Z2023-10-13T14:20:10Z
	ID da Transação de Pagamento PaymentTransactionId	O identificador exclusivo para a instrução de pagamento ou transação específica.
Descrição Este atributo é a chave central para vincular todos os eventos de um ciclo de vida de pagamento. Permite rastrear o pagamento desde a solicitação inicial até a liquidação final ou reconciliação. Na análise, este ID é essencial para agrupar eventos individuais em instâncias de processo (casos). Ele possibilita a visualização do fluxo de ponta a ponta e é a base para todas as métricas de nível de caso, como tempo de ciclo e loops de retrabalho. Por que é importante É o conector fundamental para o Process Mining, permitindo que atividades distintas sejam reconstruídas em uma jornada coerente. Onde obter Consulte a documentação do FIS Global Exemplos TRX-2023-899102PAY-US-99281ACH-7721-X99WIRE-2210-001
	Nome da Atividade ActivityName	O nome da etapa específica do processo ou evento que ocorreu.
Descrição Este campo registra a ação específica em um dado momento, como 'Solicitação Criada' ou 'Pagamento Liquidado'. Define os nós no mapa de processo e a estrutura do fluxo. Analistas usam este atributo para entender a sequência de operações. É crítico para identificar desvios do caminho ideal ("happy path"), passos pulados ou atividades redundantes, como aprovações em excesso. Por que é importante Define o 'quê' do processo, permitindo a visualização de mapas de processo e análise de variantes. Onde obter Consulte a documentação do FIS Global Exemplos Solicitação de Pagamento CriadaDetalhes do Pagamento ValidadosPagamento AprovadoPagamento Liquidado
	Código da Moeda CurrencyCode	Código ISO de 3 letras que indica a moeda do pagamento.
Descrição Este atributo especifica a moeda do valor do pagamento (ex: BRL, USD, EUR). É essencial para normalizar dados financeiros em fluxos globais. Na análise, este campo permite segmentar o desempenho por moeda, o que costuma estar correlacionado a diferentes sistemas de compensação e regulamentações. Ajuda a explicar variações nos tempos de liquidação para pagamentos transfronteiriços. Por que é importante Essencial em ambientes multi-moedas para interpretar volumes financeiros com precisão. Onde obter Consulte a documentação do FIS Global Exemplos USDEURGBPJPY
	Data de Liquidação Real ActualSettlementDate	A data em que o pagamento foi efetivamente finalizado e liquidado.
Descrição Este atributo captura a data efetiva em que os fundos foram transferidos ou a transação foi concluída. Diferencia-se do timestamp de processamento pois reflete a data-valor. Na análise, é usado junto com a Data de Vencimento para calcular a 'Taxa de Pagamento em Dia'. Também serve como gatilho para a fase de reconciliação, sendo vital para analisar o 'Tempo de Ciclo de Reconciliação de Pagamento'. Por que é importante Representa a conclusão financeira do pagamento e é chave para análise de fluxo de caixa. Onde obter Consulte a documentação do FIS Global Exemplos 2023-11-022023-11-14
	Data de Vencimento do Pagamento PaymentDueDate	A data prevista para a liquidação do pagamento.
Descrição Este atributo registra o prazo para o pagamento solicitado ou definido nos termos da fatura. Serve como o benchmark de pontualidade. É um campo crítico para o dashboard de 'Adesão ao Vencimento'. Ao comparar esta data com a data real de liquidação ('Payment Settled'), os analistas podem sinalizar atrasos, calcular multas e avaliar a conformidade com contratos de fornecedores. Por que é importante Fornece a base para medir a adesão aos níveis de serviço e a pontualidade. Onde obter Consulte a documentação do FIS Global Exemplos 2023-11-012023-11-15
	Tipo de Pagamento PaymentType	A classificação do método ou instrumento de pagamento.
Descrição Este atributo categoriza o pagamento em tipos como Wire, ACH, SEPA, RTP ou Cheque. Diferentes tipos seguem regras de processamento e SLAs distintos. Analistas usam este campo para comparar o 'Tempo de Ciclo de Reconciliação' entre diferentes canais. Ajuda a explicar por que alguns pagamentos liquidam instantaneamente enquanto outros levam dias, garantindo que o desempenho seja medido conforme o parâmetro correto. Por que é importante É a dimensão principal para segmentar fluxos de processo, já que cada tipo possui características únicas de roteamento e tempo. Onde obter Consulte a documentação do FIS Global Exemplos Transferência BancáriaACH CreditSEPA InstantCheque
	Unidade de Negócio BusinessUnit	A divisão ou departamento interno que originou o pagamento.
Descrição Este atributo mapeia o pagamento a uma unidade organizacional, como 'Varejo', 'Comercial' ou 'Tesouraria'. É usado para agregar KPIs como 'Capacidade de Processamento' e 'Tempo de Ciclo Médio' por departamento, ajudando a gestão a comparar o desempenho entre divisões e alocar recursos de forma eficiente. Por que é importante Permite benchmarking interno e atribuição de responsabilidade pela performance do processo. Onde obter Consulte a documentação do FIS Global Exemplos TesourariaContas a PagarOperações de VarejoGestão de Patrimônio
	Usuário Processador ProcessingUser	O identificador ou nome do usuário ou agente do sistema que executa a atividade.
Descrição Este atributo captura quem ou o que executou a etapa do processo. Pode distinguir entre operadores humanos (ex: 'J.Silva') e contas automáticas do sistema (ex: 'SYSTEM_BATCH'). Estes dados são usados para analisar a utilização de recursos, identificar gargalos manuais e auditar a segregação de funções. Ajuda no cálculo da 'Taxa de Utilização de Usuários' e na distinção entre tarefas manuais e automatizadas. Por que é importante Essencial para análise de recursos, taxas de automação e auditoria de compliance. Onde obter Consulte a documentação do FIS Global Exemplos jsmithSYSTEM_AUTOBOTmdoe_approverAPI_GATEWAY
	Valor do Pagamento PaymentAmount	O valor monetário da transação de pagamento.
Descrição Este atributo representa o valor financeiro da solicitação de pagamento. É a métrica principal para analisar o volume financeiro e o risco. Analistas usam este campo para segmentar processos entre pagamentos de alto e baixo valor, que costumam ter fluxos de aprovação diferentes. Apoia o dashboard de 'Capacidade de Pagamento' e ajuda a identificar se valores altos sofrem com ciclos mais longos devido a uma análise mais rigorosa. Por que é importante Adiciona a dimensão financeira ao Process Mining, permitindo priorizar melhorias com base no valor. Onde obter Consulte a documentação do FIS Global Exemplos 1500.00250.501000000.0045.99
	Autoridade de Aprovação ApprovalAuthority	A função, grupo ou indivíduo responsável por autorizar o pagamento.
Descrição Este atributo indica qual nível de autoridade ou grupo é necessário para aprovar o pagamento, geralmente baseado em faixas de valor. Ajuda a rastrear o roteamento do workflow de aprovação. Analistas usam isso para o dashboard de 'Gargalos de Autorização de Pagamento', permitindo detalhar os tempos de aprovação por nível hierárquico e ver se camadas específicas da gestão estão causando atrasos. Por que é importante Permite a análise organizacional da hierarquia de aprovação e detecção de gargalos. Onde obter Consulte a documentação do FIS Global Exemplos Gerente Nível 1CFOEquipe de ComplianceSistema de Autoaprovação
	Canal de Pagamento PaymentChannel	O canal pelo qual a solicitação de pagamento foi iniciada.
Descrição Este atributo descreve a origem da instrução de pagamento, como Internet Banking, App, API ou Agência. Ajuda a entender o canal de entrada da transação. Analistas usam isso para comparar a eficiência entre os canais. Por exemplo, ajuda a determinar se pagamentos via API têm menos erros do que os inseridos manualmente em uma agência. Por que é importante Auxilia na otimização de canais e na compreensão do comportamento do cliente. Onde obter Consulte a documentação do FIS Global Exemplos Internet BankingMobile AppGateway CorporativoCaixa da Agência
	Código de Erro de Validação ValidationErrorCode	O código ou motivo que indica por que um pagamento falhou na validação.
Descrição Este atributo é preenchido quando um pagamento entra na atividade 'Payment Error Identified'. Contém detalhes da falha, como 'IBAN Inválido', 'Saldo Insuficiente' ou 'Endereço Ausente'. Este campo alimenta o dashboard de 'Taxas de Erro de Validação'. Agrupar por este atributo revela as causas mais comuns de retrabalho, permitindo correções na entrada de dados ou na configuração do sistema. Por que é importante Identifica as causas raiz de atritos no processo e loops de retrabalho. Onde obter Consulte a documentação do FIS Global Exemplos ERR-001: Conta InválidaERR-055: Sanção IdentificadaERR-009: Transação Duplicada
	Conta Remetente SenderAccount	O número da conta da qual os fundos são debitados.
Descrição Este atributo identifica a conta de origem da transação, permitindo analisar pagamentos de contas internas específicas. Na análise, ajuda a identificar se certas contas são propensas a erros (ex: saldo insuficiente) ou atrasos. Também apoia a reconciliação ao permitir o cruzamento de lançamentos contábeis com as atividades do processo. Por que é importante É fundamental para conciliação financeira e resolução de problemas no nível da conta. Onde obter Consulte a documentação do FIS Global Exemplos 123456789987654321ACC-TREASURY-01
	É Intervenção Manual IsManualIntervention	Um sinalizador que indica se a atividade envolveu trabalho manual.
Descrição Este atributo booleano sinaliza atividades ou casos que exigiram intervenção humana, como 'Payment Error Resolved' ou aprovações manuais, em oposição ao processamento direto (STP). É essencial para o dashboard de 'Taxa de Intervenção Manual'. Ajuda a quantificar o percentual de pagamentos não automatizados, destacando oportunidades para transformação digital. Por que é importante Diferencia o processamento automatizado do esforço manual, orientando cálculos de ROI para automação. Onde obter Derivado de ActivityName ou ProcessingUser Exemplos verdadeirofalse
	É Pagamento em Atraso IsLatePayment	Um sinalizador que indica se o pagamento foi liquidado após o vencimento.
Descrição Este é um atributo booleano calculado. Retorna verdadeiro se a data de liquidação for posterior ao vencimento. É o motor principal do KPI de 'Taxa de Pagamento em Dia'. Simplifica a criação de dashboards, permitindo filtrar rapidamente casos problemáticos sem lógicas de data complexas na camada visual. Por que é importante Simplifica os relatórios de exceções e a análise de compliance. Onde obter Derivado de PaymentDueDate e ActualSettlementDate Exemplos verdadeirofalse
	País do Beneficiário BeneficiaryCountry	O código do país do destinatário do pagamento.
Descrição Este atributo identifica o país de destino dos fundos, distinguindo pagamentos nacionais de internacionais. Esse contexto é crucial para o 'Monitoramento de Conformidade' e análise de roteamento. Pagamentos internacionais costumam envolver intermediários, verificações extras e prazos maiores; por isso, analisar o desempenho por país ajuda a isolar essas variáveis. Por que é importante É uma dimensão essencial para análise geográfica e avaliação de riscos de compliance. Onde obter Consulte a documentação do FIS Global Exemplos EUADECNGB
	Sistema de Origem SourceSystem	O nome do sistema de onde os dados do evento se originaram.
Descrição Este atributo identifica o componente de software ou banco de dados de onde o registro foi extraído, como o core banking, o gateway de pagamento ou a ferramenta de screening. É vital para a linhagem de dados. Ao analisar fluxos de ponta a ponta que passam por várias plataformas, este campo ajuda a distinguir onde cada atividade ocorreu e facilita a resolução de problemas de qualidade de dados. Por que é importante Garante rastreabilidade e contexto, especialmente em ambientes complexos com múltiplos motores de pagamento integrados. Onde obter Consulte a documentação do FIS Global Exemplos FIS OPFTraxPaymentHub_01SanctionsScreeningDB
	Tempo de Ciclo (Dias) CycleTimeDays	A duração em dias desde a criação da solicitação até a liquidação.
Descrição Este atributo calculado mede o tempo total do processo (ponta a ponta). É a diferença entre o timestamp de 'Payment Settled' e 'Payment Request Created'. É a métrica principal para o KPI de 'Tempo de Ciclo Médio'. Ter este valor pré-calculado facilita análises de distribuição de desempenho para detectar desvios e tendências. Por que é importante Quantifica a velocidade geral do processo. Onde obter Derivado de EventTimestamp Exemplos 1.50.25.0
	Última Atualização de Dados LastDataUpdate	O registro de data e hora de quando o registro foi extraído ou atualizado pela última vez.
Descrição Este atributo indica a atualização dos dados. Ajuda os usuários a saberem se estão vendo dados em tempo real ou um recorte de um período anterior. Nos Dashboards, esse campo é usado para exibir rótulos como 'Dados atualizados em'. Isso garante que as decisões sejam tomadas com base nas informações mais recentes e ajuda na gestão de cargas de dados incrementais. Por que é importante Estabelece a atualidade dos dados e gera confiança na pontualidade dos relatórios. Onde obter Metadados do processo de ETL Exemplos 2023-10-14T00:00:00Z2023-10-15T06:00:00Z

Obrigatório Recomendado Opcional

Atividades de Processamento de Pagamentos

Estes são os principais passos e marcos do processo que devem ser capturados no seu Event Log para descobrir e otimizar o processo com mais precisão.

6 Recomendado 7 Opcional

	Atividade	Descrição
	Instrução de Pagamento Enviada	Esta atividade marca o momento em que o sistema FIS envia a instrução de pagamento finalizada para a rede correspondente, como ACH, Fedwire ou SWIFT. É um evento crítico gerado pelo sistema.
Por que é importante Este é um marco importante que indica que o pagamento saiu do ambiente de processamento interno. É crucial para analisar a eficiência do roteamento e o tempo gasto no processamento externo. Onde obter Registrado em um log de transação ou de mensagens que rastreia comunicações externas. Procure por um registro de transmissão de mensagem enviada com sucesso com seu timestamp. Captura Evento gerado pelo sistema quando a mensagem de pagamento é enviada para a rede de compensação. Tipo de evento explicit
	Pagamento Aprovado	Um marco essencial onde um usuário autorizado aprova o pagamento, permitindo que ele avance para a próxima etapa. Geralmente é um evento explícito registrado com o ID do aprovador e um timestamp da ação no sistema.
Por que é importante Este é um ponto de controle crítico para medir os tempos de ciclo de aprovação e garantir a conformidade com os controles financeiros. Atrasos aqui impactam significativamente a pontualidade dos pagamentos. Onde obter Capturado em uma tabela de log de aprovação ou como um evento explícito no histórico principal. O event log vinculará o ID da Transação, o ID do aprovador e o timestamp da aprovação. Captura Registrado quando um usuário com direitos de aprovação realiza a ação de 'aprovar' em um pagamento. Tipo de evento explicit
	Pagamento Autorizado	Representa a etapa final de autorização, geralmente exigida para pagamentos de alto valor ou por uma autoridade superior após a aprovação inicial. Esta ação é registrada como um evento explícito quando um usuário com as devidas credenciais confirma o pagamento.
Por que é importante Esta atividade é essencial para o dashboard de 'Gargalos de Autorização de Pagamento'. Separar este evento de 'Payment Approved' ajuda a identificar atrasos em processos de aprovação com múltiplos níveis. Onde obter Registrado em um log de auditoria ou transação. Acionado por um usuário com permissões de autorização específicas, gerando um registro com seu ID e timestamp. Captura Uma entrada explícita de log é criada quando um usuário realiza a ação final de autorização. Tipo de evento explicit
	Pagamento Conciliado	Esta é a atividade contábil final, onde a transação é conciliada com o extrato bancário ou registro interno. Pode ser um processo em lote (batch) automático ou uma ação manual.
Por que é importante Esta atividade marca o fim definitivo do ciclo de vida do pagamento. Analisar o 'Tempo de Ciclo de Reconciliação de Pagamento' é crucial para entender a eficiência dos processos de fechamento financeiro. Onde obter Geralmente inferido pelo preenchimento de um campo 'reconciliation_date' ou mudança de status para 'Conciliado' em um módulo financeiro ou contábil. Captura Identificado pelo preenchimento de uma data de conciliação ou mudança de status para 'Conciliado'. Tipo de evento inferred
	Pagamento Liquidado	Esta atividade marca a conclusão da transferência de fundos, momento em que a transação é considerada liquidada financeiramente. Geralmente é registrada quando uma confirmação final de liquidação é recebida da rede de pagamento ou câmara de compensação.
Por que é importante Este é o ponto final principal para medir o tempo de ciclo e as taxas de pontualidade. Significa a conclusão bem-sucedida da execução principal do pagamento. Onde obter Inferido a partir de uma mudança de status final para 'Liquidado', 'Concluído' ou 'Postado', geralmente acionada por arquivos de compensação em lote ou mensagens em tempo real. Captura Uma mudança de status na transação de pagamento para 'Liquidado' ou equivalente. Tipo de evento inferred
	Solicitação de Pagamento Criada	Este é o primeiro evento no ciclo de vida, representando o início de uma nova transação no sistema FIS. Geralmente é capturado como uma entrada explícita em uma tabela de log quando um usuário ou sistema envia uma solicitação.
Por que é importante Esta atividade serve como o início definitivo do processo. É essencial para medir o tempo de ciclo de pagamento de ponta a ponta e analisar o volume e a capacidade total de pagamentos. Onde obter Registrado em uma tabela principal, identificado pelo timestamp de criação associado ao ID da Transação. Procure em tabelas como 'Payment_Transactions' pelos campos 'creation_date' ou 'entry_date'. Captura Evento registrado na criação de um novo registro de transação de pagamento. Tipo de evento explicit
	Detalhes do Pagamento Validados	Esta atividade indica que os dados do pagamento passaram pelas verificações automáticas iniciais de formato e integridade. Geralmente é inferida por uma mudança de status no registro do pagamento, por exemplo, de 'Novo' para 'Validado' ou 'Pendente de Aprovação'.
Por que é importante Rastrear esta atividade ajuda a identificar a frequência e o local de erros na entrada de dados. É um pré-requisito para analisar o KPI de Taxa de Erro de Validação e entender as fontes de retrabalho. Onde obter Inferido a partir de um campo de mudança de estado na tabela de transações. A transição de um estado inicial para 'validado', com seu respectivo timestamp, marca este evento. Captura Identificado por uma mudança no campo de status do pagamento para 'Validado' ou valor similar. Tipo de evento inferred
	Erro de Pagamento Identificado	Indica que um erro foi detectado após a validação inicial, como uma rejeição do banco de destino ou alerta interno de compliance. Geralmente é um evento explícito registrado quando uma exceção ocorre.
Por que é importante Esta atividade é a porta de entrada para todos os ciclos de retrabalho e tratamento de exceções. É essencial para calcular KPIs como a Taxa de Intervenção Manual e o Tempo de Resolução de Erros de Pagamento. Onde obter Registrado em um módulo de exceções ou log de transação. Pode ser acionado automaticamente por regras de sistema ou manualmente por um usuário, gerando um log com código de erro e timestamp. Captura Uma exceção ou código de erro é registrado na transação de pagamento. Tipo de evento explicit
	Erro de Pagamento Resolvido	Marca a resolução de um erro identificado anteriormente, permitindo que o pagamento seja reprocessado ou cancelado. É uma ação explícita do usuário para limpar o status de exceção.
Por que é importante Esta atividade encerra o ciclo de exceção. A duração entre 'Error Identified' e este evento é uma medida fundamental da eficiência operacional no tratamento de exceções. Onde obter Registrado quando um usuário limpa um sinalizador de erro ou remove a transação da fila de exceções. Ação capturada em trilha de auditoria ou histórico com timestamp. Captura Uma ação do usuário limpa o estado de erro, o que fica registrado em um log de auditoria. Tipo de evento explicit
	Pagamento Confirmado	Representa o recebimento de uma confirmação da rede de pagamento ou do banco beneficiário de que o pagamento foi recebido. Este evento é acionado por uma mensagem do sistema ou atualização de status.
Por que é importante A confirmação dá a certeza de que o pagamento chegou ao destino. O tempo entre 'Instruction Sent' e 'Confirmed' mede a latência da rede externa e o tempo de processamento. Onde obter Gerado a partir da análise de mensagens de confirmação recebidas das redes de pagamento. O sistema atualiza o status e registra o timestamp da confirmação. Captura Mensagem recebida de uma rede de compensação atualiza o status do pagamento para 'Confirmado'. Tipo de evento explicit
	Pagamento em Atraso Identificado	Um evento derivado que indica que o pagamento foi liquidado após a data de vencimento especificada. Esta atividade não é registrada explicitamente, mas calculada comparando dois campos de data.
Por que é importante Esta atividade calculada suporta diretamente o KPI de 'Taxa de Pagamento em Dia' e o dashboard de 'Adesão ao Vencimento'. Ajuda a quantificar o impacto de atrasos na relação com fornecedores e possíveis multas. Onde obter Este evento não é extraído diretamente. É calculado na transformação de dados comparando o timestamp de liquidação com o campo de vencimento. Se a liquidação for posterior, este evento é gerado. Captura Calculado se 'Data de Liquidação' > 'Data de Vencimento'. Tipo de evento calculated
	Pagamento Enviado para Aprovação	Representa o momento em que um pagamento validado entra no workflow de aprovação. Geralmente é registrado por uma alteração de status, indicando que o pagamento aguarda a ação de um aprovador.
Por que é importante Esta atividade marca o início do sub-processo de aprovação. Analisar o tempo entre este evento e 'Payment Approved' é fundamental para entender os gargalos de aprovação. Onde obter Inferido a partir de uma mudança no status do pagamento para 'Pendente de Aprovação', 'Enviado para Aprovação' ou estado similar em um log de workflow. Captura Uma mudança de status na transação de pagamento de 'Validado' para 'Pendente de Aprovação'. Tipo de evento inferred
	Pagamento Rejeitado	Esta atividade ocorre quando um aprovador nega uma solicitação de pagamento, geralmente exigindo correção e reenvio ou cancelamento total. É uma ação explícita do usuário registrada para fins de auditoria.
Por que é importante Rastrear rejeições ajuda a identificar motivos comuns de falhas, desvios no processo e loops de retrabalho. Destaca problemas de qualidade de dados iniciais ou conformidade. Onde obter Registrado como um evento explícito em uma tabela de histórico quando um aprovador seleciona 'rejeitar'. O registro costuma incluir timestamp, ID do usuário e, muitas vezes, um código de motivo. Captura Evento registrado quando um usuário executa a ação de 'rejeitar' para um pagamento. Tipo de evento explicit

Recomendado Opcional

Guias de Extração

Como obter seus dados do FIS Global

Etapas

Pré-requisitos e Instalação: Verifique se você tem o Python instalado (versão 3.8 ou superior) e as bibliotecas necessárias (requests, pandas). Você precisará de credenciais de API válidas para o FIS Payment Hub, especificamente Client ID, Client Secret e a URL Base da API.
Configuração: Abra o script Python fornecido. Atualize a seção de configuração no topo com sua URL Base, Client ID e Client Secret específicos. Defina as variáveis START_DATE e END_DATE para delimitar o período de extração.
Autenticação: O script utiliza uma função auxiliar para autenticar no endpoint OAuth2 da FIS. Ele recupera um Bearer token que é incluído nos cabeçalhos de todas as solicitações de API subsequentes.
Busca de Transações: O script executa uma requisição GET para o endpoint /payments. Ele implementa uma lógica de paginação para percorrer os resultados até que todas as transações no intervalo de datas sejam recuperadas, filtrando os tipos de pagamento relevantes para o seu escopo.
Recuperação do Histórico de Eventos: Para cada transação recuperada, o script faz uma chamada secundária para o endpoint /payments/{id}/history ou /audit para obter os eventos do ciclo de vida. Este loop garante a captura do histórico detalhado.
Mapeamento de Atividades: O script contém um dicionário de mapeamento (lógica de transformação) que traduz os códigos de status internos da FIS (ex: STAT_INIT, STAT_VAL, STAT_ACK) para nomes de atividades padrão, como Solicitação de Pagamento Criada e Pagamento Confirmado.
Tratamento de Eventos Derivados: O script verifica especificamente o ActualSettlementDate em relação ao PaymentDueDate. Se a data de liquidação for posterior à data de vencimento, ele gera automaticamente uma nova linha de evento intitulada Late Payment Identified e a anexa ao event log.
Extração de Atributos: Durante a iteração, o script extrai atributos-chave como Valor do Pagamento, Moeda e Unidade de Negócio. Eles são repetidos para cada evento associado a um Transaction ID específico para garantir um dataset rico.
Validação e Tratamento de Erros: O script inclui tratamento básico para falhas em chamadas de API (ex: erro 429 de limite de taxa ou 500 de erro de servidor) e exibe o progresso no console. Registros incompletos sem timestamps críticos são descartados.
Normalização de Dados: A estrutura JSON aninhada da API é convertida para um formato tabular usando a biblioteca Pandas. Cada linha representa a ocorrência de uma única atividade.
Exportação: Por fim, o script exporta o DataFrame processado para um arquivo CSV chamado fis_payment_event_log.csv. Este arquivo já vem com os cabeçalhos padrão prontos para importação no ProcessMind.
Revisão Final: Abra o arquivo CSV gerado. Verifique se as colunas de data estão no formato ISO 8601 (AAAA-MM-DDTHH:MM:SS) e se a coluna de atividades contém os nomes legíveis que foram mapeados no script.

Configuração

API_BASE_URL: A URL raiz da instância do FIS Payment Hub da sua organização (ex: https://api.fisglobal.com/paymenthub/v1).
CLIENT_ID / CLIENT_SECRET: Credenciais OAuth2 usadas para obter o token de acesso. Elas devem ter permissões de leitura ('Read') nos escopos de Payment e Audit.
START_DATE / END_DATE: O período de extração. Recomendamos extrair os dados em blocos de 30 dias se o volume for alto (acima de 100 mil pagamentos por mês).
PAGE_SIZE: Configure para 100 ou 500, dependendo das limitações de performance da API, para otimizar a vazão de dados.
TIMEOUT: Tempo limite de conexão em segundos (padrão 30) para evitar que o script trave em respostas lentas da rede.
RETRY_ATTEMPTS: Número de tentativas que o script deve realizar após uma falha antes de pular um registro.

a Consulta de Exemplo python

import requests
import pandas as pd
import json
from datetime import datetime, timedelta
import time

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
API_BASE_URL = class="hl-string">"https://[Your FIS API Endpoint]/v1"
CLIENT_ID = class="hl-string">"[Your Client ID]"
CLIENT_SECRET = class="hl-string">"[Your Client Secret]"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-01-31"
OUTPUT_FILE = class="hl-string">"fis_payment_event_log.csv"

class=class="hl-string">"hl-comment"># === MAPPINGS ===
class=class="hl-string">"hl-comment"># Maps FIS internal status codes to ProcessMind Activity Names
STATUS_MAP = {
    class="hl-string">"INITIATED": class="hl-string">"Payment Request Created",
    class="hl-string">"VALIDATED": class="hl-string">"Payment Details Validated",
    class="hl-string">"PENDING_AUTH": 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_TO_NETWORK": class="hl-string">"Payment Instruction Sent",
    class="hl-string">"ACKNOWLEDGED": class="hl-string">"Payment Confirmed",
    class="hl-string">"SETTLED": class="hl-string">"Payment Settled",
    class="hl-string">"EXCEPTION": class="hl-string">"Payment Error Identified",
    class="hl-string">"EXCEPTION_CLEARED": class="hl-string">"Payment Error Resolved",
    class="hl-string">"RECONCILED": class="hl-string">"Payment Reconciled"
}

def get_access_token():
    url = fclass="hl-string">"{API_BASE_URL}/oauth/token"
    payload = {
        class="hl-string">"grant_type": class="hl-string">"client_credentials",
        class="hl-string">"client_id": CLIENT_ID,
        class="hl-string">"client_secret": CLIENT_SECRET
    }
    try:
        response = requests.post(url, data=payload)
        response.raise_for_status()
        return response.json()[class="hl-string">"access_token"]
    except Exception as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        exit(1)

def get_payments(token, start, end):
    headers = {class="hl-string">"Authorization": fclass="hl-string">"Bearer {token}"}
    payments = []
    page = 1
    has_more = True
    
    while has_more:
        class=class="hl-string">"hl-comment"># Placeholder endpoint for searching payments
        url = fclass="hl-string">"{API_BASE_URL}/payments?startDate={start}&endDate={end}&page={page}&pageSize=100"
        try:
            resp = requests.get(url, headers=headers)
            resp.raise_for_status()
            data = resp.json()
            
            batch = data.get(class="hl-string">"items", [])
            payments.extend(batch)
            
            if len(batch) < 100:
                has_more = False
            else:
                page += 1
        except Exception as e:
            print(fclass="hl-string">"Error fetching payments page {page}: {e}")
            has_more = False
            
    return payments

def get_payment_history(token, payment_id):
    headers = {class="hl-string">"Authorization": fclass="hl-string">"Bearer {token}"}
    try:
        class=class="hl-string">"hl-comment"># Placeholder endpoint for audit history
        url = fclass="hl-string">"{API_BASE_URL}/payments/{payment_id}/audit"
        resp = requests.get(url, headers=headers)
        resp.raise_for_status()
        return resp.json().get(class="hl-string">"events", [])
    except Exception as e:
        print(fclass="hl-string">"Error fetching history for {payment_id}: {e}")
        return []

def process_data():
    print(class="hl-string">"Authenticating...")
    token = get_access_token()
    
    print(fclass="hl-string">"Fetching payments from {START_DATE} to {END_DATE}...")
    raw_payments = get_payments(token, START_DATE, END_DATE)
    
    event_log = []
    
    print(fclass="hl-string">"Processing {len(raw_payments)} transactions...")
    
    for p in raw_payments:
        p_id = p.get(class="hl-string">"paymentId")
        amount = p.get(class="hl-string">"amount")
        currency = p.get(class="hl-string">"currency")
        p_type = p.get(class="hl-string">"paymentType")
        due_date_str = p.get(class="hl-string">"dueDate")
        unit = p.get(class="hl-string">"businessUnit")
        
        class=class="hl-string">"hl-comment"># Fetch history for this specific payment
        history = get_payment_history(token, p_id)
        
        class=class="hl-string">"hl-comment"># Variables for derivative logic
        settlement_date = None
        due_date = None
        
        if due_date_str:
            try:
                due_date = datetime.fromisoformat(due_date_str.replace(class="hl-string">"Z", class="hl-string">"+00:00"))
            except ValueError:
                pass

        class=class="hl-string">"hl-comment"># Process explicit API events
        for h in history:
            raw_status = h.get(class="hl-string">"status")
            timestamp_str = h.get(class="hl-string">"timestamp")
            user = h.get(class="hl-string">"userId")
            
            class=class="hl-string">"hl-comment"># Map to standard Activity Name
            activity_name = STATUS_MAP.get(raw_status, raw_status)
            
            class=class="hl-string">"hl-comment"># Only include relevant activities
            if activity_name:
                event_entry = {
                    class="hl-string">"PaymentTransactionId": p_id,
                    class="hl-string">"ActivityName": activity_name,
                    class="hl-string">"EventTimestamp": timestamp_str,
                    class="hl-string">"ProcessingUser": user,
                    class="hl-string">"PaymentAmount": amount,
                    class="hl-string">"CurrencyCode": currency,
                    class="hl-string">"PaymentType": p_type,
                    class="hl-string">"PaymentDueDate": due_date_str,
                    class="hl-string">"BusinessUnit": unit,
                    class="hl-string">"ActualSettlementDate": None class=class="hl-string">"hl-comment"># To be filled if known
                }
                
                class=class="hl-string">"hl-comment"># Capture settlement date for logic
                if activity_name == class="hl-string">"Payment Settled":
                    event_entry[class="hl-string">"ActualSettlementDate"] = timestamp_str
                    try:
                        settlement_date = datetime.fromisoformat(timestamp_str.replace(class="hl-string">"Z", class="hl-string">"+00:00"))
                    except ValueError:
                        pass
                        
                event_log.append(event_entry)

        class=class="hl-string">"hl-comment"># Logic for Derivative Activity: Late Payment Identified
        class=class="hl-string">"hl-comment"># Rules: If settled and due date exists, and settled > due date
        if settlement_date and due_date:
            if settlement_date > due_date:
                event_log.append({
                    class="hl-string">"PaymentTransactionId": p_id,
                    class="hl-string">"ActivityName": class="hl-string">"Late Payment Identified",
                    class="hl-string">"EventTimestamp": settlement_date.isoformat(),
                    class="hl-string">"ProcessingUser": class="hl-string">"System Calculation",
                    class="hl-string">"PaymentAmount": amount,
                    class="hl-string">"CurrencyCode": currency,
                    class="hl-string">"PaymentType": p_type,
                    class="hl-string">"PaymentDueDate": due_date_str,
                    class="hl-string">"ActualSettlementDate": settlement_date.isoformat(),
                    class="hl-string">"BusinessUnit": unit
                })

    class=class="hl-string">"hl-comment"># Export to CSV
    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Ensure timestamps are consistent
    if not df.empty:
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
        
    df.to_csv(OUTPUT_FILE, index=False)
    print(fclass="hl-string">"Extraction complete. Data saved to {OUTPUT_FILE}")

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

Seu Template de Dados de Processamento de Pagamentos

Seu Template de Dados de Processamento de Pagamentos

Atributos de Processamento de Pagamentos

Atividades de Processamento de Pagamentos

Guias de Extração

Análise Python de arquivos de log XML ISO 20022

Etapas

Configuração

a Consulta de Exemplo python

Pronto para Começar?

Otimize seu Processamento de Pagamentos no FIS Global hoje mesmo

Seu Template de Dados de Processamento de Pagamentos

Seu Template de Dados de Processamento de Pagamentos

Atributos de Processamento de Pagamentos

Atividades de Processamento de Pagamentos

Guias de Extração

Análise Python de arquivos de log XML ISO 20022

Etapas

Configuração

a Consulta de Exemplo python

Valorizamos sua privacidade

Pronto para Começar?

Otimize seu Processamento de Pagamentos no FIS Global hoje mesmo