Como funciona a integração de Cessão de Direitos entre CV CRM e MEGA - Integrações e API

Quando o CV CRM está integrado ao MEGA, o processo de cessão de direitos passa a seguir uma sequência específica entre os dois sistemas, com validações automáticas que evitam inconsistências entre o CRM e o ERP. Essa integração garante que a titularidade de uma reserva só seja alterada no CV CRM depois que a cessão já estiver confirmada no MEGA, funcionando como uma trava de segurança.

Obs.: para utilizar esse processo é necessário ter a API de Pós-Venda / Portal do Cliente do MEGA contratada, ter a integração com o MEGA configurada e ativa no CV CRM e ter o módulo de Gestão de Cessão de Direitos habilitado no CV CRM.

Como funciona a integração

O processo é iniciado manualmente pelo usuário nos dois sistemas. Atualmente, o MEGA não disponibiliza webhooks para notificação automática de eventos de cessão, então é necessário registrar a ação tanto no MEGA quanto no CV CRM. Esse modelo já é utilizado pelo CV CRM em integrações com outros ERPs do mercado e será evoluído conforme o MEGA disponibilizar novas capacidades.

O CV CRM atua como sistema reflexo: antes de executar qualquer alteração de titularidade, ele valida via API se o contrato já está com status de cedido no MEGA. Isso impede que o titular de uma reserva seja alterado no CRM sem que o mesmo status esteja confirmado no ERP.

Fluxo do processo de Cessão de Direitos

1. Cessão realizada no MEGA

O processo sempre começa no MEGA. Execute a cessão de direitos diretamente no sistema MEGA — o contrato é atualizado na carteira de recebíveis.

2. Início do processo no CV CRM

Com a cessão já registrada no MEGA, acesse o módulo "Gestão de Cessão de Direitos" no CV CRM e inicie o processo para a reserva correspondente.

3. Andamento do workflow

O processo percorre as etapas configuradas no workflow de cessão até atingir a situação "Fim / Concluído".

4. Validação via API MEGA

Ao mover o processo para a etapa final, o CV CRM consulta automaticamente a API do MEGA para verificar se o contrato está efetivamente com status de cedido.

5. Resultado da validação

• Se positivo(o MEGA confirma a cessão):
  • o CV CRM executa a alteração de titularidade na reserva;
  • o novo titular passa a constar na reserva dentro do CV CRM;
  • o processo é concluído com sucesso.
• Se negativo(o MEGA não confirma a cessão):
  • o processo permanece pendente no CV CRM;
  • a titularidade da reserva não é alterada;
  • verifique o status do contrato no MEGA antes de tentar novamente.

Premissa da integração

O MEGA é o sistema de origem: o CV CRM apenas valida e finaliza a cessão com base no status confirmado pelo ERP. Essa lógica impede que a titularidade de uma reserva seja alterada no CRM sem respaldo no sistema financeiro. 

Perguntas frequentes 

Por que preciso iniciar o processo manualmente nos dois sistemas?

Porque o MEGA ainda não disponibiliza webhooks para eventos de cessão de direitos. Sem notificação automática, é necessário sinalizar a operação também no CV CRM para que a validação via API seja acionada.

O que acontece se eu tentar concluir a cessão no CV CRM antes de fazê-la no MEGA?

O CV CRM consulta a API do MEGA, não encontra o status de cessão confirmada e mantém o processo como pendente, sem alterar a titularidade da reserva.

Posso alterar o titular diretamente no CV CRM, sem passar pelo MEGA?

Não. A integração exige que a cessão já esteja confirmada no MEGA como condição para a alteração de titularidade no CV CRM.

A cessão de direitos e o distrato seguem o mesmo fluxo de integração?

Sim, a lógica é equivalente: ambos dependem de confirmação prévia no MEGA antes de o CV CRM executar a ação correspondente na reserva. A diferença está no resultado — no distrato, a unidade é liberada; na cessão, o titular é alterado.

A integração está concluída e pronta para uso assim que os pré-requisitos estiverem atendidos e a cessão for confirmada em ambos os sistemas.