# Asaas e Perfex CRM trabalhando juntos | Portfólio Upmy

URL: https://upmy.com.br/portfolio/perfex-crm-asaas/
Language: pt-BR

CRM · Integração de pagamentos

## Asaas e Perfex CRM trabalhando juntos

Personalização de um módulo Asaas existente para melhorar cobranças e retornos de pagamento no Perfex CRM.

[Solicitar orçamento↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Asaas%20e%20Perfex%20CRM%20trabalhando%20juntos.)[Entender o fluxo ↗](#workflow)

Customização implementada 4 etapas do fluxo Projeto sob medida 

UPMY / INTEGRATION ↗ 

01 Validar o cliente → 

02 Receber o evento → 

03 Conferir a fatura 

MAPA DO FLUXO 

Precisa de algo parecido?

[Solicitar orçamento ↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Asaas%20e%20Perfex%20CRM%20trabalhando%20juntos.)

01 / Contexto

### 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.

02 / Passo a passo

### 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.

03 / Desenvolvimento

### 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.

04 / Entrega

### 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çamento↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Asaas%20e%20Perfex%20CRM%20trabalhando%20juntos.)Escopo e investimento sob medida.

### Serviços relacionados

[Desenvolvimento de software sob medidaSistemas, programas e integrações construídos para a sua rotina.↗](https://upmy.com.br/servicos/software-sob-medida/)[Módulos Perfex CRM e integração AsaasPersonalize o CRM e conecte sua rotina de cobranças e pagamentos.↗](https://upmy.com.br/servicos/perfex-crm-asaas/)[Integração de pagamentos e APIsConecte checkout, cobranças e eventos de pagamento ao seu sistema.↗](https://upmy.com.br/servicos/integracoes-de-pagamento/)[Voltar aos projetos ↗](https://upmy.com.br/portfolio/)
