Skip to main content

Módulo 12: Ativações & Vigência

Status: Documentado

Domínio: ver Domínio/Entidade: Plano Contratado

ATA de Referência: (Ainda não aprovada)

1. Visão Geral da Regra​

A Ativação formaliza o início da proteção do veículo. Ela marca a transição de um status estritamente comercial (Contrato assinado) para o status operacional (Veículo sob cobertura).

Este módulo regula os gatilhos que dão início à vigência da proteção, a apuração do término de cobertura do contrato e as diretrizes de sincronismo do faturamento recorrente com o ERP integrado (Módulo 05).

2. Parâmetros e Gatilhos de Ativação​

A regra que inicia a cobertura do veículo é configurada por Tenant (Módulo 02):

2.1 Regra de Entrada (Gatilho)​

Configuração do TenantRegra de NegócioAção do Sistema
ASSINATURAAtivação condicionada à assinatura e vistoria.Ao assinar o contrato: (a) Se não exige vistoria, muda para ATIVO. (b) Se exige vistoria e já está APROVADA, muda para ATIVO. (c) Se exige vistoria e está pendente, assume AGUARDANDO_VISTORIA.
PAGAMENTO_ADESAOAtivação financeira e vistoria.Permanece em AGUARDANDO_ATIVACAO. A ativação para ATIVO exige assinatura concluída, baixa do pagamento da adesão no ERP/Financeiro E a vistoria aprovada (se exigida).

2.2 Início da Vigência (vigencia_inicio)​

  • Opção A — Imediato (Padrão): O termo de cobertura começa no exato momento (timestamp) em que o gatilho de ativação foi atendido.
  • Opção B — Meia-noite (D+1): A cobertura do veículo passa a vigorar apenas a partir das 00:00:00 do dia civil seguinte à ativação.

2.3 Fim da Vigência (vigencia_fim)​

  • A cobertura contratual é de duração contínua baseada em recorrência de mensalidades, porém a vigência legal do documento assinado possui prazo máximo de 365 dias (1 ano) a partir de vigencia_inicio.
  • A renovação é automatizada conforme descrito na seção 4.

3. Integração e Sincronismo com ERP (Ex: Hinova)​

Se a integração com ERP estiver configurada e ativa no Tenant (Módulo 05):

  1. Sincronismo de Cadastro: Ao atingir o status ATIVO, o CRM realiza um POST no ERP contendo os dados estruturados do Cliente, do Veículo (placa/chassi), do Plano e de seus opcionais.
  2. Registro Financeiro: O ERP assume a gestão financeira das parcelas, emissão de boletos, juros, multas e baixa por pagamento. O ID retornado pelo ERP é armazenado em id_externo_erp no CRM.
  3. Isolamento de Responsabilidades: O CRM não realiza processamento de conciliação bancária, emissão de boletos, cobrança ativa ou cálculo de inadimplência de mensalidades. Ele atua estritamente como visualizador dos dados consolidados pelo ERP.

4. Políticas de Inadimplência, Suspensão e Revistoria​

[!IMPORTANT] As políticas descritas nesta seção aplicam-se exclusivamente quando o Tenant estiver configurado com plano_sincronismo_financeiro = COMPLETO. Caso o Tenant utilize plano_sincronismo_financeiro = UNIDIRECIONAL, o CRM não escutará eventos de atraso ou quitação do ERP, o status do plano permanecerá permanentemente como ATIVO comercialmente e toda a gestão financeira (bloqueios, cancelamentos de cobrança e cobrança ativa) ocorrerá isoladamente na interface do ERP integrado, sem reflexo no CRM.

O cálculo de prazos de carência (X dias) e suspensão por inadimplência crônica reside inteiramente no ERP. O CRM não possui cronjobs ou inteligência local para calcular atrasos de parcelas recorrentes. A transição de estados segue o fluxo lógico abaixo baseado estritamente em notificações reativas de Webhook do ERP:

  1. Prazo de Carência (INADIMPLENTE): Tolerância financeira gerida pelo ERP. O CRM simplesmente acata a notificação de atraso mantendo a cobertura provisória do veículo.
  2. Suspensão Operacional (SUSPENSO): Atingido quando o ERP notifica o estouro de carência. O CRM suspende imediatamente a vigência operacional local, bloqueando abertura de termos de sinistro.
  3. Exigência de Revistoria (Inteligência do CRM pós-quitação):
    • Ao receber o webhook de quitação (pago/ativo) do ERP, se o plano estava SUSPENSO, o CRM calcula há quantos dias o plano estava nesse estado.
    • Se a suspensão durou mais de Y dias (parâmetro configurado nas Configurações do Tenant no CRM), a reativação automática é interceptada e bloqueada pelo CRM.
    • O sistema gera um link e tarefa de Revistoria (Módulo 10). O status só retorna para ATIVO após a aprovação das novas fotos. Se a suspensão durou menos de Y dias, o status migra direto para ATIVO.

5. Renovações Anuais​

  1. Tarefa de Renovação Comercial: Aos 30 dias antes de vigencia_fim, o sistema agenda automaticamente uma tarefa de follow-up (Módulo 14) para o consultor dono da carteira.
  2. Simulação de Renovação:
    • O sistema gera um rascunho de proposta comercial baseado no plano e opcionais correntes.
    • Se o tenant estiver configurado para recalcular o valor de risco na renovação, a simulação puxará a Tabela FIPE atualizada do mês corrente para a cota de risco do veículo.

6. Kit de Boas-Vindas e Ações de 0km​

  • Ações de Boas-Vindas: Ao ativar a assinatura (ATIVO), o CRM aciona o Módulo 05 para disparar e-mail e mensagem via WhatsApp contendo as boas-vindas, o Manual do Associado (PDF) e os números da assistência 24 horas.
  • Pendência de Placa para Veículos 0km:
    • Veículos ativados com placa = null geram tarefas administrativas recorrentes de acompanhamento no Módulo 14 destinadas ao consultor, com prazo limite de 30 dias para atualização do emplacamento.
    • A ausência de placa após este prazo bloqueia a abertura de termos de sinistro e gera notificações para o gestor comercial.