Logs Carteira de Cobrança (aba)
Atenção, Beta!
A aba Logs carteira de cobrança está presente na versão Beta do Sistema. Sua disponibilidade na versão Estável será a partir de Julho de 2025.
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
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.
Disponibilidade!
A aba
Logs carteira de cobrançaestá 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.
Perguntas Frequentes (FAQ)
- 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.
Etiquetas
CarteiraDeCobranca IntegracaoBancaria Bancos ContasAReceber Gateway API LogsGateway LogsCarteiraDeCobranca Request Response Body ResponseHTTP Post MetodoHTTP CabecalhoRequisicao CorpoRequisicao CorpoResposta StatusHTTP Log
