VISÃO GERAL

A TOTVS CRM evoluiu para incluir recursos que permitem o mapeamento de motivos de ganho e status de oportunidades, especificamente para criar regras de validação que restringem a ação de ganhar oportunidades. Esta melhoria aprimora o controle sobre o processo de conclusão de oportunidades, assegurando que todas as condições necessárias sejam atendidas antes de uma oportunidade ser registrada como ganha.

    OBJETIVO

O objetivo desse recurso é permitir a criação de regras de validação para restringir a ação de ganhar em oportunidades, aumentando o controle e assegurando a conformidade com as políticas internas da empresa.

  ANTES DE COMEÇAR

Requisitos

1. Permissões: É necessário ser administrador do sistema para configurar as regras.

  DETALHES FUNCIONAIS

1. Nova Camada de Validação:
   

   Incluímos uma nova camada de validação no status de uma oportunidade. Esta mudança permite que os usuários definam regras específicas para quando o status de uma oportunidade for "WON" (ganha). Estas regras devem ser atendidas antes que uma oportunidade possa ser oficialmente considerada como ganha.

   
   
   • Dados considerados para a regra:
     
     • Motivo do Ganho: winLossReason
     • Observação do Ganho: winLossNote
     • Status: status
     • Data de Conclusão: completedAt
     • Data de Início de Recorrência Vazia: wonWithEmptyRecurrenceStartDate

2. Manutenção das Validações Existentes
   Esta abordagem permite que sejam mantidas as validações hoje existentes, sem quebra. Isso significa que as novas regras e processos introduzidos não interferem nas operações já estabelecidas, mas trabalham em conjunto para melhorar a integridade e eficiência.

   
   

   Categoria	Validação
   Tabela de Preço	Verifica se a tabela de preço existe, está ativa e dentro do período de validade.
   	Impede alteração da tabela de preço se a oportunidade já tem itens associados.
   	A conta deve ter acesso à tabela de preço especificada.
   	Se a tabela é exclusiva para leads, apenas contas de leads podem utilizá-la.
   Forma de Pagamento	Confirma se a forma de pagamento existe e está ativa.
   	Checa se o módulo de vendas correspondente está contratado.
   	Verifica se está relacionada com a tabela de preços utilizada.
   Condição de Pagamento	Garante que a condição de pagamento exista e esteja ativa.
   	Verifica se o módulo do CRM para gerenciar condições de pagamento está ativo.
   	Confirma se a condição está relacionada com a tabela de preços.
   	Verifica se a condição de pagamento pode ser usada pela conta em questão.
   Empresa	Verifica se existe um relacionamento válido entre o cliente (ou lead) e a empresa selecionada.
   Status da Oportunidade	Confirma que o status da oportunidade está em progresso para permitir alterações.
   Etapa da Oportunidade	Garante que a etapa específica da oportunidade esteja ativa no sistema.
   Motivo de Perda/Ganho	Verifica se o motivo de perda ou ganho está ativo e é permitido.
   Data de Fechamento	Checa se a data de fechamento manual é permitida, e se a data inserida é válida.
   Endereço	Confirma se o endereço está ativo e corretamente vinculado à conta.
   Recorrência	Verifica se a data de início da recorrência foi preenchida corretamente.
   Desconto	Verifica se o desconto aplicado está dentro dos limites permitidos.

3. Atualização na Validação de Descarte
   O processo de descarte de oportunidade foi aprimorado para garantir que o processo de descarte seja mais alinhado com as políticas internas de segurança e governança de dados, minimizando erros e garantindo que apenas usuários com as devidas permissões possam efetuar mudanças significativas nas oportunidades.

   
   
4. Dados considerados para a regra:
   
   • Nota de Descarte: note
   • Status: status
   • Data de Descarte: discartedAt



Categoria	Descrição da Validação
Pipeline	Verifica se o status da oportunidade permite edição. Se o parâmetro "Permite edição de oportunidade fechada" está inativo e o status é diferente de "PROGRESS", retorna erro.
Etapa	Valida se a etapa destinada para descarte está ativa no pipeline da oportunidade.

4. Mover Etapa (Resumo e Pipeline)
   

   A ação de mover etapa permite atualizar o estágio de uma oportunidade dentro do fluxo de vendas. Essa mudança é tratada como uma atualização da oportunidade, e várias checagens são realizadas para assegurar que a mudança esteja alinhada com as regras do negócio.

   
   

   Grupadores	Validação
   Pipeline	Verifica se o status da oportunidade permite edição; se restrições estiverem ativas e o status não for "PROGRESS", ou se estiver "DISCARTED", retorna erro.
   Etapa	Verifica se a oportunidade está em progresso antes de permitir a alteração de etapas.
   Conta	Confirma se alterações na conta, empresa ou responsável são permitidas baseadas no status da oportunidade.
   Lead	Se houver atualização do lead, verifica sua existência, ativação e se o usuário responsável tem acesso.
   Cliente	Similar ao lead, verifica a validade e o acesso ao cliente atualizado.
   Tipo da Oportunidade	Verifica se o tipo de oportunidade atualizado existe e está ativo.
   Endereço	Confirma se o endereço atualizado está ativo, pertence à conta e se o usuário tem permissões adequadas.
   Câmbio	Verifica a existência e relevância das informações de câmbio, incluindo consistência da moeda.
   Tabela de Preço	Garante que a tabela de preços está ativa e não permite alterações se a oportunidade já tem itens associados.
   Forma de Pagamento	Verifica a existência e ativação da forma de pagamento e sua relação com a tabela de preços.
   Condição de Pagamento	Confirma a existência, ativação e relevância da condição de pagamento com a tabela de preços.
   Data Prevista	Checa se atualizações na data prevista seguem as políticas de permissão e se a data está coerente com as expectativas.
   Probabilidade	Verifica se ajustes na probabilidade são permitidos e se estão de acordo com as regras estabelecidas.
   Empresa	Verifica se mudanças na empresa estão alinhadas com as políticas e se a empresa está corretamente vinculada aos envolvidos na oportunidade.

5. Prorrogar (Tela de Resumo)
   

   Essa função no TOTVS CRM que permite aos usuários alterar a "Data prevista" de fechamento de uma oportunidade. Esta alteração é tratada como qualquer outra atualização no sistema, exigindo que todas as informações sejam completas e corretas.

   
   

   Categoria	Validação
   Pipeline	Verificar se o status da oportunidade permite edição; informar erro se a edição de oportunidades fechadas está desativada e o status não for "PROGRESS" ou se estiver "DISCARTED".
   Pipeline	Verificar se a oportunidade não está em progresso e se a pipeline foi alterada.
   Etapa	Verificar se a oportunidade não está em progresso e se a etapa foi alterada.
   Conta	Verificar mudanças na conta, empresa ou responsável, e se estas são permitidas com base no status da oportunidade.
   Lead	Se alterado, verificar se o lead existe, está ativo e se o usuário responsável tem acesso.
   Cliente	Se alterado, verificar se o cliente existe, está ativo e se o usuário responsável tem acesso.
   Pipeline	Se alterado, verificar se o pipeline existe e está ativo.
   Etapa	Se alterada, verificar se a etapa existe e está ativa, e se está vinculada a pipeline.
   Etapa	Se a etapa ou pipeline foi alterado, verificar se estão vinculados.
   Etapa	Se a etapa foi alterada, verificar se o usuário tem acesso à pipeline.
   Etapa	Se o pipeline selecionado deve ter permissão para o usuário, grupo de usuário, papel do usuário e empresa da oportunidade.
   Etapa	Se a etapa foi alterada, verificar se o parâmetro "Retornar etapa" está inativo e se a etapa foi alterada para uma etapa anterior.
   Responsável	Se alterado, verificar se o responsável existe, está ativo e tem papel preenchido.
   Responsável	Se alterado, verificar se pertence à hierarquia do usuário logado.
   Data Prevista	Se a data prevista foi alterada, verificar se o parâmetro "Permite atualização de data prevista" está ativo, e se a data foi alterada conforme as políticas.
   Data Prevista	Se a data prevista foi alterada, verificar se o parâmetro "Permite data prevista retroativa" está inativo, e se a data é maior ou igual à data de início.
   Empresa	Verificar se a empresa foi atualizada corretamente e se a oportunidade tem itens.
   Empresa	Verificar se o parâmetro "Empresa obrigatória" está ativo e se a empresa está vazia.
   Conta	Se a conta foi alterada, verificar se o usuário responsável tem acesso ao cliente selecionado.
   Contato	Se alterado, verificar se o contato existe, está ativo e está relacionado à conta selecionada na oportunidade.
   Câmbio	Verificar a existência e a consistência das informações de câmbio, incluindo a compatibilidade da moeda.
   Tabela de Preço	Verificar se a tabela de preços existe, está ativa e está dentro do período de validade.
   Tabela de Preço	Se a oportunidade já possui itens, verificar se não é possível alterar a tabela de preços.
   Tabela de Preço	Verificar se a conta selecionada tem acesso à tabela de preços especificada.
   Forma de Pagamento	Verificar se a forma de pagamento existe e está ativa.
   Forma de Pagamento	Verificar se a forma de pagamento está relacionada com a tabela de preços usada.
   Condição de Pagamento	Verificar se a condição de pagamento existe e está ativa.
   Endereço	Se alterado, verificar se o endereço existe, está ativo, pertence à conta e se o usuário tem permissão de acesso.
   Probabilidade	Verificar se ajustes manuais na probabilidade são permitidos e estão de acordo com as regras estabelecidas.

6. Definir Probabilidade
   

   Esta é uma alteração direta no campo "Probabilidade" dentro do registro da oportunidade, seguindo um processo de validação rigoroso para garantir que todas as alterações sejam corretas e autorizadas.

   
   

   Categoria	Validação
   Pipeline	Verificar se o status da oportunidade permite edição; se o parâmetro "Permite edição de oportunidade fechada" está inativo e o status da oportunidade for diferente de "PROGRESS", ou se a oportunidade for "DISCARTED", deve informar erro.
   Pipeline	Verificar se a oportunidade não está em progresso e a pipeline foi alterada.
   Etapa	Verificar se a oportunidade não está em progresso e se a etapa foi alterada.
   Conta	Verificar se mudanças na conta, empresa ou responsável são permitidas com base no status atual da oportunidade.
   Lead	Se o Lead for alterado, verificar se existe, está ativo, e se o usuário responsável tem acesso.
   Cliente	Se o Customer for alterado, verificar se existe, está ativo, e se o usuário responsável tem acesso.
   Pipeline	Se o pipeline for alterado, verificar se existe e está ativo.
   Etapa	Se a etapa for alterada, verificar se existe e está ativa, e se está vinculada ao pipeline.
   Etapa	Se a etapa ou pipeline for alterado, verificar se estão vinculados.
   Etapa	Se a etapa for alterada, verificar se o usuário tem acesso à pipeline.
   Etapa	Se o pipeline selecionado deve ter permissão para o usuário, grupo de usuário, papel do usuário, e empresa da oportunidade.
   Etapa	Se a etapa for alterada, verificar se o parâmetro "Retornar etapa" está inativo e se a etapa foi alterada para uma etapa anterior.
   Responsável	Se o responsável for alterado, verificar se existe, está ativo e tem papel preenchido.
   Responsável	Se o responsável foi alterado, verificar se pertence à hierarquia do usuário logado.
   Data Prevista	Se a data prevista foi alterada, verificar se o parâmetro "Permite atualização de data prevista" está ativo, e se a data foi alterada conforme as políticas.
   Data Prevista	Se a data prevista foi alterada, verificar se o parâmetro "Permite data prevista retroativa" está inativo, e se a data é maior ou igual à data de início.
   Empresa	Verificar se a empresa foi atualizada, e se a oportunidade tem itens.
   Empresa	Verificar se o parâmetro "Empresa obrigatória" está ativo e se a empresa está vazia.
   Conta	Se a conta foi alterada, verificar se o usuário responsável tem acesso ao cliente selecionado.
   Contato	Se o contato foi alterado, verificar se o contato existe, está ativo e está relacionado à conta selecionada na oportunidade.
   Câmbio	Verificar a existência e a consistência das informações de câmbio.
   Tabela de Preço	Verificar se a tabela de preços existe, está ativa e está dentro do período de validade.
   Tabela de Preço	Se a oportunidade já possui itens, verificar se não é possível alterar a tabela de preços.
   Tabela de Preço	Verificar se a conta selecionada tem acesso à tabela de preços especificada.
   Forma de Pagamento	Verificar se a forma de pagamento existe e está ativa.
   Forma de Pagamento	Verificar se a forma de pagamento está relacionada com a tabela de preços usada.
   Condição de Pagamento	Verificar se a condição de pagamento existe e está ativa.
   Endereço	Se alterado, verificar se o endereço existe, está ativo, pertence à conta e se o usuário tem permissão de acesso.
   Probabilidade	Verificar se o parâmetro "Bloquear ajuste manual da probabilidade" está ativo. Se estiver e a probabilidade for informada, exibir erro.

7. Ação Salvar
   A funcionalidade é projetada para verificar uma série de condições antes de permitir que as alterações sejam efetivamente salvas no sistema. Aqui está a tabela completa de validações que ocorrem quando um usuário tenta salvar uma oportunidade:

Categoria	Validação
Pipeline	Verificar se o status da oportunidade permite edição. Se o parâmetro "Permite edição de oportunidade fechada" estiver inativo e o status não for "PROGRESS", ou se a oportunidade estiver "DISCARTED", deve informar erro.
Pipeline	Verificar se a oportunidade não está em progresso e se a pipeline foi alterada.
Etapa	Verificar se a etapa da oportunidade foi alterada e não está em progresso.
Conta	Verificar se mudanças na conta, empresa ou responsável são permitidas com base no status atual da oportunidade.
Lead	Se o lead for alterado, verificar se ele existe, está ativo, e se o usuário responsável tem acesso.
Cliente	Se o cliente for alterado, verificar se ele existe, está ativo, e se o usuário responsável tem acesso.
Pipeline	Se o pipeline for alterado, verificar se ele existe e está ativo.
Etapa	Se a etapa for alterada, verificar se ela existe, está ativa, e se está vinculada ao pipeline.
Etapa	Se a etapa ou pipeline foi alterado, verificar se estão vinculados corretamente.
Etapa	Se a etapa for alterada, verificar se o usuário tem acesso ao pipeline.
Etapa	Verificar se o pipeline selecionado tem permissão para o usuário, grupo de usuário, papel do usuário, e empresa da oportunidade.
Etapa	Se a etapa for alterada, verificar se o parâmetro "Retornar etapa" está inativo e se a etapa foi alterada para uma etapa anterior.
Responsável	Se o responsável for alterado, verificar se ele existe, está ativo, e tem papel preenchido.
Responsável	Se o responsável foi alterado, verificar se ele pertence à hierarquia do usuário logado.
Data Prevista	Se a data prevista foi alterada, verificar se a atualização é permitida e se a nova data está em conformidade com as políticas.
Empresa	Verificar se a empresa foi atualizada corretamente e se a oportunidade tem itens associados.
Empresa	Verificar se o parâmetro "Empresa obrigatória" está ativo e se a empresa está preenchida corretamente.
Conta	Se a conta foi alterada, verificar se o usuário responsável tem acesso ao cliente selecionado.
Contato	Se o contato foi alterado, verificar se ele existe, está ativo, e está relacionado à conta selecionada na oportunidade.
Câmbio	Verificar a existência e a consistência das informações de câmbio, e se estão de acordo com a moeda da oportunidade.
Tabela de Preço	Verificar se a tabela de preços existe, está ativa, e se está dentro do período de validade.
Tabela de Preço	Se a oportunidade já possui itens, verificar se a tabela de preços pode ser alterada.
Forma de Pagamento	Verificar se a forma de pagamento existe, está ativa, e está relacionada com a tabela de preços usada.
Condição de Pagamento	Verificar se a condição de pagamento existe e está ativa, e se está relacionada com a tabela de preços.
Endereço	Se o endereço foi alterado, verificar se ele existe, está ativo, pertence à conta e se o usuário tem permissão de acesso.
Probabilidade	Verificar se ajustes manuais na probabilidade são permitidos e se estão em conformidade com as regras estabelecidas.

8. Mapeamento de Atributos para Ações
   Para utilizar uma mesma API em diversas ações como ganho, perda, descarte, recuperação e reabertura de oportunidades, os seguintes atributos são mapeados no módulo de personalização. Isso permite a aplicação de regras de validação personalizadas conforme o status da oportunidade:

• Dados considerados para a regra:
  
  • expectedAt (Data esperada para fechamento)
  • wonWithEmptyRecurrenceStartDate (Data de início de recorrência para oportunidades ganhas sem recorrência prevista)
  • pipeline (Pipeline ao qual a oportunidade está associada)
  • stage (Etapa atual da oportunidade no pipeline)
  • discardedAt (Data em que a oportunidade foi descartada)

  COMO USAR?

1. Acessar o Menu Personalização:

   • Inicie sessão no TOTVS CRM.
   • Navegue até a seção 'Personalização' no menu principal.
   • Escolha 'Objetos' e depois selecione 'Opportunities'.
   • Acesse a aba 'Regras' para adicionar ou modificar as regras de validação.
   • Salve as alterações realizadas e verifique se estão funcionando corretamente ao modificar ou criar oportunidades.

 EXEMPLO PRÁTICO

Desafio Antigo:

Falta de controle automatizado que permita a verificação de condições específicas antes de uma oportunidade ser marcada como ganha.

Com a nova camada de validação, o sistema agora garante que todas as condições necessárias sejam verificadas automaticamente, reduzindo o risco de erros e garantindo a integridade do processo de gestão de oportunidades.