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 que é?A aba "Aplicativos" foi removida do cadastro de empreendimento. Ela exibia configurações que não tinham mais utilidade desde que os aplicativos nativos passaram a ser a forma padrão de uso.

🔹 Por que é importante?A aba estava desatualizada e sem manutenção, o que gerava ruído visual desnecessário para os gestores. Removê-la deixa o cadastro mais limpo e evita confusão com configurações que não tinham mais efeito prático.

🔹 Como funciona? Nenhuma ação é necessária. A aba simplesmente não aparece mais no cadastro do empreendimento. As permissões associadas a ela também foram removidas, sem impacto nas demais configurações ou no acesso dos usuários ao sistema.

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.

A tela de Caixa de Entrada recebeu ajustes visuais para facilitar a leitura e o trabalho com os e-mails recebidos.

O que mudou:

• Modal ampliado para melhor aproveitamento do espaço e leitura mais confortável dos dados
• Campo de descrição agora conta com duas abas:
  • Visualização — exibe o corpo do e-mail com formatação original (texto, links, imagens)
  • Texto Simples — exibe o conteúdo sem formatação, útil para cópia e leitura rápida

Por que isso importa:

• Elimina a dificuldade de interpretar e-mails que chegavam sem formatação
• Reduz o tempo gasto tentando entender o conteúdo de mensagens mais complexas
• Dá flexibilidade para o operador escolher a melhor forma de visualizar o e-mail conforme a necessidade

A tela de cadastro do atendimento e o administrar agora exibem as informações de status do empreendimento diretamente na tela.

Cadastro do atendimento:

Administrar do Atendimento:

O que mudou:

• Exibição do campo Sit. Comercial do empreendimento no cadastro do atendimento
• Exibição do campo Sit. da Obra do empreendimento no cadastro do atendimento

Por que isso importa:

• Os atendentes passam a ter contexto imediato sobre o empreendimento sem precisar sair da tela
• Reduz consultas paralelas e trocas de contexto desnecessárias durante o atendimento
• Informação disponível no momento certo, onde a decisão acontece

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

O endpoint PUT da API de Assistência Técnica agora aceita o preenchimento e edição do campo parecer técnico.

O que mudou:

• Campo parecer técnico disponível via PUT para escrita e atualização

Por que isso importa:

• Integrações que gerenciam assistências técnicas passam a ter controle completo do ciclo — sem depender de atualização manual no sistema
• Reduz etapas manuais em fluxos automatizados que já usam a API
• Garante que o parecer técnico fique registrado diretamente pela integração, sem risco de inconsistência entre sistemas

A tela de Pesquisas recebeu um ajuste visual para tornar a navegação mais clara e a experiência mais atual.

O que mudou:

• Reorganização dos elementos visuais da tela
• Layout mais limpo e organizado

O que não mudou:

• Nenhuma alteração no fluxo de uso
• Todas as funcionalidades seguem exatamente como antes

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