Como Reprocessar Logs Gateway

Introdução

O reprocessamento de logs do gateway é uma função importante para assegurar a integridade e a atualização dos registros de comunicação entre Sistemas. Com essa ferramenta, é possível corrigir falhas eventuais no processamento, sincronizar dados e garantir que as informações registradas pelo gateway estejam corretas.

Acesso ao Formulário

Caminho: Menu Configurações > Logs > Logs Gateway

Benefícios

  • Correção de registros que estão inconsistentes ou incompletos.
  • Sincronização de dados entre os sistemas.
  • Recuperação de informações perdidas durante falhas de comunicação.
  • Melhoria na qualidade e confiabilidade dos dados para análises e relatórios.
  • Facilidade na resolução de problemas.

Conceito

O log gateway mostra o status de um título gerado em seu Sistema por uma carteira de cobrança do modelo Gateway, API ou Pix avulso. Os status podem ser: Pago, Cancelado ou Aguardando Pagamento. Se algum recebimento não foi registrado no Sistema, é possível reprocessar o log gateway para efetuar a baixa.

Para consultar um log gateway:

  1. Acesse o Menu “Configurações”.
  2. Clique em “Logs”.
  3. Selecione “Logs Gateway”.
    • Isso abrirá a lista “Log Tarefa Gateway”, onde estarão os últimos logs gateway recebidos em seu Sistema.

Nesse ambiente, você pode verificar o Status de Requisição para ver se está como Sucesso ou Pendente. O log pode ser reprocessado em qualquer status, mas se estiver Pendente, você pode aguardar o processamento automático, que pode demorar até 3 horas, ou processar o log manualmente.

Aviso!

Para saber como reprocessar um log gateway manualmente, siga os passos abaixo.

Passo a Passo - Como Reprocessar Logs Gateway

  1. Acesse o menu Configurações
  2. Clique em Logs
  3. Selecione Logs Gateway
  4. Na lista de Logs Gateway, procure a seção de Filtros
  5. Preencha e busque pelo filtro desejado, ou simplesmente clique na caixa de pesquisa e pressione enter para carregar a lista de logs
  6. Selecione o log que deseja reprocessar e clique em Visualizar
  7. Nesta janela de visualização do log, você terá acesso a várias informações sobre o recebimento deste título no Sistema, sendo elas: - ID: identificação única do registro. - Gateway: nome do gateway de pagamento utilizado. - Carteira de cobrança: especifica a carteira de cobrança associada. - Contas a receber: indica a conta a receber relacionada ao registro. - Charge ID: identificação da cobrança no sistema de pagamento. - Log: mensagem de log referente ao status da fatura. - Dados: campo que contém informações detalhadas sobre a transação. - Request: descrição ou nota sobre a requisição realizada. - Status de requisição: indica o resultado da requisição (Pendente, Sucesso, Falhou). - Número de tentativas de processamento: quantidade de tentativas feitas para processar a transação no Sistema. - Data e hora: registro da data e hora do evento ou transação. - ID lote retorno: identificação do lote de retorno associado.
  8. Clique no botão Processar log localizado na parte superior da tela
  9. Confirme a ação na janela de diálogo que será exibida
  10. Aguarde o Sistema processar a solicitação
  11. Verifique o status atualizado dos logs reprocessados na lista e busque por esta conta a receber, para verificar se o status do título foi atualizado.
  12. Fim.

Como Reprocessar Logs Gateway

Introdução

O reprocessamento de logs do gateway é uma função importante para assegurar a integridade e a atualização dos registros de comunicação entre Sistemas. Com essa ferramenta, é possível corrigir falhas eventuais no processamento, sincronizar dados e garantir que as informações registradas pelo gateway estejam corretas.

Acesso ao Formulário

Caminho: Menu Configurações > Logs > Logs Gateway

Benefícios

  • Correção de registros que estão inconsistentes ou incompletos.
  • Sincronização de dados entre os sistemas.
  • Recuperação de informações perdidas durante falhas de comunicação.
  • Melhoria na qualidade e confiabilidade dos dados para análises e relatórios.
  • Facilidade na resolução de problemas.

Conceito

O log gateway mostra o status de um título gerado em seu Sistema por uma carteira de cobrança do modelo Gateway, API ou Pix avulso. Os status podem ser: Pago, Cancelado ou Aguardando Pagamento. Se algum recebimento não foi registrado no Sistema, é possível reprocessar o log gateway para efetuar a baixa.

Para consultar um log gateway:

  1. Acesse o Menu “Configurações”.
  2. Clique em “Logs”.
  3. Selecione “Logs Gateway”.
    • Isso abrirá a lista “Log Tarefa Gateway”, onde estarão os últimos logs gateway recebidos em seu Sistema.

Nesse ambiente, você pode verificar o Status de Requisição para ver se está como Sucesso ou Pendente. O log pode ser reprocessado em qualquer status, mas se estiver Pendente, você pode aguardar o processamento automático, que pode demorar até 3 horas, ou processar o log manualmente.

Aviso!

Para saber como reprocessar um log gateway manualmente, siga os passos abaixo.

Passo a Passo - Como Reprocessar Logs Gateway

  1. Acesse o menu Configurações
  2. Clique em Logs
  3. Selecione Logs Gateway
  4. Na lista de Logs Gateway, procure a seção de Filtros
  5. Preencha e busque pelo filtro desejado, ou simplesmente clique na caixa de pesquisa e pressione enter para carregar a lista de logs
  6. Selecione o log que deseja reprocessar e clique em Visualizar
  7. Nesta janela de visualização do log, você terá acesso a várias informações sobre o recebimento deste título no Sistema, sendo elas: - ID: identificação única do registro. - Gateway: nome do gateway de pagamento utilizado. - Carteira de cobrança: especifica a carteira de cobrança associada. - Contas a receber: indica a conta a receber relacionada ao registro. - Charge ID: identificação da cobrança no sistema de pagamento. - Log: mensagem de log referente ao status da fatura. - Dados: campo que contém informações detalhadas sobre a transação. - Request: descrição ou nota sobre a requisição realizada. - Status de requisição: indica o resultado da requisição (Pendente, Sucesso, Falhou). - Número de tentativas de processamento: quantidade de tentativas feitas para processar a transação no Sistema. - Data e hora: registro da data e hora do evento ou transação. - ID lote retorno: identificação do lote de retorno associado.
  8. Clique no botão Processar log localizado na parte superior da tela
  9. Confirme a ação na janela de diálogo que será exibida
  10. Aguarde o Sistema processar a solicitação
  11. Verifique o status atualizado dos logs reprocessados na lista e busque por esta conta a receber, para verificar se o status do título foi atualizado.
  12. Fim.

Passo a passo - Como reprocessar logs gateway a partir da cobrança financeira

Além do menu Logs Gateway, também é possível acessar o log diretamente dentro da cobrança da conta a receber no Sistema. Isso pode ser feito por meio do financeiro avulso, do menu financeiro no cadastro do cliente ou diretamente pelo contrato.

Para acessar o log da cobrança e reprocessá-lo, siga os passos abaixo:

  1. Acesse o menu Sistema.
  2. Clique em Receber.
  3. Selecione Contas a receber.
  4. Utilize os filtros de busca para localizar o título financeiro de cobrança desejado.
  5. Selecione a Conta a receber e clique em Editar.
  6. Acesse a aba Log gateway.
  7. Selecione o log exibido nessa aba e clique no botão Visualizar.
  8. Na janela de visualização do log, as seguintes informações estarão disponíveis:
    • ID: identificação única do registro.
    • Gateway: nome do gateway de pagamento utilizado.
    • Carteira de cobrança: indica a carteira de cobrança associada.
    • Contas a receber: mostra a conta vinculada ao log.
    • Charge ID: código da cobrança no sistema de pagamento.
    • Log: mensagem com o status da fatura.
    • Dados: informações detalhadas da transação.
    • Request: dados da requisição feita.
    • Status de requisição: informa se está em Pendente, Sucesso ou Falhou.
    • Número de tentativas de processamento: total de tentativas de processamento feitas no Sistema.
    • Data e hora: data e hora do registro no log.
    • ID lote retorno: código do lote de retorno associado, se houver.
  9. Clique em Processar log, no topo da tela.
  10. Confirme a ação na janela de confirmação exibida.
  11. Aguarde o processamento realizado pelo Sistema.
  12. Verifique na lista se o status do log foi atualizado e consulte a conta a receber para conferir se o título também foi atualizado.
  13. Fim.

Caso deseje reprocessar um log gateway por meio do contrato do cliente, acesse o cadastro do cliente, edite o contrato, localize o título financeiro em contas a receber e siga o mesmo passo a passo descrito acima.

Fluxo de Processo

graph TD
    A[Início] --> B[Acesse o menu Configurações]
    B --> C[Clique em Logs]
    C --> D[Selecione Logs Gateway]
    D --> E[Use a seção de Filtros]
    E --> F{Deseja usar filtros específicos?}
    F -->|Sim| G[Preencha filtros desejados]
    F -->|Não| H[Atualize a Grid geral]
    G --> I[Busque logs]
    H --> I
    I --> J[Selecione o log desejado]
    J --> K[Clique em Visualizar]
    K --> L[Analise as informações do log]
    L --> M{Deseja reprocessar o log?}
    M -->|Sim| N[Clique em Processar log]
    M -->|Não| O[Retorne à lista de logs]
    N --> P[Confirme a ação]
    P --> Q[Aguarde o processamento]
    Q --> R[Verifique o status atualizado]
    R --> S[Busque a conta a receber]
    S --> T[Verifique se o título foi atualizado]
    T --> U{Título atualizado corretamente?}
    U -->|Sim| V[Fim do processo]
    U -->|Não| W[Contate o suporte técnico]
    W --> V
    O --> V

Aviso!

Se apresentar falha no processamento de logs ou notar que logs gateways não estão chegando em seu Sistema, contate o Suporte Técnico.

Data de crédito - Movimentação financeira de baixa incorreta

Em algumas situações, pode ocorrer de uma liquidação de cobrança ser processada com a data de crédito errada. No caso de integrações com Gateways e APIs de pagamento, quem informa a data de crédito no Log Gateway é o banco, e o Sistema irá processar exatamente conforme os dados recebidos nesse log.

Se a sua instituição estiver enviando Logs Gateway com a data de crédito incorreta, será necessário entrar em contato com o banco ou a instituição financeira responsável pela emissão das cobranças para solicitar o ajuste. Isso pode acontecer por erro ou por alguma configuração incorreta no convênio. Em algumas situações, o Log Gateway é enviado antes de a instituição financeira disponibilizar a data de crédito correta para a transação.

Como corrigir movimentação financeira com data de crédito incorreta

Reenviar notificação Log Gateway para o Sistema

A forma mais eficiente, sempre que possível, é realizar o estorno do recebimento da cobrança no Sistema. Após isso, entre em contato com a instituição de pagamento ou, caso possua acesso, realize você mesmo o reenvio do Log Gateway para o Sistema. Com isso, o log poderá já conter a data de crédito correta.

Estorno e recebimento manual

Caso, mesmo com o reenvio do Log Gateway, a instituição continue informando a data de crédito errada, será necessário fazer o ajuste de forma manual. Para isso, estorne o recebimento incorreto no Sistema e então registre novamente o recebimento de forma manual. Lembre-se de preencher os mesmos dados do pagamento original, alterando apenas a data de crédito.

Considerações finais

O reprocessamento dos logs do gateway é uma ferramenta importante para manter a exatidão e confiabilidade nas informações financeiras do sistema. Seguindo o procedimento descrito, é possível corrigir erros e manter os registros atualizados. No entanto, é fundamental utilizar esse recurso com responsabilidade, escolhendo corretamente quais logs devem ser reprocessados, a fim de evitar sobrecarga desnecessária no Sistema.

ETIQUETAS

Logs Gateway Configuracoes Integracao

LEIA TAMBÉM