Ver código fonte para 1609 Analise Preco Venda Tabela Variaveis

[[Area_Ferramentas]] / [[Modulo_Vendas_Precificacao]]
{{DISPLAYTITLE:1609 — Análise Preço Venda — Tabela de Variáveis}}

[[Area_Ferramentas|Área de Ferramentas]] / [[Modulo_Vendas_Precificacao|Precificação]]

O recurso '''Análise Preço Venda — Tabela de Variáveis''' reúne valores utilizados nas fórmulas de precificação, como percentuais de impostos, margem de lucro, inadimplência e custeio variável.

Você pode cadastrar diferentes tabelas para representar políticas comerciais e combinar essas tabelas com avaliadores de expressões compatíveis. Assim, uma fórmula pode ser reutilizada com conjuntos diferentes de valores.

'''Acesso:''' Cadastros > Mercado / Suprimentos > Tabelas de Preços > Análise Preço Venda — Tabela de Variáveis — recurso '''1609'''.

__TOC__

== Entenda a relação entre tabela e avaliador ==

{| class="wikitable"
! Informação
! Onde é definida
! Exemplo
|-
| Como calcular
| No [[1536_Avaliacao_Expressoes|Avaliador de Expressões]].
| Fórmula que calcula o preço de venda a partir do custo e dos percentuais.
|-
| Quais valores utilizar
| Nas linhas da tabela de variáveis deste recurso.
| <code>VAR_MARGEM_LUCRO</code> com valor <code>10</code>.
|-
| Quais avaliadores estão associados à tabela
| Na aba '''Avaliadores''' deste recurso.
| Avaliador de precificação que utiliza os percentuais da tabela.
|-
| Qual combinação utilizar em uma análise
| No cenário ou na configuração da rotina de precificação.
| Avaliador selecionado junto com a tabela de variáveis correspondente.
|}

'''Salvar uma tabela não recalcula automaticamente todos os preços.''' Para aplicar seus valores, confira a tabela selecionada na rotina de destino e execute o cálculo ou a atualização correspondente.

== Como cadastrar uma tabela de variáveis ==

# Acesse o recurso e inicie um novo cadastro.
# Informe uma '''Descrição''' que identifique a finalidade da tabela. Exemplo: <code>Lucro Líquido 10%</code>.
# Na aba '''Variáveis''', adicione uma linha para cada parâmetro utilizado pela fórmula.
# Preencha a '''Descrição''', a '''Chave''' e o '''Valor''' de cada variável.
# Na aba '''Avaliadores''', adicione os avaliadores de expressões associados à tabela.
# Confira se as chaves correspondem às referências utilizadas nas fórmulas e salve.
# Na análise ou configuração de precificação, selecione a combinação de avaliador e tabela e confira o resultado do cálculo.

Para alterar um cadastro, localize a tabela na listagem, abra o registro, ajuste os dados e salve novamente.

== Descrição da tabela ==

A descrição identifica o conjunto de valores. Ela é obrigatória e permite até '''300 caracteres'''.

Prefira nomes que ajudem a distinguir as políticas utilizadas, por exemplo:

* <code>Lucro Líquido 10%</code>.
* <code>Lucro Líquido 15%</code>.
* <code>Precificação — política comercial padrão</code>.

O texto da descrição não define o cálculo. Uma tabela chamada “Lucro Líquido 10%” somente utilizará esse percentual se a variável correspondente estiver preenchida corretamente e a fórmula a utilizar.

== Aba Variáveis ==

Cada linha disponibiliza um valor numérico para as expressões de precificação.

{| class="wikitable"
! Campo
! Como utilizar
|-
| Descrição
| Explique o significado do parâmetro. Exemplo: <code>Margem de lucro</code>.
|-
| Chave
| Nome utilizado para encontrar o valor na fórmula. É obrigatória em todas as linhas. Exemplo: <code>VAR_MARGEM_LUCRO</code>.
|-
| Valor
| Valor numérico do parâmetro. Seu significado depende da fórmula: pode representar um percentual, um valor monetário ou outro fator de cálculo.
|-
| Avaliador de expressões
| Campo opcional destinado ao cálculo reverso da variável em cenários com preço informado manualmente. Veja a seção específica abaixo.
|}

Utilize a inclusão e a remoção de linhas da grade para manter os parâmetros necessários. O cadastro precisa conter '''pelo menos uma variável'''.

=== Como escrever as chaves ===

Na tabela, informe a chave sem os delimitadores <code>@</code>:

<pre>VAR_MARGEM_LUCRO</pre>

Na fórmula do avaliador, utilize essa mesma chave entre <code>@</code>:

<pre>@VAR_MARGEM_LUCRO@</pre>

Mantenha a grafia exatamente igual, inclusive maiúsculas e minúsculas. Não acrescente espaços antes ou depois do nome.

As chaves não devem coincidir com referências já fornecidas pelo sistema. Utilize um prefixo, como <code>VAR_</code>, para identificar seus parâmetros. Confira também os nomes das constantes e das pré-fórmulas do avaliador para evitar conflitos.

Adote uma chave diferente para cada parâmetro dentro da tabela. Repetir a mesma chave torna ambíguo qual valor deve participar do cálculo.

=== Como informar percentuais ===

O formato depende da expressão utilizada. Na fórmula de exemplo desta página, os percentuais são informados como números inteiros:

* Para 10%, informe <code>10</code>.
* Para 2%, informe <code>2</code>.
* Para 0,5%, informe o valor numérico correspondente a meio por cento, conforme o formato do campo.

Não informe <code>0,10</code> para representar 10% nessa fórmula, pois isso corresponderia a 0,10%. A chave, por si só, não converte o valor em percentual.

== Aba Avaliadores ==

Nesta aba, informe os avaliadores de expressões associados à tabela.

# Adicione uma linha na grade.
# Pesquise e selecione o '''Avaliador de expressões'''.
# Repita a inclusão para os demais avaliadores que utilizarão a tabela.
# Salve o cadastro.

Os avaliadores selecionados precisam ser do tipo '''Análise Preço Venda''', definido em '''Opções específicas''' no recurso [[1536_Avaliacao_Expressoes|1536 — Avaliação de Expressões]]. O mesmo avaliador não pode ser incluído duas vezes na aba.

Esse vínculo é utilizado na busca de tabelas associadas a um avaliador na análise de preços. Se a tabela não aparecer nessa busca, confira se o avaliador desejado está incluído aqui.

Para desfazer uma associação, remova a linha correspondente e salve. Isso remove o vínculo com a tabela; não exclui o cadastro do avaliador.

== Avaliador na linha da variável: cálculo reverso ==

O '''Avaliador de expressões''' da aba Variáveis tem uma finalidade diferente dos vínculos da aba Avaliadores.

No cálculo normal, o avaliador do cenário utiliza os valores da tabela para encontrar o preço de venda. Quando o cenário está configurado para '''informar o preço manualmente''', o avaliador da linha permite calcular uma variável a partir desse preço — por exemplo, descobrir a margem de lucro resultante.

{| class="wikitable"
! Configuração
! Finalidade
|-
| Aba Avaliadores
| Associar a tabela aos avaliadores que a utilizam na análise de preços.
|-
| Avaliador na linha de uma variável
| Calcular o valor dessa variável no cenário manual, mediante uma fórmula de cálculo reverso.
|}

Para utilizar o cálculo reverso:

# Cadastre um avaliador do tipo '''Análise Preço Venda''' com uma fórmula que devolva o valor da variável desejada.
# Selecione esse avaliador na linha da variável que deverá receber o resultado, como <code>VAR_MARGEM_LUCRO</code>.
# Na análise de preço de venda, selecione a tabela, informe o preço manual e execute o cálculo do cenário.
# Confira o valor apurado para a variável no cenário.

'''Configure apenas uma variável de destino para esse uso na tabela.''' No processamento atual do cenário manual, é utilizada a primeira variável encontrada com avaliador informado; não há cálculo reverso de todas as linhas preenchidas.

O resultado é apurado no cenário. Esse processamento não substitui automaticamente o valor padrão salvo neste cadastro de tabela de variáveis.

Se você utiliza somente o cálculo normal de preço de venda, pode deixar o avaliador da linha em branco. Os vínculos da aba Avaliadores não preenchem esse campo automaticamente.

== Exemplo: tabela “Lucro Líquido 10%” ==

O exemplo abaixo preserva a expressão apresentada na documentação anterior, acrescentando valores para conferir o resultado.

=== Fórmula utilizada no avaliador ===

No [[1536_Avaliacao_Expressoes|Avaliador de Expressões]], considere a fórmula:

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

A referência <code>vlr_custotab_pr_base</code> representa o custo fornecido pela rotina de precificação. As quatro referências com prefixo <code>VAR_</code> serão cadastradas na tabela de variáveis.

Não crie uma linha chamada <code>vlr_custotab_pr_base</code> apenas para repetir esse custo: confira sua origem na rotina e preserve as referências do sistema.

=== Valores da tabela ===

Informe a descrição <code>Lucro Líquido 10%</code> e cadastre:

{| class="wikitable"
! Descrição
! Chave
! Valor ilustrativo
|-
| Impostos
| <code>VAR_IMPOSTOS</code>
| 10
|-
| Margem de lucro
| <code>VAR_MARGEM_LUCRO</code>
| 10
|-
| Inadimplência
| <code>VAR_INADIMPLENCIA</code>
| 2
|-
| Margem de custeio variável
| <code>VAR_MARGEM_CUSTEIO_VARIAVEL</code>
| 8
|}

Na aba '''Avaliadores''', inclua o avaliador que contém a expressão. Como este exemplo trata do cálculo normal, deixe em branco o avaliador de cada linha de variável.

=== Conferência do resultado ===

Supondo um custo de '''70,00''', a soma dos percentuais é:

<pre>10 + 10 + 2 + 8 = 30</pre>

O preço calculado será:

<pre>70 * (100 / (100 - 30)) = 100</pre>

O resultado esperado é '''100,00'''. Nesse modelo, os percentuais incidem sobre o preço de venda. Portanto, o cálculo não equivale a acrescentar 30% ao custo.

'''Os valores são ilustrativos.''' A tabela não determina quais percentuais sua empresa deve utilizar; informe os parâmetros definidos para sua política de precificação.

Nesta expressão, 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 no exemplo.

=== Comparação entre políticas ===

Você pode cadastrar outra tabela com as mesmas chaves e alterar os valores para comparar cenários. Por exemplo, uma tabela <code>Lucro Líquido 15%</code> pode utilizar <code>15</code> em <code>VAR_MARGEM_LUCRO</code>, preservando os demais percentuais do exemplo.

Nesse caso, a soma será 35 e, para o mesmo custo de 70,00, o resultado será aproximadamente '''107,69'''. Confira as regras de arredondamento da fórmula e da rotina utilizada.

A nova tabela precisa ser selecionada no cenário ou na configuração que deverá utilizá-la. A descrição da tabela não faz essa seleção automaticamente.

== Como revisar ou remover informações ==

Antes de alterar valores, confira quais avaliadores e cenários utilizam a tabela. Uma mudança pode afetar os próximos cálculos que consultarem esses parâmetros.

* '''Alterar um percentual:''' ajuste o Valor da linha e salve; depois confira o cálculo na rotina correspondente.
* '''Renomear uma chave:''' ajuste também as fórmulas e pré-fórmulas que utilizam a referência antiga.
* '''Remover uma variável:''' confira antes se alguma expressão ainda depende dela. Deve permanecer pelo menos uma variável para salvar a tabela.
* '''Remover um avaliador vinculado:''' exclua sua linha na aba Avaliadores e salve.

Quando a intenção for comparar uma nova política com a anterior, prefira manter tabelas identificadas separadamente, em vez de alterar os parâmetros sem distinguir sua finalidade.

== Dúvidas e problemas frequentes ==

{| class="wikitable"
! Situação
! O que verificar
|-
| O sistema solicita a descrição
| Preencha a descrição da tabela.
|-
| O sistema solicita a tabela de variáveis
| Adicione pelo menos uma linha na aba Variáveis.
|-
| O sistema solicita a chave das variáveis
| Confira se todas as linhas possuem Chave preenchida. Não basta informar somente a descrição.
|-
| O avaliador selecionado não é aceito
| Confira se ele é do tipo Análise Preço Venda no recurso 1536, tanto para vínculos quanto para o avaliador da linha.
|-
| O sistema informa avaliador vinculado em duplicidade
| Mantenha apenas uma linha para cada avaliador na aba Avaliadores.
|-
| O sistema solicita o avaliador vinculado
| Preencha a seleção da linha adicionada na aba Avaliadores ou remova a linha vazia.
|-
| A tabela não aparece na busca por avaliador
| Confira os vínculos da aba Avaliadores e se o cadastro foi salvo.
|-
| O valor calculado é diferente do esperado
| Confira a tabela selecionada, as chaves, os valores, a fórmula e o custo fornecido pela rotina. Verifique também se o cenário possui valores próprios para as mesmas variáveis, pois eles podem substituir os valores da tabela no cálculo.
|-
| Alterei a tabela e o preço permaneceu igual
| Confira se a rotina utiliza essa tabela, se há valores específicos no cenário e se o cálculo ou a atualização de preços foi executado novamente.
|-
| O cálculo reverso não apura a variável esperada
| Confira se o cenário está com preço manual, qual linha possui avaliador informado e se a fórmula desse avaliador devolve a variável desejada. Não confunda esse campo com os vínculos da aba Avaliadores.
|}

== Recursos relacionados ==

* [[1536_Avaliacao_Expressoes|1536 — Avaliação de Expressões]].
* [[177_Tabela_Precos_Base|177 — Tabela de Preços Base]].
* [[1363_Pre_Tabela_Precos|1363 — Pré-Tabela de Preços]].
* [[199_Cotacao_Vendas|199 — Cotação de Vendas]].
* [[1180_Pedido_Clientes|1180 — Pedido de Clientes]].