Integrando um ERP ao CVCRM

A integração entre o ERP e o CVCRM precisa respeitar a origem dos dados. Isso significa que cada tipo de informação deve nascer em apenas um sistema, evitando duplicidades e conflitos. Para organizar essa comunicação, o processo foi dividido em três fases principais, que juntas cobrem todo o ciclo de venda e relacionamento com o cliente

🔹 Fase 1 – Estrutura Inicial (O que será vendido)

Nesta fase, preparamos o CVCRM para que ele conheça o que está sendo colocado à venda. Aqui entram empreendimentos, etapas, blocos e unidades. 👉 Decisão importante: onde esses dados nascem? • Se o ERP já é o responsável por controlar empreendimentos e unidades, ele deve enviá-los para o CVCRM. • Se o controle começa no CVCRM, então o ERP deve consultar essas informações através dos métodos GET.

📌 Na maioria dos casos, os empreendimentos são cadastrados no ERP e enviados ao CVCRM. Isso garante que o time de vendas use sempre a mesma base oficial, evitando divergências.

Fluxo:

ERP ➝ (POST) ➝ CVCRM

Passos de envio:

1. Cadastrar empreendimento (empresa/SPE e dados básicos).
2. Relacionar etapas (ou quadras em loteamentos).
3. Relacionar blocos (se houver).
4. Cadastrar todas as unidades (apartamentos, lotes, casas). No final desta fase, o CVCRM já possui o “estoque de vendas” idêntico ao ERP.

🔹 Fase 2 – Força de Vendas (Quem vai vender)

Com o estoque configurado, é hora de indicar quem está autorizado a vender. No CVCRM, isso é feito cadastrando imobiliárias, corretores e vinculando-os aos empreendimentos.

👉 Importância: Sem esse vínculo, uma unidade pode existir no sistema, mas não pode ser negociada. Esse passo garante que o corretor certo tenha acesso ao empreendimento certo.

Fluxo:

ERP ou Operação ➝ (POST) ➝ CVCRM

Passos de envio:

1. Cadastrar imobiliárias.
2. Cadastrar corretores.
3. Vincular imobiliárias e corretores ao empreendimento. No final desta fase, temos o estoque configurado + equipe comercial habilitada no CVCRM. O sistema já está pronto para receber propostas.

🔹Fase 3 – Propostas, Reservas e Contratos

Aqui começa o trabalho comercial.

Toda negociação deve nascer no CVCRM, já que ele é a ferramenta usada pela equipe de vendas. 👉 Por que a origem é o CVCRM? Porque o ERP não tem visibilidade da negociação em tempo real feita pelo corretor. Ele só deve receber o resultado (reserva confirmada, proposta aceita).

Fluxo:

CVCRM ➝ (Webhook) ➝ ERP ERP ➝ (GET) ➝ CVCRM

Como funciona:

1. O corretor cria uma reserva no CVCRM.
2. O CVCRM dispara um webhook para o ERP, informando o ID da reserva. • O cadastro do webhook é realizado via aplicação ou via endpoint. Acesse https://desenvolvedor.cvcrm.com.br/reference/get_webhook para obter maiores detalhes
3. O ERP consulta o CVCRM (via GET /reservas/id) para coletar os detalhes da reserva: unidade, corretor, imobiliária, comprador(es) e a condição financeira.
4. O ERP consulta também o endpoint de clientes para obter dados completos do titular e associados.
5. Com essas informações, o ERP registra o contrato internamente. No final desta fase, o ERP passa a ter todos os dados comerciais necessários. Observação: Se existir a necessidade de fazer a relação da condição de pagamento entre o CVCRM e o ERP, o integrador pode utilizar do endpoint /seriestabeladepreco para identificar as séries da forma de pagamento.

🔹Fase 4 – Visualização para o Cliente Final

O último ponto da integração envolve o cliente final (mutuário). O cliente final acessa o CVCRM para visualizar suas informações. Ele terá acesso, dentro do CVCRM (portal ou app), às informações financeiras que estão no ERP. Ele não se conecta diretamente ao ERP; tudo que vê foi previamente enviado pelo ERP para o CVCRM.

👉 Origem dos dados: sempre o ERP.

Exemplos:

Ao abrir o módulo financeiro no CVCRM, o cliente vê seus boletos, extratos e informações de IR.

Ao acessar a área comercial, ele encontra suas reservas e contratos.

Ou seja: o CVCRM é a camada de apresentação para o cliente, enquanto o ERP segue como a camada de origem.

Fluxo:

ERP ➝ (POST) ➝ CVCRM ➝ Cliente final

O que deve ser enviado:

1. Boletos
2. Extratos
3. Informe de rendimentos (IR)

Esses dados não são criados no CVCRM, apenas recebidos do ERP. Assim, o cliente final consulta todas as informações financeiras em um único lugar, mesmo que o ERP continue sendo o sistema oficial de origem.

✅ Resumindo o Fluxo Completo

• ERP ➝ CVCRM: Estrutura de empreendimentos e unidades + dados financeiros. • CVCRM ➝ ERP: Reservas e propostas (via webhook + consultas). • ERP ➝ Cliente final (via CVCRM): Boletos, extratos e informes de rendimento.