Personalização avançada: criando variáveis para propostas doc

Neste tutorial, você vai aprender como criar variáveis customizadas, que são variáveis personalizadas para usar nos seus modelos de proposta dentro da plataforma SolarMarket.

Antes de mais nada, é importante você saber que na SolarMarket existem variáveis nativas (as já existentes, que você não precisa criar, editar ou cadastrar, como nome do cliente, que é uma variável nativa puxada pela chave [cliente_nome]); e as variáveis customizadas, que são justamente variáveis personalizadas, campos que você pode adicionar aos seus modelos de proposta para inserir informações específicas de forma automática, que não existam entre as nativas, como por exemplo garantia de acordo com cada fabricante de módulo, formas de pagamento via cartão de crédito. 

Como acessar nossas chaves nativas?

Acesse: Configurações → Proposta Comercial → Variáveis Disponíveis

Existem diversas variáveis nativas, como para os dados inseridos para o dimensionamento de propostas em Entrada de Dados; potência do sistema, informações quanto a módulo e inversor, que são apresentadas em Sistema Solar. Se preferir, acesse o tutorial Quais são e como utilizar as chaves nativas da plataforma?

 

Criando uma variável customizada

Na mesma página de Variáveis Disponíveis, um pouco mais para o final da página você encontrará a opção de cadastrar e editar as variáveis customizadas. Para isso, acesse as configurações:

• No menu lateral, clique em Configurações (ícone de engrenagem).
• Depois, vá até a seção Variáveis Customizadas.
• Role até o final da página para visualizar a área de criação e edição dessas variáveis.
• Clique no botão Nova variável customizada.

Quando estiver cadastrando uma nova variável você precisará inserir alguns dados:

• Título: o nome da variável. 💡 Dica: Use nomes fáceis de entender para facilitar o uso futuro

• Chave: como por exemplopreco_do_sistema. Esse valor será usado entre colchetes nas fórmulas e automações: [preco_do_sistema].

  • IF (SE)

  • AND, OR, SWITCH

  • Operadores matemáticos: + (soma), - (subtração), * (multiplicação), / (divisão)

    Expressão: Fórmula que define o valor da variável.

    Você pode usar fórmulas semelhantes às do Excel (em inglês), como:

    ⚠️ Não use fórmulas para matrizes (como ARRAYFORMULA).

    • Caso de uso 1: "Desejo calcular quanto o cliente teria de salvo após 25 anos se investisse o valor do projeto em uma aplicação que rende 10% a.a"

         Expressão: [preco]*(1+0.1)^25

    • Caso de uso 2: "Desejo escrever na proposta comercial o texto "Parabéns! Essa é uma excelente economia.' caso a economia do cliente seja maior ou igual a 90%"Expressão: IF([economia_mensal_porcentagem]>=0.9;"Parabéns! Essa é uma excelente economia.";"")
  • / (divisão),

• Precisão decimal (caso se aplique): Caso não se aplique, selecione a opção "Nenhuma casa decimal"
• Após preencher tudo, clique no botão Salvar, sua variável estará pronta para ser utilizada.

❓ Problemas comuns e como resolver

• Mensagem de erro por erro na expressão:
  → Essa mensagem pode aparecer por muitos motivos:

  • Uso de variáveis nativas:
    Se você estiver usando variáveis do sistema (como [preco], [economia_mensal]), verifique se:
    • Os nomes estão digitados corretamente (sem erros de digitação).
    • Os colchetes [ e ] foram usados corretamente, abrindo e fechando.
  • Fórmulas com IF, AND, etc.:
    Se estiver usando fórmulas do tipo IF, SWITCH, AND, etc., verifique se:
    • Todos os parênteses estão balanceados (ou seja, para cada ( existe um ) correspondente).

    • Se for imputar números decimais, use ponto (.) em vez de vírgula (,). Assim em vez de imputar "0,25", digite "0.25"

• Mensagem de erro na chave:
  

            → A chave é um identificador técnico da variável, e precisa seguir regras específicas:

• • Não use espaços: Em vez disso, utilize underline (_).

    Exemplo válido: valor_total, economia_cliente

  • Evite caracteres especiais ou acentos: Não use ç, ã, @, !, #, ou outros símbolos ou pontuações.

• Botão de salvar não habilita:
  → Caso o botão de salvar não fique azul, se mantendo em cinza, verifique os campos preenchidos. Todos os 4 campos devem estar preenchidos.

🎥 Veja essa explicação visual no vídeo abaixo: