A API de Comissões recebeu melhorias que ampliam as possibilidades de filtragem e enriquecem as informações retornadas no response.

Endpoint:

GET /api/v1/financeiro/comissoes

Por que isso é importante?

As melhorias permitem integrações mais completas com sistemas financeiros e de pagamento, facilitando:

• Identificação da pagadoria responsável
• Visualização da forma de pagamento realizada
• Vínculo com cobranças específicas por meio do codigo_pagadoria_int

Isso aumenta a rastreabilidade, melhora a conciliação financeira e traz mais precisão nas integrações.

O que foi implementado?

• Novo filtro por pagadoria

Foi incluído um novo parâmetro de filtro que permite consultar as comissões considerando a pagadoria vinculada.

Com isso, integrações podem segmentar os dados conforme a entidade responsável pelo pagamento das comissões.

• Forma de pagamento no array de pagamentos

No response da API, dentro do array de pagamentos dos beneficiários, passa a ser retornado o campo que identifica a forma de pagamento realizada.

Isso permite diferenciar pagamentos como:

• Boleto
• Transferência
• PIX
• Outros meios configurados

• Inclusão do código da pagadoria na programação

No array de programação da comissão, foi adicionado o campo: codigo_pagadoria_int

Esse campo identifica a cobrança associada ao agendamento de pagamento vinculado à pagadoria Avendre Pay, sendo equivalente ao ChargeID.

Essa informação facilita:

• Rastreamento da cobrança no gateway/pagadoria
• Integração com sistemas externos de faturamento
• Auditorias financeiras

Pré-requisitos

• Credenciais válidas de API
• Permissão de acesso aos dados financeiros de comissão

Foi criada a nova variável de contrato:

[[COMISSOES][PROGRAMACAO_MANUAL]]

Essa variável tem como objetivo exibir, de forma consolidada e estruturada, as informações da programação de comissão definida manualmente dentro da comissão.

Por que isso é importante?

A nova variável permite que contratos jurídicos e comerciais apresentem o detalhamento da comissão programada manualmente, garantindo:

• Mais transparência contratual
• Aderência entre comissão configurada e documento formalizado
• Redução de ajustes manuais em minutas
• Menor risco de divergências contratuais

Como funciona?

A variável [[COMISSOES][PROGRAMACAO_MANUAL]] busca os dados diretamente da programação manual cadastrada na comissão e retorna as informações consolidadas por comissionado, considerando quantidade de parcelas e valores definidos.

A variável imprime as seguintes colunas:

• Tipo
• Para
• Quantidade
• Valor
• Valor total
• Forma de pagamento
• Vencimento (considerando apenas o primeiro vencimento)

Regras de composição

• Os dados são agrupados por comissionado.
• Para cada variação de tipo de valor e/ou forma de pagamento diferente dentro do mesmo grupo original do comissionado, será gerada uma nova linha.
• O campo Vencimento exibirá o primeiro vencimento da programação correspondente.
• As informações são consolidadas exatamente conforme a programação manual definida na comissão.

Pré-requisito

• Perfil de acesso com permissão para configuração de contratos.

A funcionalidade de Comissão agora conta com uma nova seção de Campos Adicionais na tela de Informações Gerais, permitindo complementar os dados existentes com informações personalizadas.

Essa melhoria traz mais flexibilidade para registrar informações específicas do processo comissionado, atendendo necessidades particulares de cada operação — sem depender de customizações estruturais.

Com isso, as informações passam a ser utilizadas de forma mais completa e integrada aos dados já existentes na comissão.

O que foi implementado?

🔹 Nova seção de Campos Adicionais na Comissão

Foi criada uma nova seção na tela de Informações Gerais da Comissão, onde serão exibidos os campos adicionais configurados para essa funcionalidade.

Assim, os usuários podem preencher dados complementares diretamente no contexto da comissão.

🔹 Configuração no cadastro (CRUD) de Campos Adicionais

No cadastro de Campos Adicionais, foi incluído um novo checkbox que permite definir se o campo poderá ser utilizado na funcionalidade de Comissão.

Ao marcar essa opção:

• O campo adicional passa a ficar disponível na seção de Campos Adicionais da Comissão
• O preenchimento seguirá as permissões e regras já existentes para campos adicionais

Pré-requisitos

Para utilização da funcionalidade:

• Acesso ao cadastro de Campos Adicionais
• Campo adicional configurado com a opção de uso em Comissão habilitada
• Permissão de acesso à funcionalidade de Comissão

A Tabela de Preço Estática recebeu duas melhorias importantes no menu “Valor das Séries”, trazendo mais agilidade e precisão na configuração.

• Inclusão de filtro por tipologia
• Conversão dos campos de entrada para componentes Select2

Por que isso é importante?

As melhorias tornam a configuração das séries:

• Mais rápida
• Mais organizada
• Mais precisa
• Com menor risco de erro operacional

Agora é possível segmentar valores por tipologia de unidade e navegar com mais facilidade em listas extensas.

Filtro por tipologia no menu “Valor das Séries”

Foi adicionado um novo filtro por tipologia, permitindo visualizar e configurar os valores das séries considerando tipos específicos de unidades.

Isso facilita ajustes estratégicos quando diferentes tipologias possuem condições distintas.

Campos convertidos para Select2

Os campos de entrada foram convertidos para Select2, proporcionando:

• Busca rápida dentro das opções disponíveis
• Melhor usabilidade em listas extensas
• Seleção mais intuitiva e padronizada

Essa alteração melhora a experiência do usuário e reduz o tempo de configuração das séries.

Agora, as tarefas e visitas do lead com prazo vencido passam a ter um destaque visual na borda do período.

📌 Como funciona:

• Quando uma tarefa estiver pendente e o prazo de resolução já tiver sido ultrapassado, ela será exibida com borda vermelha.

Esse indicador facilita a identificação rápida de atividades atrasadas, ajudando a priorizar ações e manter o controle dos prazos.

A Simulação recebeu três melhorias importantes, que ampliam o controle, reduzem retrabalho e melhoram a experiência do usuário:

• Nova permissão no Workflow para edição da renda
• Preenchimento automático da renda via pré-cadastro
• Alerta quando não houver indicadores configurados para exibição

O que foi implementado?

1. Permissão para editar renda na Simulação

Foi criada uma nova permissão no Workflow da Simulação, responsável por controlar a possibilidade de edição do campo Renda.

Com isso, é possível:

• Restringir a alteração apenas a perfis autorizados
• Garantir maior governança sobre os dados utilizados na análise
• Evitar alterações indevidas durante o processo de aprovação

2. Carga automática da renda pelo pré-cadastro

Ao iniciar uma simulação a partir de um pré-cadastro, a renda do cliente será carregada automaticamente.

Essa melhoria:

• Reduz digitação manual
• Evita divergências entre pré-cadastro e simulação
• Garante mais consistência nos dados

3. Alerta quando não houver indicadores configurados

Quando todas as opções de visualização de indicadores estiverem desativadas, será exibido o seguinte aviso na tela de simulação:

“Não há dado configurado para exibição. Solicite ao administrador.”

Esse alerta:

• Orienta o usuário sobre a ausência de indicadores ativos
• Evita dúvidas sobre a falta de informações na tela
• Direciona corretamente a ação necessária

Foram disponibilizadas novas variáveis de pagamento para utilização em contratos jurídicos e comerciais, permitindo maior detalhamento das parcelas:

• Com juros
• Sem juros
• Pré-habite-se
• Pós-habite-se

Essas variáveis ampliam a precisão na geração de documentos, possibilitando discriminar valores agrupados, subtotais e versões por extenso.

Variáveis adicionadas

🔹 Parcelas com juros – Pré-habite-se

[[SERIE][N][O][G][PARCELA_COM_JUROS_PRE_HABITESE]]
[[SERIE][N][O][G][PARCELA_COM_JUROS_PRE_HABITESE_EXTENSO]]

🔹 Subtotal das parcelas com juros – Pré-habite-se

[[SERIE][N][O][G][VALOR_TOTAL_PARCELA_SUBTOTAL_COM_JUROS_PRE_HABITESE]]
[[SERIE][N][O][G][VALOR_TOTAL_PARCELA_SUBTOTAL_COM_JUROS_PRE_HABITESE_EXTENSO]]

🔹 Parcelas com juros sem comissão – Pré-habite-se

[[SERIE][N][O][G][VALOR_PARCELA_SUBTOTAL_COM_JUROS_SEM_COMISSAO_PRE_HABITESE]]
[[SERIE][N][O][G][VALOR_PARCELA_SUBTOTAL_COM_JUROS_SEM_COMISSAO_PRE_HABITESE_EXTENSO]]

🔹 Parcelas com juros – Pós-habite-se

[[SERIE][N][O][G][PARCELA_SEM_JUROS_POS_HABITESE]]
[[SERIE][N][O][G][PARCELA_COM_JUROS_POS_HABITESE_EXTENSO]]

🔹 Subtotal das parcelas com juros – Pós-habite-se

[[SERIE][N][O][G][VALOR_TOTAL_PARCELA_SUBTOTAL_COM_JUROS_POS_HABITESE]]
[[SERIE][N][O][G][VALOR_TOTAL_PARCELA_SUBTOTAL_COM_JUROS_POS_HABITESE_EXTENSO]]

🔹 Parcelas com juros sem comissão – Pós-habite-se

[[SERIE][N][O][G][VALOR_PARCELA_SUBTOTAL_COM_JUROS_SEM_COMISSAO_POS_HABITESE]]
[[SERIE][N][O][G][VALOR_PARCELA_SUBTOTAL_COM_JUROS_SEM_COMISSAO_POS_HABITESE_EXTENSO]]

Regras de composição das variáveis

As variáveis seguem a estrutura:

• N → representa o ID da série
• O → representa a ordem da série (quando houver mais de uma série do mesmo tipo)
• G → representa o agrupamento de valores
• É possível utilizar condicionais para imprimir ou não os grupos conforme a necessidade do contrato 

O Relatório de Acompanhamento de Reservas agora passa a exibir, no rodapé, os totais somados de todas as colunas que retornam valores em R$.

Essa melhoria oferece uma visão consolidada imediata dos valores envolvidos, facilitando análises, conferências e fechamento de resultados — sem a necessidade de cálculos manuais.

Como funciona?

Ao gerar o relatório, será exibida uma linha de totalização no rodapé, contemplando:

• Valores de comissão
• Valores financeiros das reservas
• Campos adicionais que possuam valores monetários (R$)

Os totais são calculados automaticamente com base nos registros retornados, considerando os filtros aplicados no relatório.

Disponibilizamos o novo relatório Demonstrativo de Vendas e Estoque, que apresenta uma visão consolidada das vendas, reservas em processo e estoque dos empreendimentos, seguindo um modelo estruturado de análise gerencial.

Esse relatório oferece uma visão completa do desempenho comercial, facilitando o acompanhamento das vendas, análise de oferta e suporte à tomada de decisão estratégica.

Estrutura do Relatório

O relatório é organizado por empreendimento e apresenta colunas compostas pelos seguintes indicadores:

• Quantidade
• Área média
• VGV
• Valor médio do m²
• % (percentual em relação ao total de unidades)

Cada linha do relatório apresenta os dados consolidados conforme a situação das unidades:

Reservas Vendidas (no período)

Apresenta, por empreendimento:

• Quantidade de unidades vendidas no período
• Área média privativa das unidades vendidas
• VGV considerando o valor da proposta
• Valor médio por m² das vendas
• Percentual em relação ao total de unidades

Reservas em Processo (no período)

Exibe os mesmos indicadores para reservas que ainda estão em andamento no período selecionado, considerando o valor das propostas vinculadas.

Estoque Atual

Mostra os dados das unidades disponíveis no momento da consulta:

• Quantidade de unidades em estoque
• Área média privativa
• VGV das unidades disponíveis
• Valor médio por m²
• Percentual sobre o total do empreendimento

Total

Consolidação geral das unidades do empreendimento, independentemente da situação:

• Quantidade total de unidades
• Área média geral
• VGV total
• Valor médio por m²
• Percentual total

Filtros Disponíveis

O relatório conta com os seguintes filtros:

• Empreendimento (seleção múltipla com opção “Todos”)
• Período por data de cadastro
• Período por data da venda
• Região

Recursos Adicionais

• Exportação dos dados em CSV
• Envio do relatório por e-mail

Foi criado um novo indicador de análise chamado “Pré-chaves”, que avalia o valor recebido até a entrega das chaves, com base em regras configuradas no empreendimento.

Por que isso é importante?

O novo indicador permite acompanhar se o valor captado até a entrega das chaves está dentro dos limites definidos pela estratégia comercial do empreendimento.

Com isso, é possível garantir:

• Maior controle financeiro
• Previsibilidade no fluxo de recebimentos
• Aderência às diretrizes comerciais

Como funciona?

1. Configuração no empreendimento

Antes de utilizar o indicador, é necessário definir no cadastro do empreendimento:

• Porcentagem mínima pré-chaves
• Porcentagem máxima pré-chaves

Esses limites servirão como base para análise nas simulações e reservas.

2. Validação na reserva

O indicador será validado no momento da:

• Aprovação automática

Caso o valor esteja fora dos limites definidos, o sistema exibirá um feedback em formato de toast, alertando o usuário sobre o desvio em relação às regras de pré-chaves.

3. Exibição na simulação

• O indicador pode ser ativado no menu de Personalização dos Indicadores.
• Após habilitado, o valor será exibido na seção de indicadores da simulação.

Assim, o usuário consegue acompanhar em tempo real se a proposta está aderente às regras de recebimento até a entrega das chaves.