O que é

Conjunto de melhorias de usabilidade no novo relatório de vendas, adicionando ordenação de colunas, busca inline por termo e redesenho do formulário de filtros.

O que mudou

Ordenação de colunas
O usuário agora pode ordenar os resultados do relatório clicando no cabeçalho de qualquer coluna crescente ou decrescente  sem precisar reprocessar o relatório.

Busca inline por termo
Campo de busca disponível diretamente na tela do relatório. O usuário digita um termo  como o nome de um cliente e o sistema filtra os registros exibidos em tempo real, sem depender do CTRL+F do navegador. A busca funciona dentro da coluna desejada, localizando correspondências parciais.

Melhoria no formulário de filtros
O formulário de geração do relatório, que já existia, foi reorganizado visualmente para melhor aproveitamento de espaço em tela reduzindo rolagem e tornando a seleção de filtros mais ágil.

O que é

Nova opção no menu de personalização de indicadores, dentro da visualização geral, que permite ao administrador desabilitar a exibição dos dados na ficha de simulação.

Por que foi feito

Clientes com perfis comerciais mais restritos precisam controlar quais informações aparecem na simulação apresentada ao comprador ou ao corretor. Sem essa opção, todos os dados da ficha ficavam sempre visíveis, sem possibilidade de ocultação por configuração.

O que mudou

No menu de configurações da tabela comparativa , a seção de visualização geral agora conta com um toggle para habilitar ou desabilitar os dados exibidos na ficha de simulação sem necessidade de customização técnica ou intervenção de desenvolvimento.

Resultado

O administrador passa a ter controle fino sobre o que é exibido na simulação, alinhando a experiência à política comercial de cada cliente sem impactar outros indicadores ou configurações da tabela.

O que foi feito

A API de consulta de reserva (GET /api/v1/comercial/reservas/{idReserva}) passou a retornar, no payload de resposta, os motivos associados ao status da reserva — cada um com ID e descrição:

• Motivo de cancelamento
• Motivo de distrato
• Motivo de permuta

Antes, esses campos não eram expostos na API, mesmo quando a reserva já havia sido cancelada/distratada/permutada com um motivo registrado no sistema.

Por que é importante

Integradores e sistemas parceiros que consomem essa API (ERPs, dashboards comerciais, automações) precisavam do motivo para alimentar seus próprios fluxos  relatórios de causa de perda, alertas, réguas de reengajamento. Sem o campo, a única saída era consultar manualmente no CV ou cruzar dados por fora, o que gerava retrabalho e inconsistência.

Com a exposição desses campos, a integração passa a ser completa: o sistema consumidor consegue saber o que aconteceu com a reserva, não só qual status ela tem.

O Relatório de Vendas foi completamente reformulado para oferecer uma experiência mais moderna, intuitiva e produtiva.

A nova versão reorganiza a navegação, simplifica a configuração dos filtros e amplia as possibilidades de exportação e compartilhamento dos dados, tornando a análise comercial muito mais rápida.

Principais melhorias

🎯 Filtros organizados por contexto

Os filtros agora estão agrupados em seções colapsáveis, facilitando a localização das informações necessárias:

• Período
• Empreendimento
• Cliente
• Corretor / Imobiliária
• Marketing

Com isso, a tela fica mais limpa e a configuração do relatório se torna mais intuitiva.

Resultado exibido na mesma página

O resultado agora é carregado logo abaixo dos filtros, sem abrir uma nova tela.

Isso permite realizar ajustes e gerar novamente o relatório de forma muito mais rápida, mantendo todo o contexto da análise.

Novas opções de exportação

Além da visualização em tela, agora é possível exportar o relatório em diversos formatos:

• Copiar
• CSV
• Excel
• PDF
• Imprimir
• Compartilhar

Personalização de colunas

A nova tabela permite escolher quais informações serão exibidas por meio do botão Colunas, sem necessidade de reconfigurar o relatório.

Melhor visualização dos resultados

A nova estrutura inclui:

• Colunas fixas para facilitar a leitura
• Rolagem horizontal para grandes volumes de dados
• Controle de paginação
• Seleção da quantidade de registros por página

Por que realizamos essa mudança?

A versão anterior apresentava alguns desafios na utilização diária:

• Grande volume de filtros e campos em uma única tela
• Dificuldade para distinguir filtros das colunas de exibição
• Poucas opções de exportação
• Necessidade de abrir novas páginas para visualizar resultados
• Experiência pouco adaptada para diferentes tamanhos de tela

O novo modelo foi desenvolvido para tornar a geração e análise dos relatórios mais simples, rápida e eficiente.

Impacto na operação

Mais agilidade na geração de relatórios

Os filtros organizados reduzem o tempo necessário para configurar consultas.

Exportação facilitada

Agora é possível gerar arquivos Excel, CSV e PDF diretamente pela interface.

Ajustes mais rápidos

Como o resultado permanece na mesma página, ficou muito mais fácil alterar filtros e reaplicar consultas.

Compartilhamento simplificado

O novo botão de compartilhamento elimina etapas manuais de exportação e envio.

Menor curva de aprendizado

A nova estrutura facilita a utilização por novos usuários, reduzindo a necessidade de treinamento.

Como utilizar

1. Acesse o menu Relatórios → Vendas

O relatório será aberto com o período padrão dos últimos 6 meses.

2. Configure os filtros

Expanda apenas as seções necessárias e preencha os critérios desejados.

3. Clique em "Aplicar"

Os resultados serão exibidos imediatamente abaixo dos filtros.

4. Personalize as colunas (opcional)

Utilize o botão Colunas para mostrar ou ocultar informações.

5. Exporte ou compartilhe

Escolha o formato desejado diretamente na barra de ações da tabela.

6. Refine a consulta

Altere os filtros e clique novamente em Aplicar sempre que desejar atualizar os resultados.

Agora é possível atualizar as regras de aprovação de uma reserva quando houver alterações nas configurações do empreendimento.

Foi criado um mecanismo de sincronização que permite aplicar às reservas as regras mais recentes definidas no empreendimento ou tabela de preço, sem a necessidade de recriar a negociação.

Por que isso é importante?

Antes da melhoria, as regras de aprovação eram copiadas para a reserva apenas no momento da sua criação.

Isso significava que:

• Alterações posteriores no empreendimento não refletiam nas reservas já existentes
• Regras ficavam desatualizadas
• A gestão e auditoria das aprovações se tornavam mais complexas

Com a nova funcionalidade, os usuários passam a ter maior controle sobre a aderência das reservas às políticas vigentes do empreendimento ou tabela.

Como funciona?

Atualização das regras

Foi criado um mecanismo que compara:

• As regras atualmente armazenadas na reserva
• As regras vigentes no empreendimento

Quando houver divergência, a reserva poderá ser atualizada.

Novo botão de atualização

Na seção financeira da reserva, foi adicionado um botão para atualização das regras.

O botão será exibido apenas quando:

• Existir diferença entre as regras da reserva e as do empreendimento ou tabela

Controle por perfil de acesso

A visualização do botão depende de uma nova permissão de acesso.

Dessa forma, apenas usuários autorizados poderão executar a atualização.

Histórico de alterações

Todas as atualizações realizadas serão registradas no histórico da reserva.

O sistema armazenará:

• Data e hora da atualização
• Usuário responsável
• Comparativo das alterações realizadas

Data da última atualização

Passa a ser registrada a data da última atualização das regras da reserva, facilitando auditorias e conferências.

Impacto na operação

• Maior controle das regras de aprovação
• Redução de inconsistências entre reservas e empreendimento
• Melhor governança das políticas comerciais
• Histórico completo das alterações realizadas
• Mais transparência para auditorias e análises

Pré-requisitos

• Reserva com regras cadastradas
• Alteração posterior das regras no empreendimento
• Usuário com permissão para atualização

Foi criada uma nova variável para utilização em modelos HTML e Word, permitindo exibir a informação preenchida no campo Correção da série financeira.

Nova variável

[[SERIE][N][CORRECAO_SERIE]]

Por que isso é importante?

Até então, não havia uma variável específica para retornar a correção configurada na série, o que exigia preenchimentos manuais ou adaptações nos modelos de contrato.

Com essa melhoria:

• Reduzimos retrabalho na elaboração de documentos
• Garantimos maior consistência das informações
• Facilitamos a automação de contratos e minutas
• Mantemos os documentos alinhados com os dados da reserva

Como funciona?

A variável retorna o conteúdo informado no campo Correção da série financeira.

⚠️ Importante:
Essa variável retorna a correção da série, e não a correção do contrato como um todo.

A variável pode ser utilizada em:

• Contratos jurídicos
• Contratos comerciais
• Minutas em HTML
• Modelos Word

Exemplo de uso

Correção monetária: [[SERIE][1][CORRECAO_SERIE]]

Exemplo de resultado:

Correção monetária: IPCA

Pré-requisitos

• Existência de série financeira vinculada à reserva
• Campo de correção devidamente preenchido
• Modelo de documento compatível com variáveis dinâmicas

A Listagem de Boletos passa a exibir também os boletos do tipo ATO, contemplando tanto integrações com Linkpay quanto com Avendre Pay.

Por que isso é importante?

Até então, os boletos de ATO não estavam disponíveis na listagem, dificultando o acompanhamento e a gestão desses pagamentos pelos usuários.

Com essa melhoria, os boletos de ATO passam a seguir a mesma experiência já existente para os boletos de comissão, centralizando a operação em um único local.

Como funciona?

📄 Visualização dos boletos

Os boletos de ATO agora são exibidos na Listagem de Boletos juntamente com os demais títulos financeiros.

São contemplados:

• ATOs da Linkpay
• ATOs do Avendre Pay

Consulta dos detalhes

Os usuários poderão visualizar as informações dos boletos diretamente pela listagem, facilitando o acompanhamento do status e dos dados do pagamento.

Download de boletos

Passa a ser possível realizar o download dos boletos de ATO da mesma forma que já ocorre com outros tipos de boleto.

Cancelamento

Os boletos de ATO também poderão ser cancelados pela listagem, seguindo as mesmas regras e comportamentos já aplicados aos boletos de comissão.

Impacto na operação

• Centralização da gestão de boletos
• Melhor visibilidade dos pagamentos de ATO
• Redução da necessidade de consultas em múltiplas telas
• Mais autonomia para usuários financeiros e operacionais

Interface

📍 Caminho:
Gestor → Financeiro → Listagem de Boletos

Novas capacidades:

• Visualizar boletos de ATO
• Baixar boletos de ATO
• Cancelar boletos de ATO

Foi criada uma nova API no padrão V4 para permitir o gerenciamento da condição de pagamento das reservas de forma mais flexível e segura.

Com ela, integrações passam a poder:

• Adicionar séries
• Editar séries existentes
• Remover séries da condição de pagamento

Tudo isso sem a necessidade de recriar a condição completa da reserva.

Por que isso é importante?

Antes dessa melhoria, alterações na condição de pagamento dependiam de processos exclusivamente manuais.

Agora, sistemas integrados conseguem realizar ajustes pontuais diretamente na reserva, mantendo maior aderência aos fluxos comerciais e financeiros.

Como funciona?

Adicionar série

Permite incluir uma nova série na condição de pagamento da reserva.

Endpoint

POST /v4/comercial/reservas/{idReserva}/condições

Editar série

Permite alterar informações de uma série já existente na condição de pagamento.

Endpoint

PATCH /v4/comercial/reservas/{idReserva}/condicoes/{idReservasCondicoes}

Remover série

Permite excluir uma série da condição de pagamento da reserva.

Endpoint

DELETE /v4/comercial/reservas/{idReserva}/condicoes/{idReservasCondicoes}

Segurança e permissões

Todos os endpoints:

• Utilizam autenticação JWT
• Respeitam as permissões já existentes do módulo de reservas
• Validam regras de negócio antes da execução

O que pode ser alterado?

As APIs oferecem as mesmas possibilidades disponíveis na interface do sistema, incluindo:

• Quantidade de parcelas
• Valores
• Vencimentos
• Forma de pagamento
• Tipo de juros
• Correção monetária
• Comissão
• Portadores e indexadores
• Demais informações da série financeira

Regras de validação

A API valida automaticamente cenários como:

• Reserva inexistente
• Condição não pertencente à reserva
• Datas de vencimento inválidas
• Taxas incompatíveis
• Falta de permissão
• Regras comerciais que impeçam a alteração

Retornos da API

Pré-requisitos

• Integração utilizando a API V4
• Token JWT válido
• Permissões adequadas para manipulação de reservas

Onde utilizar?

A nova API é ideal para integrações que precisam realizar manutenção da condição de pagamento após a criação da reserva, sem depender de ações manuais na interface. Consulte em https://desenvolvedor.cvcrm.com.br/.

Agora, ao realizar um distrato de reserva via integração, o sistema também registra automaticamente o motivo de bloqueio da unidade.

Por que isso é importante?

Antes dessa melhoria, quando o distrato era realizado por integração, a unidade era bloqueada sem qualquer identificação do motivo.

Isso dificultava:

• A rastreabilidade da operação
• A identificação da origem do bloqueio
• Análises operacionais e comerciais
• O entendimento do histórico da unidade

Com a alteração, todas as unidades bloqueadas por distrato passam a possuir um motivo associado.

Como funciona?

Ao receber uma solicitação de distrato via integração, o sistema:

• Realiza o distrato da reserva normalmente
• Bloqueia a unidade conforme a regra atual
• Define automaticamente um motivo para o bloqueio

📝 Motivo padrão

Por padrão, será utilizado o motivo:

"Distrato via Integração"

Pré-requisitos

• Integração habilitada para realização de distratos
• Unidade sujeita ao bloqueio após o distrato

Interface

• O motivo de bloqueio ficará visível nas informações da unidade
• Nenhuma alteração será necessária nos fluxos atuais de integração

Ao clonar uma reserva, o sistema agora passa a aplicar automaticamente a planta da unidade de destino, quando houver uma planta vinculada a essa unidade.

Por que isso é importante?

Antes da melhoria, a reserva clonada podia ficar sem uma planta associada, mesmo quando a unidade de destino possuía uma planta cadastrada.

Isso gerava inconsistências na reserva e exigia ajustes manuais por parte dos usuários.

Com a correção, a clonagem passa a respeitar as características da unidade selecionada.

Como funciona?

• Ao realizar a clonagem de uma reserva:
  • O sistema identifica a unidade de destino
  • Verifica se existe uma planta associada à unidade
  • Aplica automaticamente essa planta na nova reserva