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 que mudou?

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.

🎯 O que mudou?

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.

🎯 O que mudou?

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.

Agora é possível definir um Observador também nos contratos enviados pela Clicksign. Ele acompanha o contrato sem assinar.

Por que é importante?
Padroniza o recurso entre as integrações. A mesma configuração de observador passa a valer para CV Sign, DocuSign e Clicksign. Quem precisa acompanhar o contrato recebe as atualizações sem entrar como assinante.

Como funciona?

• Disponibilidade: a opção só aparece com a nova estrutura de assinatura digital ligada (Clicksign v3). Na estrutura antiga (Clicksign v1), o observador não é enviado nem gravado, e o envelope segue normalmente.
• Configuração: em Gestor › Empreendimento › Configurar Assinantes, o campo “Tipo de ação” passa a ter a opção Observador. Quem for marcado aparece na tabela “Observadores”, com tipo do observador, nome e login ativo.
  
• Acompanhamento por e-mail: a Clicksign envia e-mail em todos os passos. A cada assinatura, o observador recebe um e-mail. Quando todos assinam, ele recebe o e-mail com o arquivo assinado.
• Sem duplicidade: o mesmo usuário não pode ser assinante e observador no mesmo contrato. Se o contrato trocar de integração (CV Sign, DocuSign ou Clicksign), o observador é mantido.
• Onde vale: apenas na Reserva.