O cálculo de comprometimento de renda foi aprimorado em dois pontos: a localização da configuração e a forma como as parcelas são consideradas no cálculo.

• Configuração: o parâmetro de comprometimento de renda passa a fazer parte das regras de aprovação, tanto no empreendimento quanto na tabela de preço.
• Cálculo: as parcelas passam a ser consideradas conforme suas periodicidades e datas de vencimento, evitando somar valores de períodos diferentes como se fossem cobrados simultaneamente.

Por que isso é importante?

A melhoria torna o cálculo mais coerente com o fluxo real de pagamentos da proposta, evitando que o comprometimento de renda seja calculado acima do valor efetivamente previsto para um mesmo período.

Além disso, centralizar a configuração nas regras de aprovação facilita o gerenciamento dos critérios utilizados na análise.

Como funciona?

1. Configuração nas regras de aprovação

A configuração do cálculo será transferida para as regras de aprovação do empreendimento e da tabela de preço, contemplando tanto a tela nova quanto a tela antiga de regras.

2. Cálculo conforme vencimentos das parcelas

O sistema passa a distinguir as séries considerando seus períodos de cobrança, sem somar parcelas que não ocorrem simultaneamente.

Exemplo:

No cálculo anterior, todos os valores eram somados, totalizando R$ 1.255,00.

Com a melhoria, são consideradas as parcelas que coexistem no mesmo período. Até março de 2027, por exemplo, o comprometimento calculado será de R$ 655,00 (R$ 550,00 + R$ 105,00).

Benefícios

• Cálculo de comprometimento de renda mais preciso;
• Redução de distorções causadas por parcelas de períodos diferentes;
• Maior coerência na análise financeira das propostas;
• Configuração centralizada nas regras de aprovação;
• Preservação das configurações existentes durante a migração.

Foi criada uma nova ação no workflow de reservas para permitir o envio ao Sienge somente dos contratos assinados.

Por que isso é importante?

A melhoria oferece mais controle sobre quais contratos são enviados à integração, permitindo adaptar o processo às regras de negócio de cada operação e evitando o envio de contratos que ainda não foram assinados.

Como funciona?

Além da ação já existente para envio de contratos ao Sienge, o workflow de reservas passa a contar com uma nova ação específica para enviar apenas os contratos assinados.

Assim, é possível configurar o fluxo para que o envio considere o status de assinatura dos contratos.

Benefícios

• Maior controle sobre o envio de contratos ao Sienge;
• Redução do envio de contratos ainda não assinados;
• Mais flexibilidade na configuração do workflow de reservas;
• Melhor alinhamento entre o processo comercial e a integração com o Sienge.

O botão Gerar Comissão foi ajustado para ficar sempre visível na tela da reserva, independentemente de ela estar marcada como vendida.

Por que isso é importante?

A mudança facilita o acesso à funcionalidade e permite que o usuário encontre a opção de gerar comissão sem depender da situação da reserva para visualizar o botão.

Como funciona?

O botão Gerar Comissão passa a ser exibido em todas as situações da reserva, em vez de aparecer somente quando ela está vendida.

A disponibilidade da ação continua sujeita às regras de negócio e às validações do sistema.

Benefícios

• Acesso mais fácil à geração de comissão;
• Maior visibilidade da funcionalidade;
• Experiência de uso mais consistente na tela da reserva.

Foi criada uma API (V3) para consultar os documentos vinculados a um repasse, seguindo a proposta da API de documentos de reservas, com estrutura própria para atender às informações específicas do repasse.

O retorno disponibiliza dados como tipo de documento, situação, arquivo, validade e identificação do repasse.

Por que isso é importante?

A novidade atende a uma demanda patrocinada e permite que sistemas integrados acessem as informações dos documentos do repasse por meio de API, ampliando as possibilidades de integração e automação dos processos.

Como funciona?

A consulta utiliza os identificadores do repasse e do documento por meio de parâmetros obrigatórios:

• idrepasse: identificador do repasse no Construtor de Vendas;
• iddocumento: identificador do documento do repasse.
  
  Ver mais em: https://desenvolvedor.cvcrm.com.br/reference/exibirdocumentorepassev3

O retorno inclui informações como:

• Identificação: IDs do documento e do repasse;
• Tipo e situação: categoria do documento e status, como pendente;
• Arquivo: nome, identificação no servidor, formato e tamanho;
• Validade: data de validade e indicação de documento vencido;
• Workflow: informação sobre a obrigatoriedade do documento;
• Comentários: identificador do comentário associado, quando disponível.

Benefícios

• Acesso aos documentos do repasse por integração;
• Consulta dos status e das informações dos arquivos;
• Verificação de validade dos documentos;
• Mais possibilidades de automação e acompanhamento do processo de repasse.

As APIs de consulta de workflows de reservas e comissões foram aprimoradas para retornar também as cores configuradas para cada situação.

Agora, além do identificador e do nome da situação, o retorno incluirá os campos cor_bg e cor_nome.

Por que isso é importante?

Com essas informações, sistemas integrados podem representar visualmente as situações de acordo com as cores configuradas no CV CRM, mantendo maior consistência visual entre as aplicações.

Como funciona?

Os seguintes endpoints passarão a retornar as cores de cada situação:

• Reservas:/api/v4/configuracoes/workflows/reservas/situacoes/1
• Comissões:/api/v4/configuracoes/workflows/comissoes/situacoes

O retorno incluirá os seguintes campos:

• id: identificador da situação;
• nome: nome da situação;
• cor_bg: cor de fundo;
• cor_nome: cor do texto do nome da situação.

Exemplo de retorno

{
  "id": 1,
  "nome": "Nova Reserva",
  "cor_bg": "#292532",
  "cor_nome": "#7a7783"
}

Benefícios

• Informações visuais disponíveis diretamente pela API;
• Maior consistência na representação das situações;
• Mais flexibilidade para integrações e interfaces que utilizam os workflows do CV CRM.

A API de Unidades foi ampliada com novos métodos para permitir a criação e a atualização de unidades por integração.

As novidades incluem:

• POST: permite cadastrar novas unidades por API;
• PATCH: permite atualizar um dado específico de uma unidade;
• GET: atualizado para contemplar todas as configurações do formulário.
  
  Ver em: https://desenvolvedor.cvcrm.com.br/reference/cadastrarunidadeempreendimentov3

Por que isso é importante?

A evolução da API atende às necessidades de projetos que envolvem a esteira comercial dos clientes, permitindo integrar o gerenciamento de unidades aos sistemas e processos externos.

Com os novos métodos, as integrações ganham mais recursos para cadastrar e atualizar informações, reduzindo a necessidade de intervenções manuais.

Como funciona?

• POST — Criar unidades

Permite realizar o cadastro de novas unidades por meio da API V3.

O método utiliza o formato V3 e não contempla campos adicionais além dos previstos para a operação.

• PATCH — Atualizar unidades

Permite atualizar um dado específico de uma unidade existente, possibilitando alterações pontuais sem a necessidade de atualizar todos os seus dados.

• GET — Consultar configurações

O método GET foi atualizado para contemplar todas as configurações disponíveis no formulário de unidades, ampliando as informações acessíveis pelas integrações.

Benefícios

• Cadastro de unidades por API;
• Atualização pontual de informações;
• Maior flexibilidade para integrações;
• Acesso ampliado às configurações do formulário;
• Mais possibilidades de automação na esteira comercial dos clientes.

Pré-requisitos

É necessário possuir acesso e autorização para utilizar a API V3 do sistema.

Uma nova opção de configuração faz o CV CRM enviar ao Mega ERP o nome do cliente e dos associados já padronizado: em CAIXA ALTA, sem acentos e com os espaços normalizados. A mudança vale só para o que é enviado ao Mega. O cadastro no CV CRM não é alterado. 

Por que é importante?
Os contratos criados direto no Mega já usam nomes em caixa alta e sem acentuação. Os dados que vêm do CV CRM seguiam a formatação do cadastro, então o Mega recebia nomes em padrões diferentes. Com a opção ativa, o nome chega uniforme, independentemente de como foi digitado no CV, e a base do Mega fica consistente.

Como funciona?

• Ativação: em Configurações Específicos › Integrações “Enviar nome do cliente e associados em maiúsculo e sem acentos - MEGA”.
  

  
  

• Onde se aplica: ao nome do cliente (titular) e aos associados vinculados ao contrato. Na validação, a cônjuge do associado também saiu normalizada.
• O que muda no envio ao Mega:
  • Todas as letras ficam maiúsculas.
  • Os acentos saem: Á, Ã, Ç, É, Ü e similares viram A, A, C, E, U.
  • Espaços no início e no fim do nome são removidos.
  • Espaços repetidos entre as palavras viram um só.
  • O nome em si não muda, só a formatação.
• Exemplos:
  • “joão antônio da silva” → “JOAO ANTONIO DA SILVA”
  • “Conceição Müller” → “CONCEICAO MULLER”
  • “íris çá ñandú” → “IRIS CA NANDU”
• Sem alteração no CV: o nome continua aparecendo no CV CRM exatamente como foi cadastrado.
• Opção desligada: o envio continua como antes, com o nome na formatação do cadastro. 

Ao importar corretores, o sistema agora envia automaticamente um e-mail para que cada corretor valide o próprio endereço. O envio vale para corretores novos e também para corretores já existentes que ainda não têm o e-mail verificado. Esse envio já acontecia no cadastro manual, mas não na importação.

Por que é importante?
O CV não envia mensagens para e-mails não validados. Sem a verificação, corretores cadastrados em lote ficavam sem receber as notificações do painel. Agora a importação segue o mesmo fluxo de validação do cadastro manual, sem etapa extra para a imobiliária ou para a incorporadora. Corretores antigos que nunca validaram o e-mail também entram nesse fluxo quando aparecem na importação.

Como funciona?

• Importação: em Cadastros › Importações de Corretores, o usuário importa o arquivo normalmente, com “Importar novo arquivo”.
  
  
  
• Envio automático: o sistema envia o e-mail “Confirmação de e-mail Construtor de Vendas” para cada corretor da importação que ainda não tenha o e-mail verificado, seja ele novo ou já existente.
• Quem não recebe: corretores existentes que já têm o e-mail verificado não recebem a mensagem.
• Validação: o corretor recebe a mensagem, que explica que o e-mail precisa ser validado para ele receber as notificações do painel. Ele clica em “Verificar e-mail” para concluir.
• Acompanhamento: o envio pode ser conferido na Fila de E-mails, em Configurações.

Um tour guiado que apresenta a tela inicial da Gestão de Contratos. Ele aparece no primeiro acesso do usuário ao módulo.

Por que é importante?
Quem entra na Gestão de Contratos pela primeira vez passa a ter um caminho para entender onde fica cada recurso, sem depender de treinamento ou de suporte. Isso facilita a adoção do módulo.

Como funciona?

• Primeiro acesso: ao abrir a Gestão de Contratos pela primeira vez, o usuário vê a mensagem “Boas-vindas à Gestão de Contratos”, que resume o módulo: organizar contratos em setores, enviar para assinatura e acompanhar cada etapa em um só lugar.
• Iniciar o tutorial: ao clicar em “Iniciar tutorial”, o tour mostra onde fica cada recurso da tela.
• Fechar: o usuário também pode fechar a mensagem no “X” e seguir usando a tela normalmente.

Agora o Título do e-mail, configurado em “Configurar Envio” da Assinatura Eletrônica, pode ser usado também como nome do documento enviado para a Clicksign. 

Por que é importante?
Quando os arquivos são concatenados no envio, o documento ficava com o nome de vários arquivos juntos. O resultado era um nome grande e que muitas vezes não fazia sentido para quem recebia. Com essa melhoria, o nome do documento segue o mesmo título que você já configura para o e-mail, o que padroniza o que o assinante vê.

Como funciona?

• Ativação: em Empreendimento > Configurações > Integrações, ative a opção “Usar título do e-mail como nome do documento (Clicksign)”. Ela só funciona na Clicksign 3.0.
  
  
  
• Título: configure o “Título do e-mail” em Assinatura Eletrônica › Configurar Envio. Ele aceita variáveis, como empreendimento e unidade da reserva.
  
  
  
• Resultado: com a opção ativa, o título, já com as variáveis preenchidas, vai para a Clicksign como nome do documento. É o nome que aparece como assunto do e-mail e como nome do arquivo para o assinante. No exemplo do print, o assunto e o PDF ficam como “Retiro Teixeira- APTO 248”.
  
  
  
• Sem título configurado: o sistema continua usando o nome do contrato, como antes.
• Clicksign 1.0: nada muda, e o envio segue como antes.