🔹 O que é?
A API que retorna os contratos assinados por assinatura eletrônica de uma reserva passou a devolver também o link de acesso ao documento assinado, no índice link_contrato_assinado. A melhoria é voltada para quem utiliza o DocuSign como plataforma de assinatura eletrônica.

🔹 Por que é importante?
Antes, quem consumia a API sabia que o contrato havia sido assinado, mas precisava entrar na plataforma de assinatura ou no CV para chegar até o documento. Agora o link vem junto na própria resposta, permitindo que sistemas integrados acessem, armazenem ou disponibilizem o contrato assinado automaticamente, sem etapa manual no meio do caminho.

🔹 Como funciona?

• Faça a chamada no endpoint api/v3/comercial/reservas/{idreserva}/contratos-assinados, informando o ID da reserva.
• A resposta traz os contratos assinados por assinatura eletrônica daquela reserva e, para cada um, o índice link_contrato_assinado.
• O índice vem preenchido apenas para contratos assinados via DocuSign. Para as demais plataformas de assinatura eletrônica, o campo é retornado vazio.
  
  OBS: para os 3 serviços de assinatura temos como baixar o documento assinado, para Clicksign e CV Sign é no link da API, para o Docusign tem uma diferença pois é fornecido pela integração o certificado e o contrato assinado de forma separada e por isso, foi adicionado essa melhoria. 

🔹 O que é?
As variáveis extras do tipo moeda — criadas recentemente no sistema — agora geram automaticamente duas variáveis de contrato: uma com o valor informado no campo e outra com esse mesmo valor por extenso.

🔹 Por que é importante?
Contratos costumam exigir que valores monetários apareçam em algarismos e por extenso. Antes, esse texto precisava ser escrito manualmente, o que abria espaço para erro de digitação e divergência em relação ao valor real. Agora o extenso é gerado a partir do próprio valor da variável, mantendo os dois formatos sempre iguais.

🔹 Como funciona?

• Em Contratos > Criar Variáveis, cadastre a nova variável escolhendo o tipo Moeda.
• Ao salvar, o sistema disponibiliza automaticamente duas variáveis na lista de variáveis do contrato:
  • [[EXTRAS][NOME_DA_VARIAVEL]] — traz o valor informado no campo.
  • [[EXTRAS][NOME_DA_VARIAVEL_EXTENSO]] — traz esse mesmo valor escrito por extenso.
• No editor do contrato, clique na variável desejada para inseri-la no texto. Você pode usar as duas juntas, no formato usual de contratos (valor seguido do extenso).

Agora é possível controlar, por perfil de acesso, quem pode abrir assistência técnica em áreas comuns e em localidades pelo Painel Gestor.

O que foi entregue:

• Duas novas permissões no perfil de acesso: uma para abertura em áreas comuns e outra para localidades
• Bloqueio automático da abertura em área comum quando a permissão estiver desmarcada no perfil
• Solicitações originadas pelo cliente passam a ter escopo restrito à unidade dele

Como configurar:

1. Acesse o cadastro de Perfis de acesso no Painel Gestor
2. Localize as permissões de abertura de assistência em áreas comuns e localidades
3. Desmarque as permissões nos perfis que não devem ter essa autonomia

Por que isso importa:

• Garante que a abertura em área comum aconteça somente quando houver respaldo formal do síndico, evitando chamados sem legitimidade
• Reduz retrabalho da equipe de assistência com solicitações abertas fora do escopo correto
• Deixa claro o limite de atuação de cada perfil, diminuindo divergência entre o que o cliente solicita e o que a construtora atende

Nas bases já existentes, os perfis seguem com a permissão liberada — o comportamento atual não muda. O bloqueio só passa a valer quando você desmarcar a permissão no perfil.

O que foi feito:
O endpoint PUT de assistência passou a aceitar o envio de campos adicionais (customizados) diretamente no payload da requisição, bastando informar o ID do campo adicional e o valor correspondente. Antes, a atualização desses campos exigia uma chamada separada; agora ela pode ser feita na mesma requisição de atualização da assistência.

Por que é importante para o produto:
Reduz o número de chamadas necessárias para manter a assistência atualizada, simplifica a integração para clientes que usam campos customizados no fluxo de atendimento/assistência técnica, e elimina risco de inconsistência entre a atualização da assistência e a dos seus campos adicionais (que antes podiam ficar dessincronizados por serem chamadas separadas).

Nova configuração que permite ocultar os campos de descrição e de anexo de arquivos no cadastro da assistência.

O que foi entregue:
- Flag de configuração para ocultar os campos de descrição e arquivos no formulário de abertura da assistência
- Com a flag ativa, os dois campos deixam de ser exibidos, e a abertura segue apenas com as informações restantes do cadastro
- Os demais campos do formulário continuam funcionando normalmente

Por que isso importa:
- Operações que padronizam a abertura pela seleção do item não precisam mais de um campo livre que só gera texto solto para triar depois
- Menos campos no formulário reduz a desistência no meio da abertura, especialmente quando o cliente acessa pelo celular
- Evita o recebimento de anexos irrelevantes ou pesados em fluxos onde o registro visual é feito na vistoria, não na abertura
- Quem usa descrição e anexos como parte da triagem continua com tudo como está hoje

A configuração é opcional e não altera assistências já abertas. Enquanto não for ativada, o formulário segue exibindo todos os campos.

Nova configuração que restringe a assistência a um único item, tanto no Portal do Cliente quanto no Painel Gestor.

O que foi entregue:
- Flag de configuração que limita a assistência a 1 item
- Com a flag ativa, depois que o primeiro item é adicionado, a opção de incluir novo item deixa de ser exibida
- A regra vale nos dois pontos de abertura: Portal do Cliente e Painel Gestor

Por que isso importa:
- Operações que tratam cada problema como um chamado próprio param de receber assistências com vários itens misturados, o que atrapalha SLA, responsável e histórico
- Um item por assistência elimina a ambiguidade de garantia: não existe mais o caso de um chamado com itens dentro e fora do prazo ao mesmo tempo
- O bloqueio acontece na própria tela, então o cliente e o atendente não precisam saber a regra de cabeça

A configuração é opcional. Enquanto não for ativada, a abertura de assistência continua aceitando múltiplos itens como hoje.

O Workflow de Assistência ganhou duas novas flags, "Dentro da Garantia" e "Fora de Garantia", que direcionam a assistência automaticamente para a situação correta no momento da criação.

O que foi entregue:
- Flag "Dentro da Garantia": assistências criadas com item dentro do prazo de garantia são alocadas na situação onde a flag estiver
- Flag "Fora de Garantia": assistências criadas com item fora do prazo são migradas para a situação onde a flag estiver
- Quando a assistência tem mais de um item e pelo menos um está fora de garantia, ela é direcionada para a situação de fora de garantia

Como configurar:
1. Acesse as configurações do Workflow de Assistência Técnica
2. Aloque a flag "Dentro da Garantia" na situação que deve receber esses chamados
3. Repita o passo para a flag "Fora de Garantia" na situação correspondente

Por que isso importa:
- A triagem de garantia deixa de ser manual, eliminando a etapa em que alguém precisa conferir o prazo do item e mover o chamado
- Reduz o risco de uma assistência fora de garantia seguir o fluxo de atendimento coberto, com custo indevido para a construtora
- Cada situação passa a refletir de fato o tipo de tratativa, o que melhora a leitura dos indicadores do workflow
- O direcionamento acontece na criação, então o chamado já nasce na fila certa

As flags só passam a valer nas situações em que forem alocadas. Enquanto não forem configuradas, o workflow segue funcionando exatamente como hoje.

Agora é possível ocultar o identificador do item no Portal do Cliente por configuração, além do rótulo do campo ter ficado mais claro.

O que mudou:
- O campo passou a ser identificado como "ID Item", em vez de aparecer apenas como número
- A flag já vem habilitada, mantendo o comportamento atual para quem não fizer nada

Por que isso importa:
- O identificador interno não faz sentido para o cliente final e só polui a tela em operações que não usam esse número como referência
- Quem usa o identificador para se comunicar com o cliente continua com ele visível, sem precisar mudar nada
- O rótulo "ID Item" elimina a dúvida sobre a que aquele número se refere quando o cliente aciona o atendimento

Nenhuma ação é necessária para manter o comportamento atual. A configuração é por cliente e não altera nada em outras telas.

Agora é possível configurar se o boleto da parcela de ato será gerado automaticamente durante a aprovação da condição de pagamento da reserva.

Foi adicionada uma nova configuração na integração com o Sienge, permitindo que cada empreendimento defina o comportamento mais adequado ao seu processo.

Por que isso é importante?

Até então, o CV CRM gerava automaticamente o boleto da parcela de ato ao aprovar a condição de pagamento da reserva.

Para clientes que também utilizam a ação de workflow "Gerar boleto para parcela ato (Sienge)", esse comportamento resultava na emissão de boletos em duplicidade, já que o mesmo boleto era gerado automaticamente e novamente em uma etapa posterior do fluxo.

Com a nova configuração, esse comportamento passa a ser opcional.

Como funciona?

Foi criada uma nova configuração na integração do empreendimento:

Gerar boleto para parcela ato (Sienge) na aprovação da reserva

• Sim (padrão): mantém o comportamento atual, gerando automaticamente o boleto durante a aprovação da reserva.
• Não: desabilita a geração automática. Nesse caso, a emissão do boleto ficará sob responsabilidade das ações configuradas no workflow ou de outro momento definido pelo processo da empresa.

OBS.: o recomendado é desabilitar essa configuração se a geração do boleto no Sienge já ocorre através de uma ação de workflow.

Pré-requisitos

• Integração com o ERP Sienge configurada
• Utilização da funcionalidade de geração de boleto de ato

Ao selecionar uma regra de comissão na reserva, o sistema passa a disponibilizar também as regras cadastradas na Configuração Padrão.

Antes, apenas as regras disponíveis na configuração do empreendimento da reserva eram apresentadas para seleção.

Por que isso é importante?

Muitas empresas mantêm regras de comissão padronizadas para utilização recorrente. Com essa melhoria, essas regras passam a ficar disponíveis diretamente na reserva, tornando o processo mais prático e evitando cadastros duplicados.

Além disso, a centralização das regras facilita sua reutilização e padroniza a operação comercial.