Por que isso é importante?
Garante consistência de permissões, permitindo controlar se corretor e imobiliária podem ou não aprovar/reprovar documentos no pré-cadastro.

Como funciona?
Foi adicionada a permissão “Alterar  situação dos documentos” no workflow de pré-cadastros para os perfis de corretor e imobiliária.

Regras de funcionamento:

• Por padrão, a permissão vem habilitada. Não alterando o funcionamento atual.
• Quando habilitada, corretor e imobiliária podem aprovar ou reprovar documentos normalmente.
• Quando desabilitada, esses perfis deixam de ter essa ação disponível no pré-cadastro.
• Essa permissão já existia porém apenas para gestor e correspondente.

Por que isso é importante?
Permite maior escala e flexibilidade na captação de leads, possibilitando gerenciar múltiplas contas do Facebook e centralizar as integrações em um único sistema.

Como funciona?
Agora é possível conectar múltiplas contas do Facebook na integração de leads.

Regras de funcionamento:

• O gestor visualiza por padrão apenas as contas que ele conectou.
• Existe uma permissão de perfil que permite visualizar todas as contas conectadas.
• Há um limite padrão de até 10 contas conectadas simultaneamente.
• Esse limite pode ser ajustado via configurações comerciais.

Permissão de perfil para visualizar todas as contas conectadas: 

Caso não libere, verá apenas as suas próprias contas conectadas. 

Por que isso é importante?

Permite que integrações executem ações em nome de diferentes usuários e painéis, garantindo mais controle, consistência nas regras e rastreabilidade das operações.

Como funciona?
Foram adicionados dois novos parâmetros opcionais nas APIs de pré-cadastro: id_usuario e painel.

Esses parâmetros estão disponíveis nos seguintes endpoints:

• Mensagens do pré-cadastro:https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/precadastros/mensagens
• Documentos do pré-cadastro:https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/precadastro/documentos
• Aprovar/Reprovar documentos:https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/precadastro/aprovar-reprovar-documentos
• Edição de pré-cadastro (PUT):https://{dominiodocliente}.cvcrm.com.br/api/v1/comercial/precadastro/[idPrecadastroOuCodigoInterno]

Regras de funcionamento:

• Caso nenhum dos parâmetros seja informado, a API considera automaticamente o usuário autenticado que está realizando a requisição.
• Caso ambos os parâmetros sejam informados, a ação será executada no contexto do usuário (id_usuario) e do painel (painel) definidos.
• Caso apenas um dos parâmetros seja informado, a requisição será considerada inválida e não será processada.

Com isso, integrações passam a ter controle explícito sobre o contexto da operação, mantendo compatibilidade com o comportamento atual quando os parâmetros não são utilizados.

Agora, ao gerar uma comissão a partir da reserva, o sistema passa a criar automaticamente as linhas de pagamento, independentemente da configuração de retirada ou não do subtotal.

Por que isso é importante?

Antes, quando a regra estava configurada para não retirar do subtotal, a comissão era criada, mas sem as linhas de pagamento, exigindo lançamento manual pelo time financeiro.

Com a melhoria:

• Reduzimos esforço operacional
• Eliminamos etapas manuais
• Evitamos erros no lançamento das comissões

Como funciona?

• Ao gerar uma comissão (via reserva):
  • O sistema cria automaticamente as linhas de pagamento
• Esse comportamento ocorre:
  • Independentemente de a comissão estar dentro ou fora do contrato
  • Independentemente da regra de subtotal

Impacto na operação

• Automatização do processo financeiro
• Redução de retrabalho
• Maior consistência nos dados de pagamento
• Agilidade no fluxo de comissões

Por que isso é importante?
Garante segurança e confidencialidade das informações dos clientes, evitando exposição indevida de documentos entre corretores diferentes. Além disso, resolve um problema real do processo comercial do cliente, onde dados sensíveis estavam sendo compartilhados sem controle, o que pode gerar riscos legais e quebra de confiança. 

Também padroniza o comportamento entre workflows (pré-cadastro e reservas), reduzindo inconsistências no produto.

Como funciona?
Foi criada a permissão "Importar documentos da pessoa" dentro do workflow de pré-cadastro.

• Quando habilitada, o usuário pode importar documentos já existentes de outros pré-cadastros vinculados ao mesmo cliente.
• Quando desabilitada, não irá aparecer o botão de importar documentos.
  Isso dá controle direto ao cliente sobre quem pode reutilizar documentos e evita o compartilhamento indevido de informações confidenciais.
• Por padrão a permissão virá liberada nos clientes para evitar conflitos na forma como já é utilizado. 

Por que isso é importante?

Permite que sistemas externos sejam notificados em tempo real sempre que um correspondente é associado a um pré-cadastro, garantindo sincronização automática de dados, redução de processos manuais e maior agilidade no fluxo operacional entre plataformas integradas.

Como funciona?
Foi criado um novo gatilho de webhook chamado "Associar correspondente". Sempre que um pré-cadastro receber a associação de uma empresa correspondente ou de um usuário correspondente, o sistema irá disparar automaticamente o webhook (caso esteja configurado), enviando os dados atualizados do pré-cadastro para a URL definida.

O envio de credores para o ERP Sienge agora permite configurar o valor do campo paymentTypeId, deixando de utilizar um valor fixo.

Por que isso é importante?

Antes, o sistema enviava o paymentTypeId = 2 por padrão. Embora funcionasse na maioria dos cenários, isso causava falhas em ambientes onde esse ID não existia ou foi removido.

Com a parametrização:

• A integração se adapta à realidade de cada cliente
• Evita bloqueios no cadastro de credores
• Elimina a necessidade de ajustes manuais (ex.: via Postman)

Como funciona?

Novo campo configurável

Foi criada uma configuração para definir o valor do paymentTypeId utilizado no envio de credores.

Caminho: .../gestor/configuracoes/integrações/sienge

Comportamento da integração

• O sistema passa a utilizar o valor configurado para paymentTypeId
• O envio respeita a estrutura existente no Sienge de cada cliente
• Caso necessário, o valor pode ser ajustado sem alteração de código

Impacto na operação

• Maior flexibilidade na integração
• Redução de erros no envio de credores
• Eliminação de dependência de valores fixos
• Menor necessidade de intervenção técnica

Pré-requisitos

• Integração ativa com o ERP Sienge
• Configuração do paymentTypeId conforme cadastro existente no ERP

O envio de reservas para o ERP Informakon agora passa a ser realizado com base na flag “Pode Faturar”, eliminando a dependência do processamento via cron a cada 5 minutos.

Por que isso é importante?

A melhoria traz dois ganhos principais:

• Envio instantâneo da reserva, sem necessidade de aguardar o cron
• Possibilidade de reenvio direto pela aplicação, sem depender de intervenção técnica

Antes, usuários precisavam abrir chamados para solicitar reenvio de reservas já enviadas, o que gerava atraso e sobrecarga operacional.

Como funciona agora?

• Ao passar pela flag “Pode Faturar”:
  • A reserva é enviada imediatamente para o ERP
• Caso necessário:
  • O usuário pode realizar o reenvio da reserva diretamente pelo sistema. Por exemplo, ao corrigir um dado na proposta, basta voltar a reserva para a etapa anterior e passar de novo pelo 'Pode Faturar'

Pré-requisitos

• Integração ativa com o ERP
• Utilização da flag “Pode Faturar” no fluxo de reserva

Agora é possível permitir que imobiliárias e corretores visualizem o checklist e as instruções das etapas no fluxo de comissões, por meio de uma configuração no workflow.

Por que isso é importante?

Antes, essas informações eram visíveis apenas para usuários com perfil de gestor, o que gerava:

• Falta de clareza sobre o andamento da comissão
• Dificuldade para entender próximos passos
• Erros ou atrasos em ações obrigatórias (ex.: envio de NF)
• Aumento de dúvidas e dependência de suporte

Com a melhoria, os participantes do processo passam a ter mais autonomia e entendimento do fluxo.

Como funciona?

Nova configuração no Workflow de Comissão

Foi criada uma configuração que permite ao gestor definir a visibilidade:

WF de Comissão → “Exibir checklist e instruções para imobiliárias/corretores”

Comportamento da configuração

Quando ativado

• Checklist visível para imobiliárias e corretores
• Instruções das etapas visíveis
• Usuários conseguem entender:
  • O que já foi realizado
  • O que ainda está pendente
  • Motivo da comissão estar na etapa atual
  • Próximos passos do processo

Quando desativado (padrão)

• Visibilidade mantida apenas para gestores
• Comportamento atual preservado

Pré-requisitos

• Workflow de Comissão configurado
• Permissão de acesso aos perfis envolvidos
• Configuração de visibilidade habilitada pelo gestor

Interface

• Checklist e instruções exibidos nas etapas da comissão

A API de Reservas passa a retornar o campo “Tipo de Reserva” nos endpoints de consulta, ampliando as informações disponíveis para integrações.

Por que isso é importante?

O campo já existia na interface do sistema, mas não estava disponível na API, limitando o uso completo das informações por sistemas externos.

Com essa melhoria, integrações passam a ter acesso ao tipo da reserva, permitindo maior consistência entre o CRM e aplicações integradas.

Como funciona?

Consulta de reservas (GET)

• O campo “Tipo de Reserva” passa a ser retornado nos endpoints de consulta
• Disponível junto aos demais dados da reserva

Pré-requisitos

• Consumo da API de Reservas
• (Opcional) Ajuste nas integrações para utilização do novo campo