O que o endpoint faz hoje

Ele retorna os dados da reserva no Sienge vinculada ao CV CRM, trazendo informações contratuais, financeiras e status da reserva.

Na prática:

• É um endpoint consultivo
• Focado em dados financeiros e contratuais
• Usado dentro do fluxo de integração CV ↔ Sienge

Foi criada uma nova configuração que permite definir a Tabela de Preço em modo somente leitura para corretores e imobiliárias, restringindo ações como exportação, download e compartilhamento.

Por que isso é importante?

Essa melhoria reduz riscos jurídicos e comerciais ao evitar a circulação indevida de tabelas de preço fora do sistema, garantindo que:

• Os usuários sempre acessem informações atualizadas
• Não haja compartilhamento não autorizado
• Dados estratégicos fiquem protegidos contra concorrência

Como funciona?

Foi criada a configuração: “Tabela de preço em modo somente leitura para corretores e imobiliárias”

Local: Cadastro do empreendimento → Seção de Tabelas
Valor padrão: Desabilitado

Comportamento quando habilitado

Restrições para corretores e imobiliárias

• Bloqueio de exportação (PDF, Excel e outros formatos)
• Bloqueio da ação de compartilhamento da tabela
• Bloqueio do botão “todas as unidades” no mapa de disponibilidade
• Bloqueio de download, inclusive na visualização em HTML

Visualização mantida

• A tabela continua disponível para consulta dentro do sistema
• Sem possibilidade de extração dos dados

Proteção adicional

• Restrição de impressão via navegador (ex.: CTRL+P) na visualização em HTML, evitando tentativas de contornar o bloqueio

Apresentamos a nova sidebar do Comunicador Pré-Vendas, desenvolvida para tornar o fluxo de atendimento mais ágil, moderno e intuitivo.

Por que isso é importante?

A nova interface foi pensada para melhorar a experiência do usuário no dia a dia, permitindo:

• Mais agilidade no atendimento
• Melhor organização das interações
• Acesso rápido às informações relevantes
• Redução de tempo operacional

O que muda na prática?

Com a nova sidebar, é possível conduzir todo o processo de comunicação de forma mais fluida, com:

• Navegação mais simples e intuitiva
• Melhor visualização das informações do atendimento
• Interações mais rápidas e organizadas

Foram adicionados novos campos para leitura automática de documentos de CNPJ através do Magic Documentos, ampliando a capacidade de extração de dados.

Como funciona?

Ao realizar a leitura de um documento de CNPJ, o sistema passa a extrair automaticamente as seguintes informações:

• Número do registro
• Nome Empresarial
• Nome Fantasia
• Inscrição Estadual/Municipal
• E-mail
• Telefone
• Endereço

Na integração com o Sienge, ao enviar o cadastro de imobiliárias, o campo typesId passa a ser enviado com o valor: "CO" (corretor). Anteriormente, esse campo era enviado como "fornecedor".

Foi adicionada a coluna Posição Solar no Relatório de Estoque de Unidades, ampliando o nível de detalhamento das informações disponíveis.

Por que isso é importante?

A posição solar da unidade é uma informação relevante no processo comercial, pois influencia diretamente na decisão de compra do cliente.

Como funciona?

• A coluna Posição Solar passa a ser exibida no relatório de estoque
• O valor é obtido diretamente do cadastro da unidade
• Caso a informação esteja preenchida, será exibida automaticamente no relatório

Foram disponibilizadas novas APIs para consulta, cadastro e gestão de regras e pagamentos de comissão, ampliando as possibilidades de integração com sistemas externos.

⚠️ Importante:
O uso dessas APIs depende de liberação prévia pelo time do CV, pois não são APIs públicas.

• Consulta de regra de comissão, para verificar os dados de regra da comissão da reserva
  https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/reservas/{idReserva}/regras-comissao
•  Cadastro de Regra de Comissão
  https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/reservas/{idReserva}/comissoes
•  Deleção de regra de comissão
  /v3/comercial/reservas/{idReserva}/comissoes/{idRegra}
  Precisa passar um Id por vez
•  Pagamento de comissão
  Cadastro de pagamento de comissão, precisa consultar o idRegra de comissão
  POST
  /v3/financeiro/comissoes/{idComissao}/pagamentos
  Cadastra um pagamento para uma comissão
•  Atualização de pagamento de comissão
  PATCH
  /v3/financeiro/comissoes/{idComissao}/pagamentos/{idPagamento}
  Atualiza um pagamento de comissão
•  Deleção de pagamento de comissão
  DELETE
  /v3/financeiro/comissoes/{idComissao}/pagamentos
  Remove pagamentos de uma comissão

Foi implementado o Diagnóstico da Integração, um recurso que permite antecipar possíveis inconsistências no envio de reservas para o Sienge, orientando os ajustes necessários antes ou após a integração.

O diagnóstico é apresentado em três categorias:

• Avisos: não bloqueiam o envio da reserva, mas sinalizam comportamentos esperados ou pontos de atenção que podem demandar ajuste.
• Problemas: impedem o envio da reserva, indicando de forma objetiva o que precisa ser corrigido para que a integração ocorra com sucesso.
• Sucesso: informa que as validações foram atendidas e que a reserva está em conformidade para integração.

Para isso, o recurso varre todo o conjunto de regras necessárias para o correto funcionamento da integração, aplicando o diagnóstico correspondente conforme o cenário identificado.

A execução do diagnóstico poderá ocorrer em dois momentos:

• Ao avançar a reserva para a etapa marcada com a flag “Pode Faturar”;
• Ou posteriormente ao envio, permitindo validar também o comportamento da integração após a tentativa de processamento.

No CV Sign, a rubrica passa a ter um formato próprio de exibição, deixando de aparecer como uma variação da assinatura.

Agora, a rubrica é exibida utilizando as iniciais do nome do assinante, criando uma diferenciação visual clara em relação à assinatura completa.

Por que isso é importante?

Essa melhoria traz mais clareza na leitura dos documentos assinados, permitindo identificar de forma mais rápida:

• Onde há assinaturas completas
• Onde há rubricas

Isso melhora a compreensão do documento e deixa o processo de assinatura mais organizado e padronizado.

Exemplo de variável de assinatura + marcação de local de rubrica:

Essa exibição ocorre:

• No processo de assinatura no CV Sign

• No documento final após a assinatura

Observação: as limitações relacionadas à paginação de rubrica permanecem as mesmas. Essa atualização altera apenas o formato de exibição da rubrica, trazendo um novo visual que diferencia claramente rubrica e assinatura.

Foram realizadas melhorias nas APIs relacionadas à consulta de tipos de documentos utilizados no pagamento de comissões, além da ampliação de filtros em outras consultas existentes.

O objetivo é tornar as consultas mais confiáveis, previsíveis e fáceis de utilizar nas integrações e operações do dia a dia.

Consulta de tipos de documentos para pagamento de comissões

A consulta pode ser acessada em:

https://integracao.cvcrm.com.br/api/v3/configuracoes/tipos-arquivos-pagamentos-comissoes

Comportamento após a melhoria

• Apenas opções válidas e ativas passam a aparecer na listagem
• Consultas com informações preenchidas incorretamente podem retornar mensagens de inconsistência
• Situações inesperadas continuam sendo tratadas como erro interno

Essas mudanças aumentam a confiabilidade dos dados retornados pela API.

Novos filtros em consultas existentes

Também foram adicionados filtros por nome em algumas consultas já existentes, facilitando buscas quando não se possui o código ou documento do registro.

Consultas que passaram a contar com esse filtro:

• Consulta de corretores
• Consulta de usuários administrativos
• Consulta de imobiliárias
• Consulta de usuários de imobiliárias

Na prática, isso permite localizar registros com mais facilidade quando o cliente não tiver em mãos um código ou documento. 

Nova consulta de imobiliárias

Foi disponibilizada uma nova API para consulta de imobiliárias, com possibilidade de busca por nome.

Endereço:

https://integracao.cvcrm.com.br/api/v1/cadastros/imobiliarias

Comportamentos esperados

• A consulta retorna normalmente quando os dados informados estão corretos
• Consultas com parâmetros inválidos retornam mensagem de preenchimento incorreto
• Falhas inesperadas continuam sendo tratadas como erro interno