> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/como-construir-processos/como-criar-formularios/como-utilizar-formulas-matematicas.md).

# Como utilizar fórmulas matemáticas

## Visão geral

O formulário eletrônico do Zeev permite incluir fórmulas em campos para realizar automaticamente cálculos matemáticos sem a necessidade de programação. 

A fórmula do cálculo considera os identificadores preenchidos em outros campos do formulário e exibe o resultado da operação. Podem ser realizadas operações de **soma (+)**, **subtração (-)**, **multiplicação (\*)** e **divisão (/)** para campos numéricos ou decimais/valor monetário.

{% hint style="warning" %}
**Importante**: para os cálculos serem realizados é necessário:

* Que os campos estejam habilitados ou manipuláveis no formulário! Caso o campo não possa ter seu valor modificado, então, configure na aba "Programação" o uso do atributo "readonly".
* No corpo da fórmula, utilizar o identificador do campo e não o seu nome amigável.
  {% endhint %}

### Exemplo de fórmula simples

A fórmula deve ser adicionada no campo que receberá o resultado do cálculo:

* O campo "Valor total" possui a seguinte fórmula: **quantidade** \* **valorUnitario**

Nesse exemplo, a **Quantidade** é multiplicada pelo **Valor unitário** e o resultado é preenchido no campo "**Valor total**".

![Exemplo da fórmula de multiplicação](/files/yrxWf7bRUoq2iGgFtKLh)

Construa a fórmula matemática nas configurações do campo: 

<figure><img src="/files/c7MiCsIpK8lhKeUdfb0v" alt=""><figcaption></figcaption></figure>

### Exemplos de fórmulas em tabelas multivaloradas

* Soma (**SUM**): soma os valores de uma coluna:&#x20;
  * Ex: SUM(quantidade);
* Média (**AVG**): obtém a média dos valores de uma coluna:
  * Ex: AVG(quantidade);
* Valor máximo (**MAX**): obtém o maior valor de uma coluna:
  * Ex: MAX(nota);
* Valor mínimo (**MIN**): obtém o menor valor de uma coluna:&#x20;
  * Ex: MIN(nota);
* Contagem (**COUNT**): apresenta a contagem da quantidade de registros (linhas) de uma determinada coluna:&#x20;
  * Ex: COUNT(inscritos).

No exemplo abaixo, o campo "Valor total da compra" possui a fórmula **SUM(valorTotal),** e recebe a soma dos valores preenchidos na coluna "Valor total".

![Soma dos valores de uma coluna](/files/vwmFjqhYhDwARWj5A5Bx)

### Exemplos de fórmulas combinadas

Também é possível combinar fórmulas e utilizar parênteses para realizar cálculos mais complexos.

* Combinar operações básicas

  * Ex: **(quantidade \* valorUnitario) - desconto**

* Combinar fórmulas de tabela:
  * Ex: **SUM(valorTotal) - SUM(custoTotal) - SUM(impostos)**<br>

* Combinar fórmulas simples e de tabela:
  * Ex: **(custoFixo + SUM(custoDeProducao)) / COUNT(item)**

{% hint style="info" %}
Não é possível realizar cálculos com datas através das fórmulas matemáticas. Para o cálculo com datas, recomendamos o uso das tarefa de regras de negócio. Veja mais [**clicando aqui**](https://kb.stoque.com.br/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/o-que-e-atividade-de-regra-de-negocio/outras-operacoes-da-tarefa-de-regra-de-negocio#calculo-com-datas).
{% endhint %}