O desafio
Vínculos antigos de clientes e falhas na rota de retorno prejudicavam o fluxo de cobrança e atualização de faturas.
Este projeto partiu de um módulo Asaas já adquirido para o Perfex CRM. O trabalho da Upmy foi personalizar e corrigir comportamentos de integração que afetavam a cobrança: validação de identificação, vínculo do cliente e recebimento do retorno de pagamento. A autoria da base de terceiros permanece distinta dessa intervenção.
Cadastros inconsistentes e um problema na rota de retorno prejudicavam a comunicação com o CRM. O escopo documentado concentrou a revisão desses pontos e do tratamento dos eventos recebidos.
Como o fluxo funciona
- 01
Revisar a identificação
O trabalho incluiu validação de CPF/CNPJ e do vínculo do cliente utilizado na cobrança. O objetivo era tratar a correspondência entre o cadastro no CRM e o registro usado pela integração.
- 02
Tratar cadastros removidos
Foram ajustados os caminhos relacionados a clientes removidos no Asaas. Esse cenário exige atenção porque uma referência antiga pode deixar de corresponder a um cliente disponível no provedor.
- 03
Corrigir o retorno
A rota de webhook foi ajustada para receber os eventos de pagamento. O recebimento é parte do caminho necessário para atualizar as faturas, mas não comprova sozinho toda a conciliação financeira.
- 04
Verificar o que foi alterado
A evidência registra verificação de sintaxe PHP e resposta HTTP 200 na rota. A confirmação final de atualização da fatura dependia do reenvio de um evento de pagamento naquele ambiente.
O trabalho desenvolvido
Ajustes na validação de CPF/CNPJ, tratamento de clientes removidos e recebimento dos eventos do Asaas.
- Validação do vínculo entre cliente e cobrança
- Tratamento de eventos de pagamento
- Adaptação de módulo de terceiro
Cadastro e cobrança precisam permanecer relacionados
Uma identificação inválida ou referência a cliente removido interfere no fluxo entre os sistemas antes mesmo do retorno do pagamento. A personalização abordou esses cenários documentados.
Esse tipo de manutenção começa por entender a integração existente. O case não apresenta uma reconstrução completa do CRM nem de toda a API Asaas. Ele demonstra uma intervenção delimitada sobre uma base adquirida, com revisão do comportamento necessário à operação.
Uma rota respondendo é uma etapa da validação
Depois da correção, a rota de retorno respondeu à verificação HTTP. Isso confirma um aspecto da comunicação. Para comprovar o fluxo completo, ainda é necessário receber um evento pertinente e observar a atualização correta da fatura correspondente.
O resultado documentado é código ajustado e rota validada, com a homologação financeira dependente do ambiente de instalação. Para outro projeto, a proposta deve identificar a versão do módulo, a licença, os cenários de cadastro e os eventos que serão efetivamente conferidos.
Entrega e contexto
Código ajustado e rota de retorno validada. A homologação financeira deve acompanhar cada instalação.
O que considerar na implantação
- O trabalho é personalização de um módulo de terceiro adquirido, sem alegação de autoria integral ou revenda irrestrita.
- A resposta HTTP 200 do callback não prova liquidação, baixa de fatura ou conciliação completa.
- Recursos adicionais do Asaas não são automaticamente recursos implementados neste módulo.
Perguntas frequentes
Posso pedir a correção de um módulo Asaas que já uso?
Sim, sujeito à análise do código, da licença e do ambiente. Informe as versões, o comportamento esperado e o problema observado para definir uma intervenção adequada.
O que precisa ser testado depois de corrigir o webhook?
Além da resposta da rota, é necessário conferir o evento recebido e sua consequência na fatura correta. Os cenários financeiros devem ser definidos e validados na instalação correspondente.
Um fluxo parecido na sua empresa?
Conte qual plataforma você usa, o que acontece hoje e o que precisa mudar. Com esse contexto, podemos definir o escopo, as integrações e os testes do seu projeto.
Solicitar orçamentoEscopo e investimento sob medida.