Logs Carteira de Cobrança (aba)
Introdução
Para aprimorar a rastreabilidade e facilitar o suporte técnico, o sistema agora oferece uma nova funcionalidade de Logs da Carteira de Cobrança. Esta funcionalidade permite o registro detalhado das interações com os gateways de pagamento, fornecendo informações cruciais sobre as requisições enviadas e as respostas recebidas, incluindo eventuais erros de autenticação.
Acesso ao Formulário
Caminho: Menu Sistema > Cadastros > Financeiro > Carteira de cobrança
Dentro do formulário da Carteira de Cobrança, você encontrará a nova aba Logs carteira de cobrança, onde poderá visualizar todas as informações detalhadas sobre as interações com os gateways de pagamento.
Funcionalidades Principais
A principal funcionalidade desta melhoria é o registro automático e detalhado dos logs de autenticação da carteira de cobrança. Anteriormente, em caso de falha na autenticação das APIs dos gateways de pagamento, o formulário da carteira de cobrança não era salvo, dificultando a identificação da causa raiz do problema. Agora, a carteira é salva normalmente, e um log é gerado com o status da requisição, bem como todas as informações enviadas e recebidas do gateway. Isso permite uma análise mais profunda e eficiente em situações de erro.
Detalhamento dos Logs
Os logs registrados incluem:
- Request (Requisição): Endereço da API, cabeçalhos e corpo da requisição enviada ao gateway.
- Response (Resposta): Código de erro, mensagem de erro e corpo da resposta recebida do gateway.
- Status da Requisição: Indica se a requisição foi bem-sucedida ou se houve falha na autenticação.
Acessibilidade dos Logs
Esses registros detalhados são acessíveis em um local centralizado, facilitando a análise e o suporte técnico.
A nova aba Logs da Carteira de Cobrança no formulário Carteira de cobrança permite visualizar esses dados de forma organizada, sendo eles:
Grid - Logs carteira de cobrança
| Campo | Descrição |
|---|---|
| ID | Identificação do log |
| Status | Mostra se a operação teve Falha ou Sucesso |
| Log | Mensagem de retorno da operação |
| Ambiente | Indica o ambiente de operação |
| Response HTTP status | Código de status HTTP na resposta |
| Data criação | Data e hora da criação do log |
Visualização - Logs carteira de cobrança
| Campo | Descrição |
|---|---|
| ID | Identificação do log |
| ID carteira de cobrança | Identificação da carteira de cobrança |
| Status | Mostra se a operação teve Falha ou Sucesso |
| Ambiente | Indica o ambiente de operação:Produção, Homologação ou Teste |
| Log | Mensagem de retorno da operação |
| Método HTTP | Método utilizado na requisição HTTP |
| URL | Endpoint da requisição |
| Cabeçalho da requisição | Informações no cabeçalho da requisição HTTP |
| Corpo da requisição | Conteúdo enviado na requisição HTTP |
| Corpo da resposta | Conteúdo da resposta recebida |
| Status HTTP | Código de status HTTP na resposta |
| Data Criação | Data e hora da criação do log |
Esta funcionalidade é compatível com os seguintes gateways de pagamento: Asaas, BBapi, Lytex, Santander, Sicoob e Sicredi. É importante ressaltar que, mesmo que a autenticação falhe, a carteira de cobrança será salva, e o log detalhado será registrado para posterior investigação.
A aba Logs carteira de cobrança está disponível para as seguintes integrações do tipo gateway:
Benefícios para o Usuário
- Maior Rastreabilidade: Facilita o acompanhamento de todas as interações com os gateways de pagamento.
- Agilidade na Resolução de Problemas: Permite identificar rapidamente a causa de falhas de autenticação, reduzindo o tempo de inatividade.
- Suporte Técnico Aprimorado: Fornece informações detalhadas para a equipe de suporte, agilizando o atendimento ao cliente.
- Transparência: Oferece uma visão clara do que está acontecendo nas integrações bancárias.
- Onde posso visualizar os logs da carteira de cobrança?
- Os logs podem ser visualizados na nova aba Logs da Carteira de Cobrança dentro do formulário da Carteira de Cobrança, acessível via Menu Sistema > Cadastros > Financeiro > Carteira de cobrança.
- Que tipo de informação é registrada nos logs da carteira de cobrança?
- Os logs registram detalhes da requisição enviada (endereço da API, cabeçalhos, corpo), da resposta recebida (código de erro, mensagem de erro, corpo da resposta) e o status da requisição (sucesso ou falha).
- Quais gateways de pagamento são suportados por essa funcionalidade de logs da carteira de cobrança?
- Atualmente, a funcionalidade de logs suporta os gateways Asaas, BBapi, Lytex, Santander, Sicoob e Sicredi.
- Como os logs da carteira de cobrança auxiliam na resolução de problemas?
- Os logs fornecem informações detalhadas sobre as interações com os gateways, permitindo identificar rapidamente a causa de falhas de autenticação e agilizando o processo de suporte e correção.
- A funcionalidade de logs da carteira de cobrança afeta o salvamento da carteira de cobrança?
- Não. Com essa melhoria, a carteira de cobrança é salva normalmente, mesmo em caso de erro na autenticação das APIs. O log detalhado é registrado para posterior investigação, sem impedir o salvamento da carteira.
Considerações Finais
A implementação da aba Logs da Carteira de Cobrança aprimora significativamente a rastreabilidade e a eficiência na resolução de problemas relacionados às interações com gateways de pagamento. Com a capacidade de registrar detalhadamente as requisições e respostas, os usuários têm agora uma ferramenta poderosa para identificar rapidamente a causa de falhas de autenticação e agilizar o suporte técnico.
Este avanço não só facilita a manutenção e o suporte do sistema, mas também oferece uma maior transparência e confiança nas operações das integrações bancárias.