1536 Avaliacao Expressoes

Área de Ferramentas

O recurso Avaliação de Expressões permite cadastrar regras de cálculo e condições utilizadas em diferentes rotinas do Touch ERP. Um avaliador reúne as fórmulas, as condições que determinam quando utilizá-las e os valores necessários ao cálculo.

Acesso: Ferramentas > TI > Configurações > Avaliação de Expressões — recurso 1536.

Quando utilizar

Utilize um avaliador quando precisar definir cálculos ou critérios personalizados para uma rotina que aceite esse tipo de configuração, como:

Formação de preços em tabelas dinâmicas.
Análise e bloqueio de pedidos e itens de pedido.
Ajustes em documentos fiscais próprios ou de terceiros.
Análise de preço de venda e precificação de produtos.
Apuração de contratos de locação.

Cadastrar e salvar o avaliador não o vincula automaticamente a todas essas rotinas. Depois do cadastro, selecione-o na configuração ou no cadastro que irá utilizá-lo. As variáveis disponíveis e o significado do resultado dependem da rotina escolhida.

Como a avaliação funciona

Na avaliação de um conjunto de fórmulas, o sistema:

Calcula as pré-fórmulas, quando houver.
Percorre as fórmulas na ordem cadastrada.
Verifica a Condição de aplicação de cada fórmula ativa.
Ao encontrar a primeira condição verdadeira, calcula a respectiva Fórmula e devolve seu resultado.

A primeira condição verdadeira encerra a escolha. As fórmulas seguintes não são somadas ao resultado nem executadas como uma continuação desse cálculo.

Por isso, coloque regras específicas antes das regras gerais. A condição 1 é sempre verdadeira: se utilizada como alternativa geral, deve ficar por último.

Como cadastrar um avaliador

Acesse o recurso e inicie um novo cadastro.
Informe uma Descrição que identifique a finalidade da regra, por exemplo, Precificação de produtos — embalagens.
Em Opções específicas, selecione o contexto no qual o avaliador será utilizado.
Consulte as variáveis disponibilizadas por esse contexto na aba Variáveis/Constantes.
Na aba Fórmulas, adicione pelo menos uma linha e informe sua descrição.
Selecione a linha e preencha os campos Condição de aplicação e Fórmula apresentados abaixo da grade.
Se necessário, cadastre constantes, variáveis adicionais e pré-fórmulas.
Registre na aba Observação o objetivo da regra e as premissas do cálculo.
Confira a ordem das fórmulas e salve.
Vincule o avaliador à rotina correspondente e confira o resultado com um caso conhecido.

Ao editar várias fórmulas, selecione na grade a linha que deseja alterar antes de modificar os campos abaixo dela.

Opções específicas: escolha do contexto

O contexto define quais informações a rotina pode fornecer para as expressões. Os nomes das opções disponíveis podem variar conforme a configuração do sistema.

Contexto	Finalidade e recursos relacionados
Variáveis Tabela Dinâmica	Cálculos utilizados pela Tabela de Preços Dinâmica.
Variáveis para análise Pedido/Item Pedido	Regras de análise e bloqueio de pedidos, conforme a Configuração de Avaliação de Pedidos.
Variáveis para ajustes de Documentos Próprios	Ajustes relacionados a notas fiscais próprias, conforme a Configuração de Ajuste de Documentos Fiscais.
Variáveis para ajustes de Documentos Terceiros	Ajustes relacionados a notas fiscais de terceiros, conforme a Configuração de Ajuste de Documentos Fiscais.
Variáveis Análise Preço Venda	Precificação e análise de preços, utilizadas em recursos como Tabela de Preços Base, Pré-Tabela de Preços, Cotação de Vendas e Pedido de Clientes, conforme seus vínculos e configurações.
Apuração de contratos de locação	Cálculos utilizados na apuração de contratos de locação.

Ao trocar Opções específicas, a tela pode solicitar confirmação para carregar condições e variáveis predefinidas. Leia o aviso antes de confirmar e revise as referências utilizadas nas expressões: uma variável disponível no contexto anterior pode não existir no novo contexto.

Aba Fórmulas

Cada linha representa uma regra que poderá fornecer o resultado da avaliação.

Campo	Como utilizar
Índice	Indica a posição da regra na lista. Confira se as condições específicas aparecem antes da condição geral.
Código	Identifica a fórmula quando utilizado pela configuração do sistema. Não é o valor retornado pelo cálculo.
Descrição	Identifica a finalidade da fórmula. É obrigatória. Exemplo: `Preço para embalagens`.
Ativo	Indica a situação da fórmula. Na avaliação do conjunto, somente fórmulas ativas participam da escolha.
Condição de aplicação	Define quando utilizar a fórmula. É obrigatória. Exemplo: `@id_especie@ == 10`.
Fórmula	Expressão que produz o resultado quando a condição é verdadeira. É obrigatória.

Condição e cálculo têm funções diferentes

A Condição de aplicação responde se a regra deve ser utilizada. A Fórmula determina o resultado que será devolvido.

Exemplo de condição:

@id_especie@ == 10

Essa condição é verdadeira quando o identificador da espécie do produto é igual a 10. O número é um identificador do cadastro, e não o nome da espécie.

Para uma regra sem restrição, informe:

Uma condição verdadeira corresponde ao resultado 1. Não utilize um valor de preço ou um percentual isolado como substituto da condição.

Escrita das expressões

Escreva as referências a variáveis e constantes entre @, como em @VAR_IMPOSTOS@.
Utilize o seletor Variável junto ao campo para inserir uma referência predefinida. A referência é acrescentada ao final do texto; ajuste sua posição quando necessário.
Preserve a grafia das referências apresentadas pelo sistema e evite reutilizar o mesmo nome para origens diferentes.
Use +, -, * e / para adição, subtração, multiplicação e divisão.
Use parênteses para deixar a ordem do cálculo explícita.
Em números decimais digitados dentro da expressão, utilize ponto, como em 1.05. A vírgula separa argumentos de funções.
Para comparar igualdade em uma condição, utilize ==, como em @id_especie@ == 10.

Aba Variáveis/Constantes

Esta aba apresenta as referências predefinidas do contexto e os valores adicionais cadastrados para o avaliador.

Tipo de informação	Como funciona
Variável predefinida	É disponibilizada pela rotina escolhida em Opções específicas. Seu valor pode mudar a cada produto, pedido ou documento avaliado.
Constante	É um valor fixo informado no próprio avaliador, como um percentual de referência.
Variável adicional	Obtém um valor de uma origem e de um campo selecionados, quando o contexto permite essa configuração. A origem precisa estar disponível na rotina que executa a avaliação.

Como cadastrar uma constante

Clique em Constante.
Informe um nome que identifique o valor e confirme.
Na grade de constantes e variáveis cadastradas, informe o valor da constante.
Utilize o nome entre @ nas expressões.

Por exemplo, uma constante chamada PERC_REFERENCIA, com valor 10, pode ser utilizada assim:

@PERC_REFERENCIA@ / 100

O resultado é 0.10. A divisão por 100 é necessária nesse exemplo porque o valor foi informado como percentual inteiro.

Nome e valor são obrigatórios. Não cadastre duas constantes ou variáveis adicionais com o mesmo nome no avaliador.

Como cadastrar uma variável adicional

Quando o botão Variável estiver disponível:

Clique em Variável e informe o nome da referência.
Selecione a origem da informação.
Selecione o campo que fornecerá o valor.
Confirme e confira os dados de origem e campo apresentados na grade.
Utilize a referência em uma expressão e confira seu resultado na rotina de destino.

Se o botão estiver desabilitado, o contexto selecionado não permite adicionar esse tipo de variável. Utilize as referências disponibilizadas para ele.

Os valores utilizados nas expressões precisam ser compatíveis com um cálculo numérico. Não suponha que selecionar uma origem torna seus dados disponíveis em qualquer rotina.

Tabela de variáveis da análise de preço de venda

Na análise de preço de venda, as fórmulas também podem utilizar valores definidos na Análise Preço Venda — Tabela de Variáveis. Essa tabela é um cadastro separado da aba Variáveis/Constantes do avaliador.

Confira os nomes das chaves, seus valores e o vínculo do avaliador com a tabela utilizada na precificação. Cadastrar uma referência na fórmula não cria a variável nem preenche seu valor automaticamente.

Aba Pré-Fórmulas

As pré-fórmulas permitem calcular valores intermediários antes de avaliar as condições das fórmulas principais. Seu resultado pode ser utilizado em outras expressões pela chave cadastrada.

Adicione uma linha na aba Pré-Fórmulas.
Informe uma Descrição que explique o cálculo.
Informe uma Chave para identificar o resultado, sem os delimitadores @.
Selecione a linha e preencha sua Fórmula.
Nas expressões que utilizarão o resultado, escreva a chave entre @.

Exemplo de chave:

PERC_TOTAL

Exemplo de pré-fórmula:

@VAR_IMPOSTOS@ + @VAR_MARGEM_LUCRO@ + @VAR_INADIMPLENCIA@ + @VAR_MARGEM_CUSTEIO_VARIAVEL@

A fórmula principal pode utilizar esse resultado:

@vlr_custotab_pr_base@ * (100 / (100 - @PERC_TOTAL@))

Neste exemplo, as quatro variáveis de origem precisam estar disponíveis para o avaliador. Use chaves distintas das demais referências. Quando uma pré-fórmula depender de outra, confira se a dependência aparece antes dela na lista.

Como as pré-fórmulas são calculadas antes da escolha da fórmula principal, seus dados precisam estar disponíveis mesmo quando uma condição específica não for atendida.

Aba Observação

Utilize esta aba para registrar informações que facilitem a manutenção da regra, como:

Objetivo do avaliador e rotina na qual ele é utilizado.
Origem do custo, dos percentuais e das demais variáveis.
Motivo das condições e dos identificadores utilizados.
Exemplo de resultado esperado.

A observação documenta a regra; ela não participa do cálculo.

Exemplo completo: precificação de produtos

Este exemplo mantém a proposta da documentação anterior: calcular um preço de venda a partir do custo e de percentuais, com uma condição específica para embalagens.

Preparação

Considere, apenas para este exemplo:

O contexto de avaliação fornece id_especie e vlr_custotab_pr_base.
A espécie Embalagem possui identificador 10.
As variáveis de percentuais estão cadastradas na tabela de variáveis utilizada pela precificação e disponíveis para o avaliador.

Substitua o identificador e os valores pelos dados da sua empresa. Confirme a disponibilidade de cada referência no contexto escolhido.

Referência	Significado	Valor ilustrativo
`vlr_custotab_pr_base`	Custo utilizado pela tabela de preços base	60,00
`VAR_IMPOSTOS`	Percentual de impostos	10
`VAR_MARGEM_LUCRO`	Percentual de margem de lucro	20
`VAR_INADIMPLENCIA`	Percentual previsto para inadimplência	2
`VAR_MARGEM_CUSTEIO_VARIAVEL`	Percentual de custeio variável	8

Primeira fórmula: embalagens

Descrição: Preço de venda — embalagens.

Condição de aplicação:

@id_especie@ == 10

Fórmula:

@vlr_custotab_pr_base@ * (100 / (100 - (@VAR_IMPOSTOS@ + @VAR_MARGEM_LUCRO@ + @VAR_INADIMPLENCIA@ + @VAR_MARGEM_CUSTEIO_VARIAVEL@)))

Com os valores ilustrativos, o total dos percentuais é 40. O cálculo fica:

60 * (100 / (100 - 40)) = 100

O resultado esperado é 100,00. A fórmula considera os percentuais sobre o preço de venda; ela não equivale a acrescentar 40% ao custo.

Confira o denominador: neste modelo de cálculo, a soma dos percentuais deve ser menor que 100. Uma soma igual a 100 gera divisão por zero; acima de 100, o resultado deixa de representar a precificação pretendida neste exemplo.

Segunda fórmula: condição geral

Cadastre uma segunda fórmula, depois da regra de embalagens, para atender aos demais produtos quando essa for a política desejada.

Descrição: Preço de venda — demais produtos.

Condição de aplicação:

Fórmula:

@vlr_custotab_pr_base@ * (100 / (100 - (@VAR_IMPOSTOS@ + @VAR_MARGEM_LUCRO@ + @VAR_INADIMPLENCIA@ + @VAR_MARGEM_CUSTEIO_VARIAVEL@)))

Assim como no exemplo anterior da wiki, as duas regras apresentam o mesmo cálculo. Nesse caso, com os mesmos valores de entrada, seus resultados são iguais. Se embalagens e demais produtos tiverem políticas diferentes, ajuste as fórmulas ou os valores aplicáveis a cada caso.

Não coloque a condição geral antes da condição de embalagens. Como 1 é sempre verdadeiro, ela seria escolhida antes de verificar a espécie.

Arredondamento

Para arredondar um valor, utilize:

arredondar(valor, numero_casas_decimais)

Exemplo mantido da documentação anterior:

arredondar(15.369, 2)

Resultado esperado: 15,37.

Para arredondar a precificação a duas casas decimais, envolva todo o cálculo:

arredondar(@vlr_custotab_pr_base@ * (100 / (100 - (@VAR_IMPOSTOS@ + @VAR_MARGEM_LUCRO@ + @VAR_INADIMPLENCIA@ + @VAR_MARGEM_CUSTEIO_VARIAVEL@))), 2)

Como conferir antes de utilizar

Separe um produto, pedido ou documento com valores conhecidos.
Calcule manualmente o resultado esperado.
Execute a rotina que utiliza o avaliador e compare o resultado.
Confira um caso que atenda à condição específica e outro que utilize a condição geral.
Se houver pré-fórmulas, confira também seus valores intermediários.
Depois de uma alteração, repita a conferência nas rotinas que utilizam o mesmo avaliador.

Salvar o cadastro confirma o preenchimento das informações exigidas, mas não substitui a conferência do cálculo com os dados da rotina de destino.

Dúvidas e problemas frequentes

Situação	O que verificar
Não é possível salvar o avaliador	Preencha a descrição e adicione pelo menos uma fórmula. Cada fórmula precisa de descrição, condição de aplicação e expressão de cálculo.
Há uma mensagem de constante ou variável repetida	Confira os nomes cadastrados na aba Variáveis/Constantes e elimine a duplicidade, ajustando as referências utilizadas nas expressões.
A regra específica não é utilizada	Confira a ordem das fórmulas. Uma condição geral anterior pode estar sendo escolhida primeiro. Confira também os identificadores utilizados nas comparações.
Nenhuma condição é atendida	Revise as condições e os dados avaliados. Quando a rotina exigir um resultado, a ausência de uma condição aplicável pode gerar erro. Se a política permitir, inclua uma condição geral ao final.
O resultado é zero ou diferente do esperado	Confira os valores fornecidos pela rotina, as constantes, as chaves da tabela de variáveis, os percentuais e os parênteses. Não considere um resultado zero como prova de que todas as referências estão corretas.
A expressão apresenta erro de cálculo	Confira a sintaxe, os delimitadores `@`, a disponibilidade das referências, os separadores decimais e possíveis divisões por zero.
O botão Variável está desabilitado	Confira Opções específicas. Alguns contextos permitem somente as variáveis disponibilizadas pelo sistema.
O avaliador foi salvo, mas a rotina não o utiliza	Confira o vínculo na configuração da rotina e se o contexto escolhido é compatível com ela.
A exclusão não é permitida	A exclusão depende das permissões do usuário e das regras do cadastro. Avaliadores sem código positivo possuem restrição de exclusão. Solicite ao responsável pelo sistema a conferência do registro e de seus vínculos.