Ver código fonte para Smart Component Execucao/SC 54 Smart Precificacao Automatica

[[Smart_Component_Execucao]]

O smart '''Precificação Automática por Notas de Entrada''' identifica produtos comprados nas notas fiscais de entrada e gera uma '''Pré-Tabela de Preços Base''' com os preços calculados e a ação de precificação de cada item.

'''Componente:''' <code>SCExecPrecificacaoAutoNotasEntrada</code>.<br />
'''Tipo:''' Smart de execução.

O cálculo utiliza os critérios da configuração de precificação, as informações das tabelas base e, quando existentes, as regras específicas de precificação do produto.

'''Este smart gera a pré-tabela; a atualização das tabelas base ocorre no processo posterior de vinculação.''' Para automatizar essa aplicação, é necessário programar a data estimada da pré-tabela e manter em execução o smart de vinculação automática.

__TOC__

== Como funciona ==

# Busca os itens elegíveis de notas de entrada a partir da data base informada.
# Identifica os produtos, sem repetir o cálculo por cada ocorrência do mesmo produto nas notas da execução.
# Para cada tabela selecionada, verifica a presença do produto e consulta seu custo.
# Calcula os preços e os cenários de análise aplicáveis.
# Define a ação de cada item: '''Aplicar''', '''Aguarda revisão''' ou '''Não aplicar'''.
# Salva uma pré-tabela reunindo os resultados e os itens de nota considerados.
# Apresenta o resumo da execução e a identificação da pré-tabela gerada.

Quando não existem itens de nota novos, informa essa situação e não gera uma pré-tabela.

== Antes de configurar ==

Confira:

* A empresa responsável pela precificação.
* A configuração do serviço de precificação: empresas para busca das notas, tipo de custo, arredondamento, avaliadores e tolerâncias.
* As tabelas base que receberão os resultados e suas margens e percentuais.
* Os custos dos produtos.
* Os avaliadores de expressões e as tabelas de variáveis necessários às fórmulas.
* As informações específicas de precificação dos produtos, quando utilizadas.
* O perfil fiscal da tabela base, quando necessário aos cenários tributários.

Se desejar aplicar os preços automaticamente, confira também a execução do componente <code>SCExecVinculacaoPreTabelaPrecoBase</code>. A programação desse componente é independente da execução do smart de precificação.

== Parâmetros ==

Os nomes abaixo identificam os parâmetros na configuração do smart. Para selecionar empresa, configuração e tabelas, utilize os cadastros correspondentes.

{| class="wikitable"
! Parâmetro !! Preenchimento !! Comportamento
|-
| <code>P_ID_EMPRESA</code> || Obrigatório. Empresa. || Empresa utilizada no cálculo dos custos, na análise e na pré-tabela gerada.
|-
| <code>P_ID_CONFIG_PRECIFICACAO</code> || Obrigatório. Configuração de serviços de precificação. || Define os critérios utilizados na precificação, incluindo as empresas abrangidas pela busca de dados.
|-
| <code>P_DATA_BASE_AVALIACAO</code> || Obrigatório. Data base. || Considera entradas a partir dessa data, incluindo a própria data. Notas anteriores são ignoradas.
|-
| <code>P_ACAO_PADRAO</code> || Opcional. Vazio, 0, 1 ou 2. || Vazio utiliza a regra de tolerância. 0 = Não aplicar; 1 = Aplicar; 2 = Aguarda revisão. Quando preenchido, fixa a ação dos itens gerados em vez de decidir pela tolerância.
|-
| <code>P_IDS_TABELAS_PRECO</code> || Opcional. Seleção múltipla de tabelas base. || Limita a execução às tabelas informadas. Vazio utiliza as tabelas principais da empresa.
|-
| <code>P_INCLUIR_PRODUTOS_NOVOS</code> || Opcional. 0 = Não; 1 = Sim. Padrão: Não. || Permite gerar itens para produtos comprados que ainda não fazem parte da tabela base. Sua inclusão efetiva na tabela ocorre na aplicação da pré-tabela.
|-
| <code>P_SETAR_DATA_ESTIMADA</code> || Opcional. 0 = Não; 1 = Sim. Padrão: Não. || Quando Sim, preenche a data estimada para aplicação. Quando Não, deixa a programação para o usuário na pré-tabela.
|-
| <code>P_HORARIO_APLICACAO</code> || Opcional. Horário no formato HH:mm, por exemplo 18:30. || Utilizado somente quando o preenchimento da data estimada está habilitado. Programa a próxima ocorrência do horário. Vazio define a data estimada como o momento da execução.
|}

'''Deixar a ação padrão vazia é diferente de informar 0.''' Vazio permite que a tolerância decida a ação; 0 determina Não aplicar para os itens gerados.

== Quais notas são consideradas ==

São pesquisados itens com '''CFOP marcado como compra''', com produto associado e informações fiscais correspondentes, nas empresas abrangidas pela configuração:

* '''Notas de terceiros:''' considera a data de entrada.
* '''Notas próprias:''' considera notas autorizadas cuja natureza seja de faturamento de entrada, utilizando a data de entrada/saída.

A empresa informada no smart é a referência da precificação. A abrangência das empresas das notas é obtida da configuração de precificação; confira essa configuração quando houver mais de uma empresa.

O filtro utiliza a data de entrada, e não simplesmente a data de emissão da nota. Também não há exigência de que uma nota tenha sido emitida depois da última execução: a rotina verifica os itens ainda não vinculados a pré-tabelas dentro do período informado.

=== Controle de itens já considerados ===

O smart busca apenas itens de nota que '''ainda não estejam registrados em nenhuma pré-tabela'''. Esse controle considera o item da nota, não somente o produto.

Se o mesmo produto aparecer em uma nova nota elegível, essa nova entrada poderá provocar outra análise. Já o mesmo item de nota vinculado a uma pré-tabela não será buscado novamente por este smart.

'''Todos os itens de nota lidos são vinculados à pré-tabela gerada, inclusive os de produtos sem custo ou fora das tabelas selecionadas.''' Portanto:

* Corrigir o custo e executar novamente não garante a releitura da mesma entrada.
* Acrescentar outra tabela ao parâmetro não faz os itens já registrados serem automaticamente reprocessados para ela.
* Alterar a ação padrão em outra execução não modifica os itens da pré-tabela anterior.

Nessas situações, revise a pré-tabela existente e utilize o fluxo de recálculo ou inclusão de notas disponível na tela, conforme a necessidade.

== Como os preços são calculados ==

O produto é analisado em cada tabela selecionada. O custo é obtido pelo '''tipo de custo da configuração''', usando a empresa da precificação. A nota identifica os produtos a considerar; seu valor unitário não é necessariamente o custo utilizado pelo cálculo.

Para produtos já presentes na tabela, o sistema utiliza suas margens, comissão e percentuais, preservando os valores anteriores como referência de comparação. Em seguida, calcula a venda pela margem e executa os cenários de análise configurados, quando existentes.

Se houver cadastro ativo em '''Informações de Precificação do Produto''', seus cenários específicos são utilizados no lugar dos cenários gerais, com seus critérios de arredondamento e tolerâncias. O perfil fiscal utilizado pelos cenários vem da tabela base.

=== Produtos novos na tabela ===

Com <code>P_INCLUIR_PRODUTOS_NOVOS = 0</code>, produtos ausentes da tabela são contabilizados como '''Fora da tabela''' e não recebem um item de preço nessa tabela.

Com o parâmetro igual a 1, o smart prepara os itens na pré-tabela. Para os parâmetros de margem e percentuais, utiliza como referência outro produto da mesma subespécie já preparado nessa tabela durante a execução; se não houver referência, utiliza os padrões da tabela.

Essa opção não cria novos produtos no cadastro geral: ela trata produtos já cadastrados que ainda não fazem parte da tabela base.

=== Produtos sem custo ===

Quando o custo é ausente, zero ou negativo, o produto é contabilizado como '''Sem custo''' e não recebe um item de preço nessa tabela. O item da nota permanece registrado como considerado na pré-tabela.

== Ações de precificação ==

{| class="wikitable"
! Ação !! Resultado
|-
| '''Não aplicar — 0''' || Mantém o item na pré-tabela sem autorizar a gravação do preço na tabela base.
|-
| '''Aplicar — 1''' || Marca o item para aplicação posterior, pelo fluxo de vinculação da pré-tabela.
|-
| '''Aguarda revisão — 2''' || Mantém o item pendente da decisão do usuário na pré-tabela.
|}

=== Regra automática de tolerância ===

Quando <code>P_ACAO_PADRAO</code> está vazio, o smart compara o novo valor de venda com o valor de venda anterior:

* Variação '''dentro da tolerância''': marca '''Não aplicar''' e contabiliza em '''Sem alteração'''.
* Variação '''fora da tolerância''': marca '''Aplicar'''.
* Produto sem venda anterior positiva: considera fora da tolerância.

A comparação é percentual sobre o preço anterior. Para aumentos, utiliza a tolerância acima; para reduções, a tolerância abaixo. O limite da tolerância é incluído na faixa considerada aceitável.

É utilizada a tolerância da análise quando ela é positiva. Se estiver ausente ou zerada, utiliza a tolerância da tabela base. Quando a tolerância efetiva é zero, somente a ausência de variação fica dentro da faixa.

'''Exemplo:''' venda anterior de R$ 100,00, tolerância acima de 3% e abaixo de 2%:

{| class="wikitable"
! Nova venda !! Variação !! Ação automática
|-
| R$ 102,00 || +2% || Não aplicar — dentro da tolerância.
|-
| R$ 103,00 || +3% || Não aplicar — no limite da tolerância.
|-
| R$ 104,00 || +4% || Aplicar.
|-
| R$ 97,00 || −3% || Aplicar.
|}

Essa decisão automática considera a variação do '''preço de venda'''. Alterações isoladas de custo, mínimo ou máximo não são o critério dessa comparação. Para exigir conferência humana de todos os itens gerados, informe a ação padrão '''2 — Aguarda revisão'''.

== Programação e aplicação dos preços ==

=== Sem data estimada automática ===

Com <code>P_SETAR_DATA_ESTIMADA = 0</code>, a pré-tabela é salva sem data estimada. Revise seus itens e programe a aplicação pela tela. Informar um horário sem habilitar esse parâmetro não programa a aplicação.

=== Com data estimada automática ===

Com <code>P_SETAR_DATA_ESTIMADA = 1</code>:

* '''Sem horário:''' a data estimada é o momento da execução. A pré-tabela fica disponível para a próxima execução elegível do smart de vinculação.
* '''Com horário:''' utiliza a próxima ocorrência desse horário, hoje se ainda não passou, ou amanhã se já passou.

Por exemplo, para horário 18:30, uma execução às 15:00 programa a pré-tabela para as 18:30 do mesmo dia. Uma execução às 20:00 programa para as 18:30 do dia seguinte.

O horário é interpretado conforme o fuso do servidor que executa a rotina. A data estimada define quando a pré-tabela se torna elegível; a aplicação depende da próxima execução do smart de vinculação e pode ocorrer depois desse horário.

O componente <code>SCExecVinculacaoPreTabelaPrecoBase</code> consulta pré-tabelas calculadas, ainda não vinculadas e com data estimada atingida. Seu parâmetro obrigatório <code>P_DATA_INICIO_ANALISE</code> também precisa abranger as pré-tabelas que deverão ser aplicadas.

Somente os itens marcados como '''Aplicar''' são destinados à gravação de preços nesse fluxo. Itens de revisão exigem decisão do usuário; a data estimada não muda sua ação automaticamente.

== Exemplo de configuração para revisão ==

Para gerar propostas de preço sem liberar automaticamente os itens:

<pre>
P_ID_EMPRESA = selecionar a empresa
P_ID_CONFIG_PRECIFICACAO = selecionar a configuração de precificação
P_DATA_BASE_AVALIACAO = informar o início do período desejado
P_ACAO_PADRAO = 2
P_IDS_TABELAS_PRECO = selecionar as tabelas desejadas
P_INCLUIR_PRODUTOS_NOVOS = 0
P_SETAR_DATA_ESTIMADA = 0
P_HORARIO_APLICACAO = vazio
</pre>

Execute o smart, consulte o identificador da pré-tabela no resultado e abra o recurso '''1363 — Pré-Tabela de Preços Base'''. Confira custos, cenários, preços e ações antes de programar a aplicação.

Para decidir automaticamente pela tolerância, deixe a ação padrão vazia. Para programar a aplicação, habilite o preenchimento da data estimada e informe o horário desejado, mantendo o smart de vinculação configurado.

== Como interpretar o resultado ==

O resumo apresenta a data e a hora da execução, a quantidade de itens de nota, os produtos identificados e os resultados por tabela. Também informa a identificação e a descrição da pré-tabela e, quando preenchida, sua data estimada.

{| class="wikitable"
! Informação !! Significado
|-
| '''Itens de nota''' || Quantidade de itens de entrada considerados, somando notas de terceiros e próprias.
|-
| '''Produtos''' || Quantidade de produtos distintos encontrados nesses itens.
|-
| '''Preços a aplicar''' || Itens marcados como Aplicar. Não confirma que os preços já foram gravados nas tabelas base.
|-
| '''Aguardando revisão''' || Itens marcados para decisão do usuário.
|-
| '''Sem alteração''' || Itens dentro da tolerância, marcados automaticamente como Não aplicar. Pode haver diferença de preço dentro da faixa aceita.
|-
| '''Não aplicar''' || Itens gerados com a ação padrão explicitamente definida como Não aplicar.
|-
| '''Fora da tabela''' || Ocorrências de produtos ausentes das tabelas, quando a inclusão de novos está desabilitada.
|-
| '''Sem custo''' || Ocorrências em que não foi encontrado custo positivo para a precificação.
|}

As contagens das ações, de fora da tabela e de sem custo são feitas por '''tabela × produto'''. Um mesmo produto analisado em três tabelas pode aparecer em três ocorrências, embora a quantidade de produtos distintos seja apenas uma.

O sucesso da geração da pré-tabela não confirma o sucesso da vinculação posterior. Acompanhe também o resultado do smart de vinculação e confira os preços nas tabelas base.

== Solução de problemas ==

{| class="wikitable"
! Situação !! O que conferir
|-
| Empresa, configuração ou data base não informada. || Preencha os três parâmetros obrigatórios.
|-
| Nenhuma tabela de preço base encontrada. || Informe tabelas explicitamente ou configure uma tabela principal para a empresa.
|-
| Horário de aplicação inválido. || Utilize HH:mm, por exemplo 18:30. A validação do horário ocorre quando a programação da data estimada está habilitada.
|-
| Nenhum item de nota novo. || Confira a data de entrada, as empresas da configuração, o CFOP de compra e os vínculos dos itens com pré-tabelas. Para notas próprias, confira também a autorização e a natureza de entrada.
|-
| Produto ficou fora da tabela. || Confira sua presença nas tabelas selecionadas e o parâmetro de inclusão de produtos novos.
|-
| Produto ficou sem custo. || Revise o tipo de custo configurado e os dados do produto na empresa da precificação. Depois, revise ou recalcule pela pré-tabela; a entrada já registrada não será automaticamente relida.
|-
| Aumento pequeno não foi aplicado. || Confira as tolerâncias efetivas. Dentro da tolerância, a ação automática é Não aplicar.
|-
| Todos os itens ficaram com a mesma ação. || Confira se P_ACAO_PADRAO foi preenchido. Ele substitui a decisão por tolerância.
|-
| Pré-tabela gerada, mas preços não atualizados. || Confira a ação dos itens, a data estimada, a execução do smart de vinculação e sua data de início de análise.
|-
| Execução com erro de cálculo. || Consulte os detalhes da tarefa e revise custos, fórmulas e variáveis. Erros de processamento que desfazem a transação não devem deixar uma pré-tabela parcialmente gravada; confira o resultado antes de executar novamente.
|}

== Recursos relacionados ==

* [[1363_Pre_Tabela_Precos_Base|1363 — Pré-Tabela de Preços Base]].
* [[1876_Configuracao_Servicos|1876 — Configuração de Serviços]].
* [[1536_Avaliacao_Expressoes|1536 — Avaliação de Expressões]].
* [[1609_Analise_Preco_Venda_Tabela_Variaveis|1609 — Análise de Preço de Venda — Tabela de Variáveis]].
* 2103 — Informações de Precificação do Produto.
* Smart de Vinculação de Pré-Tabela de Preços Base — <code>SCExecVinculacaoPreTabelaPrecoBase</code>.