> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como criar variáveis personalizadas com fórmulas para propostas e documentos

As variáveis do Groner já trazem os números da proposta: valor total, potência, geração, economia e muitos outros. Quando você precisa de um número que não existe pronto, como o valor por kWp ou a economia em 10 anos, crie uma **variável personalizada** com uma fórmula. Depois é só usar a variável nos modelos de proposta e de documento.

---

## Onde fica

Vá em **Configurações > Sistema & Desenvolvedor > Variáveis personalizadas**. A tabela mostra cada variável com a **Chave**, a **Expressão** e a **Descrição**. Clique na chave para copiar o código.

## Passo a passo

1. Clique em **Nova variável**.
2. Na coluna **Definição**, preencha:
   - **Nome:** um nome para você reconhecer a variável;
   - **Código:** o nome que vai no modelo. Se o código for `ValorPorKwp`, no modelo você escreve `[[ValorPorKwp]]`;
   - **Descrição:** para que serve;
   - **Fórmula:** o cálculo, usando as variáveis que já existem.
3. Para montar a fórmula, use a coluna **Variável disponível**: pesquise a variável e clique ou arraste para a fórmula.
4. Na coluna **Testar expressão**, digite um valor de teste para cada variável usada e confira o **Resultado**.
5. Clique em **Adicionar** (ao editar uma variável, o botão é **Salvar**).

## Como escrever a fórmula

- Use as variáveis entre colchetes duplos, como `[[PrecoSimulacao]]`.
- Use `+`, `-`, `*` e `/`, e parênteses para a ordem das contas.
- Os números seguem o **formato americano**: ponto para as casas decimais (`1.5`, e não `1,5`).
- Também dá para usar funções matemáticas, como `Round(x, 2)`, `Max(a, b)`, `Min(a, b)`, `Abs(x)` e `if(condição, valor1, valor2)`.
- Uma variável personalizada pode usar outra dentro da fórmula.

O resultado sai com 2 casas decimais.

Exemplo, para o preço por kWp:

`[[PrecoSimulacao]] / [[kwPSimulacao]]`

> **Dica:** confira o nome exato das variáveis na coluna **Variável disponível**. Um nome escrito errado faz a fórmula não calcular.

## Usar a variável

No modelo de proposta ou de documento, escreva o código entre colchetes duplos, por exemplo `[[ValorPorKwp]]`. Na hora de gerar, o Groner calcula a fórmula com os números daquela proposta.

Se a fórmula não conseguir calcular (por exemplo, por causa de um nome de variável escrito errado), o valor sai como 0,00. Se aparecer 0,00, confira os nomes das variáveis da fórmula.

Veja também [Principais variáveis](https://ajuda.groner.app/pt-br/article/principais-variaveis-1ltaanz/) e [Onde usar as variáveis](https://ajuda.groner.app/pt-br/article/onde-usar-as-variaveis-p8cars/).

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [O que são Variáveis](https://ajuda.groner.app/pt-br/article/o-que-sao-variaveis-19g45cs/)
- [Principais Variáveis](https://ajuda.groner.app/pt-br/article/principais-variaveis-1ltaanz/)
- [Onde usar as Variáveis](https://ajuda.groner.app/pt-br/article/onde-usar-as-variaveis-p8cars/)
- [Como os números aparecem nas variáveis dos modelos de documento](https://ajuda.groner.app/pt-br/article/como-os-numeros-aparecem-nas-variaveis-dos-modelos-de-documento-1xpd8p0/)

<!-- groner-suporte:veja-tambem:fim -->