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

A edição em lote de pagamentos de comissão foi ajustada para que os pagamentos selecionados sejam agrupados sob o mesmo identificador, permitindo a geração de um único boleto quando aplicável.

Por que isso é importante?

Em alguns cenários, ao corrigir pagamentos por meio da edição em lote — especialmente quando as datas originais estavam retroativas — o sistema criava novos pagamentos com IDs diferentes.

Como consequência:

• Os pagamentos eram separados em lotes distintos
• Eram gerados múltiplos boletos
• O processo financeiro ficava mais complexo e sujeito a retrabalho

Com a melhoria, os pagamentos editados em conjunto permanecem agrupados, seguindo a lógica esperada pela operação.

Ao realizar uma edição em lote de pagamentos:

• Todos os pagamentos selecionados passam a receber o mesmo identificador de agrupamento
• Os pagamentos permanecem vinculados ao mesmo lote
• A geração ocorre em um único boleto, quando aplicável

Regra importante

O agrupamento será realizado apenas quando a comissão estiver configurada para trabalhar com boletos por data de pagamento.

Caso a configuração da comissão utilize outro modelo de geração de boletos, o comportamento atual será mantido.

Impacto na operação

• Redução da geração indevida de múltiplos boletos
• Maior consistência no agrupamento financeiro
• Menos retrabalho para equipes financeiras
• Melhor aderência às regras operacionais da pagadoria
  
  

Pré-requisitos

• Utilização da funcionalidade de edição em lote de pagamentos
• Comissão configurada para boletos por data de pagamento
• Pagamentos selecionados para atualização em conjunto

Agora é possível configurar níveis hierárquicos nos times de atendimento. Você define um time N1 (primeiro contato) e um time N2 (apoio/escalonamento), vinculados por assunto. O sistema distribui os chamados seguindo a ordem configurada, com tempo máximo de resposta por nível. Quando necessário, o N1 encaminha o chamado ao N2 e o N2 pode devolvê-lo ao N1 para continuidade com o cliente.

Como funciona

1. Configure os times N1 e N2 e vincule-os aos assuntos desejados.
2. Defina o tempo máximo de resposta para cada nível.
3. O chamado chega ao N1. Se ele precisar escalonar, utiliza o botão de encaminhamento — o responsável é atualizado automaticamente para um integrante do N2.
4. O N2 conduz o atendimento e, se necessário, devolve ao N1 para encerrar com o cliente.

Por que ela é importante:

Equipes com múltiplos perfis de atendimento precisam de um fluxo claro de escalonamento. Sem isso, chamados complexos ficam presos no primeiro atendente ou são transferidos de forma manual e desorganizada. Com os níveis configurados, o roteamento acontece de forma estruturada, o responsável pelo chamado é atualizado automaticamente e o histórico se mantém, reduzindo retrabalho e melhorando a experiência do cliente.

Agora, ao iniciar uma simulação por uma unidade que já possui espaço complementar associado, o sistema realizará a associação automaticamente.

Por que isso é importante?

Antes da melhoria, o usuário precisava adicionar manualmente o espaço complementar durante a simulação, mesmo quando ele já estava vinculado à unidade.

Com a automação:

• Reduzimos retrabalho operacional
• Padronizamos o comportamento com o fluxo de reserva
• Tornamos a experiência mais rápida e consistente

Como funciona?

• Ao iniciar uma simulação através de uma unidade:
  • O sistema verifica se existe um espaço complementar associado
• Caso exista:
  • O espaço complementar será carregado automaticamente na simulação
• Obs.: Só haverá o vínculo automático na ocasião de ter apenas um espaço para a unidade.
  
  Pré-requisitos
• Unidade com espaço complementar previamente associado
• Início da simulação a partir da unidade vinculada

🔹 O que é? A consulta de Campos Adicionais, que antes estava disponível apenas na CVDW, agora também está presente nas APIs gerais do CV CRM

🔹 Por que é importante? Quem integra com as APIs do CV passa a ter acesso aos Campos Adicionais sem precisar recorrer à CVDW. Tudo no mesmo ecossistema, seguindo o mesmo padrão de autenticação e estrutura já utilizados nas demais APIs do produto.

🔹 Como funciona? A API retorna uma listagem paginada de todos os campos adicionais cadastrados no sistema, com suporte a filtros e ordenação. A autenticação segue o padrão já utilizado nas APIs do CV, via Bearer Token ou JWT.

Todos os detalhes de parâmetros e exemplos de requisição estão disponíveis na documentação: https://desenvolvedor.cvcrm.com.br/reference/listarcamposadicionaisv4

🔹 O que é? Quando um usuário de imobiliária possui um corretor vinculado diretamente a ele, agora os Mapas de Disponibilidade e de Reservas passam a respeitar esse vínculo — exibindo apenas os dados da unidade, sem expor informações de cliente ou de outros corretores.

🔹 Por que é importante? Sem essa restrição, um usuário de imobiliária conseguia ver detalhes de negociações de colegas — como cliente e corretor envolvidos — mesmo sem fazer parte daquela operação. A melhoria garante que cada usuário veja apenas o que é relevante para o seu trabalho, evitando conflitos e preservando a privacidade das negociações em andamento.

🔹 Como funciona? O comportamento se aplica aos mapas que o usuário de imobiliária tem acesso:

• Mapa de Disponibilidade e Mapa de Reservas: ao acessar uma unidade fora do seu vínculo, são exibidas apenas as informações da unidade — sem dados de cliente ou corretor.
• Mapas de Comissões e Repasses: sem alteração, pois o usuário de imobiliária não possui permissão de acesso a esses mapas.

Quem tem o corretor vinculado e faz parte da negociação continua visualizando tudo normalmente, sem nenhuma mudança na sua experiência.

Visualização do usuário imobiliária no painel quando há vínculo com o corretor da reserva:

Visualização do usuário imobiliária no painel quando não há vínculo com o corretor da reserva:

🔹 O que é? Agora o Log de Acessos também registra os acessos realizados pelo aplicativo nos painéis Gestor, Imobiliária, Corretor e Correspondente. Antes, apenas o painel Cliente tinha esse controle no app.

🔹 Por que é importante? Ter o histórico completo de quem acessou e quando é fundamental para auditorias, segurança e acompanhamento de uso. Com essa melhoria, gestores e administradores passam a ter visibilidade total sobre os acessos via app — não só dos clientes, mas de todos os perfis que operam no sistema.

🔹 Como funciona? Nenhuma configuração adicional é necessária. A partir desta atualização, todo acesso feito pelo aplicativo nos painéis Gestor, Imobiliária, Corretor e Correspondente passa a ser registrado automaticamente no relatório de Log de Acessos, da mesma forma que já acontecia com o painel Cliente.

O fluxo de abertura de assistência técnica foi atualizado. O cadastro agora é feito em etapas guiadas — Cliente → Tipo de Assistência → Itens e Subitens → Confirmação — tornando o processo mais claro e reduzindo erros de preenchimento.

O que mudou:

A principal novidade está na categorização do problema. Antes, o registro era genérico. Agora é possível indicar com precisão o Ambiente, Item, Subitem e Problema de forma hierárquica, chegando até a Patologia quando aplicável. Isso vale para o cadastro tanto pelo painel do gestor quanto pelo painel do cliente.

Por que é importante:

Registros mais estruturados significam diagnósticos mais rápidos, menos idas e vindas entre suporte e cliente, e dados mais confiáveis para análise de recorrência. O fluxo guiado também reduz o abandono do formulário e erros por campos preenchidos incorretamente.

⚙️ Disponível apenas para bases com a configuração habilitada. Para ativar, acesse as configurações específicas do ambiente. Caso de duvida falar com o time de suporte