Foram criadas duas novas variáveis condicionais para documentos de contrato, permitindo exibir blocos de texto de acordo com a existência de linhas de comissão ou prêmio dentro ou fora do contrato.

As novas variáveis são:

• ${SE_COMISSAO_RETIRAR_SUBTOTAL_NAO}
• ${SE_COMISSAO_RETIRAR_SUBTOTAL_SIM}
  
  

Por que isso é importante?

Anteriormente, a variável ${SE_COMISSAO_N_RETIRAR_SUBTOTAL_NAO} exigia a indicação da posição da linha de comissão, retornando o conteúdo individualmente para cada linha.

Com as novas variáveis, é possível avaliar a condição de forma geral, sem precisar identificar a posição de cada comissão ou prêmio.

Isso oferece mais flexibilidade na elaboração de contratos e na exibição de cláusulas condicionais.

Como funciona?

As novas variáveis funcionam como condicionais para exibição de blocos de texto:

1. Comissão ou prêmio fora do contrato

${SE_COMISSAO_RETIRAR_SUBTOTAL_NAO}

Retorna o texto configurado no bloco condicional quando existir pelo menos uma linha de comissão ou prêmio fora do contrato, ou seja, com Retirar do Subtotal = NÃO.

2. Comissão ou prêmio dentro do contrato

${SE_COMISSAO_RETIRAR_SUBTOTAL_SIM}

Retorna o texto configurado no bloco condicional quando existir pelo menos uma linha de comissão ou prêmio dentro do contrato, ou seja, com Retirar do Subtotal = SIM.

As duas variáveis estarão disponíveis nos formatos de documentos Texto e Word, contemplando também as informações utilizadas pela variável condicional anterior.

Benefícios

• Mais flexibilidade na montagem de contratos;
• Exibição de textos conforme as condições das comissões e dos prêmios;

Foi adicionada uma nova coluna na área de comissão para apresentar a data efetiva em que o pagamento da comissão foi realizado.

Por que isso é importante?

A informação permite acompanhar com mais precisão quando o pagamento aconteceu, facilitando a conferência dos valores e o controle financeiro das comissões.

Como funciona?

A nova coluna apresenta a data em que o pagamento da comissão foi efetivamente realizado, permitindo diferenciá-la de outras datas do processo, como vencimento ou previsão de pagamento.

Benefícios

• Maior transparência no acompanhamento dos pagamentos;
• Facilidade na conferência de comissões;
• Melhor controle e organização financeira;
• Identificação rápida da data em que o pagamento foi realizado.

Foram criadas duas novas flags no workflow de reservas para automatizar a movimentação das reservas conforme a situação dos boletos de comissão:

1. Todos os boletos de comissão pagos
2. Boleto de comissão vencido

Com essas flags, o workflow pode direcionar automaticamente a reserva para a situação configurada quando as condições de pagamento forem atendidas.

Por que isso é importante?

A melhoria amplia as possibilidades de automação dos workflows e facilita o acompanhamento dos pagamentos de comissão, permitindo que as reservas avancem conforme os eventos financeiros, sem depender exclusivamente de movimentações manuais.

Como funciona?

1. Todos os boletos de comissão pagos

A flag identifica quando todos os boletos da cadeia de comissão foram pagos.

Ao identificar essa condição, o sistema movimenta a reserva para a situação configurada no workflow.

2. Boleto de comissão vencido

A flag identifica a existência de boleto de comissão gerado, não pago e vencido.

Para essa validação, o boleto é considerado vencido quando permanece em aberto um dia após sua data de vencimento.

Ao identificar essa condição, o sistema movimenta a reserva para a situação configurada no workflow.

Regras de funcionamento

As duas flags funcionam somente enquanto a reserva estiver em uma etapa ativa do workflow.

Reservas que já tenham chegado a etapas finais — Vendida, Cancelada ou Distrato — não serão movimentadas por essas regras.

Benefícios

• Automação da movimentação de reservas conforme os pagamentos de comissão;
• Identificação de boletos vencidos;
• Maior controle sobre a inadimplência de comissões;
• Redução de acompanhamentos e movimentações manuais.

A integração entre o CV CRM e o Sienge foi aprimorada para permitir a escolha do tipo de documento utilizado na geração dos títulos de comissão no contas a pagar.

Anteriormente, quando a liberação era feita no CV CRM, os títulos eram enviados sempre com o tipo de documento NF (Nota Fiscal), sem possibilidade de selecionar alternativas, como NFSe (Nota Fiscal de Serviço Eletrônica).

Por que isso é importante?

A melhoria oferece mais flexibilidade para adequar a geração dos títulos às necessidades fiscais e operacionais de cada cliente.

Com isso, o documento gerado no Sienge poderá corresponder ao tipo selecionado na configuração da integração, evitando que todos os pagamentos de comissão sejam registrados obrigatoriamente como NF.

Como funciona?

A integração passa a considerar o campo documentIdentificationId da API do Sienge para informar o tipo de documento do título.

Pode ser feita a sincronização dos tipos:

Depois de sincronizar, basta escolher qual o tipo que será utilizado nas liberações.

Na prática:

• O usuário seleciona o tipo de documento desejado na configuração dos parâmetros do Sienge;
• O CV CRM utiliza o identificador correspondente na integração;
• Ao liberar o pagamento da comissão no CV CRM, o título é gerado no contas a pagar do Sienge com o tipo de documento selecionado.

A integração também poderá utilizar a API do Sienge para consultar os tipos de documentos disponíveis, facilitando a seleção e configuração dessas opções.

Benefícios

• Flexibilidade na escolha do tipo de documento;
• Suporte a diferentes documentos fiscais, como NF e NFSe;
• Maior aderência às configurações fiscais do cliente;
• Mais consistência entre a liberação de comissões.

A ação Bloquear Pagamentos da Comissão foi aprimorada para impedir efetivamente o repasse de valores ao comissionado quando uma linha de pagamento estiver bloqueada.

A melhoria é exclusiva da nova comissão e garante que o bloqueio seja respeitado pela integração com o Avendre Pay.

Por que isso é importante?

Anteriormente, mesmo com o bloqueio ativado no CV CRM, o Avendre Pay ainda poderia realizar o repasse do valor ao comissionado.

Com o ajuste, o bloqueio passa a ter efeito real na etapa de liberação financeira, garantindo maior controle sobre os pagamentos de comissão.

Como funciona?

Ao bloquear uma linha de pagamento da comissão:

• O valor correspondente não será liberado nem repassado ao comissionado;
• O bloqueio terá prioridade sobre as regras de liberação configuradas, como regras baseadas em quantidade de dias;
• A restrição será aplicada somente na etapa final de repasse.

Importante: o bloqueio não impede a geração do boleto nem seu envio à pagadoria. Ele atua exclusivamente sobre a liberação e o repasse do valor ao comissionado.

Benefícios

• Bloqueio efetivo dos repasses de comissão;
• Maior controle sobre a liberação de valores;
• Respeito às restrições configuradas no CV CRM;
• Prevenção de pagamentos indevidos;
• Mais segurança e previsibilidade na operação com o Avendre Pay.

O cálculo de comprometimento de renda foi aprimorado em dois pontos: a localização da configuração e a forma como as parcelas são consideradas no cálculo.

• Configuração: o parâmetro de comprometimento de renda passa a fazer parte das regras de aprovação, tanto no empreendimento quanto na tabela de preço.
• Cálculo: as parcelas passam a ser consideradas conforme suas periodicidades e datas de vencimento, evitando somar valores de períodos diferentes como se fossem cobrados simultaneamente.

Por que isso é importante?

A melhoria torna o cálculo mais coerente com o fluxo real de pagamentos da proposta, evitando que o comprometimento de renda seja calculado acima do valor efetivamente previsto para um mesmo período.

Além disso, centralizar a configuração nas regras de aprovação facilita o gerenciamento dos critérios utilizados na análise.

Como funciona?

1. Configuração nas regras de aprovação

A configuração do cálculo será transferida para as regras de aprovação do empreendimento e da tabela de preço, contemplando tanto a tela nova quanto a tela antiga de regras.

2. Cálculo conforme vencimentos das parcelas

O sistema passa a distinguir as séries considerando seus períodos de cobrança, sem somar parcelas que não ocorrem simultaneamente.

Exemplo:

No cálculo anterior, todos os valores eram somados, totalizando R$ 1.255,00.

Com a melhoria, são consideradas as parcelas que coexistem no mesmo período. Até março de 2027, por exemplo, o comprometimento calculado será de R$ 655,00 (R$ 550,00 + R$ 105,00).

Benefícios

• Cálculo de comprometimento de renda mais preciso;
• Redução de distorções causadas por parcelas de períodos diferentes;
• Maior coerência na análise financeira das propostas;
• Configuração centralizada nas regras de aprovação;
• Preservação das configurações existentes durante a migração.

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 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.

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.

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.