Smart Component Execucao/SC 53 Smart Vinculacao Automatica Pre Tabela Precos

Smart_Component_Execucao

O smart Vinculação de Pré-Tabela de Preços Base aplica às tabelas base os valores preparados nas pré-tabelas cuja data estimada já foi atingida. Ele permite programar a entrada em vigor dos preços e concluir a etapa de aplicação da precificação automática.

Componente: SCExecVinculacaoPreTabelaPrecoBase.
Tipo: Smart de execução.

O smart utiliza os valores já existentes nos itens da pré-tabela. A execução não recalcula custos, fórmulas, tolerâncias ou preços antes de aplicá-los. Revise os resultados e as ações dos itens na pré-tabela antes da data programada.

Quando utilizar

Utilize para aplicar preços preparados no recurso 1363 — Pré-Tabela de Preços Base, inclusive pré-tabelas geradas pelo smart de precificação automática por notas de entrada.

O processo possui duas etapas:

Preparação: calcular e revisar os valores na pré-tabela, definir as ações dos itens e preencher a data estimada.
Aplicação: este smart identifica os vínculos elegíveis e grava os valores nas respectivas tabelas base.

A data estimada determina quando o vínculo fica disponível para processamento. A aplicação ocorre na execução do smart que encontrar essa condição, podendo acontecer depois do horário estimado conforme a programação da tarefa.

Antes de configurar

Confira se a pré-tabela:

Possui as tabelas base de destino vinculadas.
Contém os produtos e os valores que deverão ser aplicados em cada tabela.
Tem a Data estimada preenchida.
Foi revisada, incluindo custos, venda, margens, limites e ações de precificação.

O smart não possui parâmetros próprios para selecionar uma empresa ou uma tabela específica. A seleção percorre os vínculos elegíveis encontrados na base utilizada pela execução, conforme o período informado. Confira as pré-tabelas programadas nesse período.

Parâmetro obrigatório

Parâmetro	Preenchimento	Finalidade
`P_DATA_INICIO_ANALISE`	Data inicial de análise. Obrigatório.	Define o limite inicial da data estimada das pré-tabelas que poderão ser vinculadas.

O limite final é o momento da execução do smart. Os dois limites são incluídos na comparação.

A data inicial filtra a data estimada, não a data de cadastro da pré-tabela, a data da nota ou a data do último cálculo. Uma pré-tabela antiga pode ser selecionada se sua data estimada estiver dentro do intervalo e seu vínculo continuar aberto.

Escolha uma data que abranja as programações que deverão ser processadas. Uma data muito recente pode deixar pendências anteriores fora da seleção; ampliar o período pode incluir pré-tabelas antigas ainda abertas.

Quais vínculos são selecionados

O vínculo entre uma pré-tabela e uma tabela base precisa atender simultaneamente às seguintes condições:

Não possuir data/hora de vinculação concluída.
Possuir uma tabela base de destino informada.
Conter pelo menos um produto.
Ter a data estimada da pré-tabela igual ou posterior a P_DATA_INICIO_ANALISE.
Ter a data estimada igual ou anterior ao momento da execução.

Pré-tabelas sem data estimada ou com data futura não são selecionadas. Vínculos já concluídos também não são selecionados.

A seleção não é restrita às pré-tabelas geradas automaticamente: pré-tabelas preparadas por outros fluxos também podem ser processadas quando atendem às condições acima.

Os vínculos são processados por data estimada, depois pelo identificador da pré-tabela e pelo identificador do vínculo. Se várias pré-tabelas elegíveis atualizarem o mesmo produto na mesma tabela, uma aplicação posterior na sequência poderá substituir os valores aplicados anteriormente.

Como as ações dos itens são tratadas

Situação do item	Comportamento
Aplicar e ainda sem data/hora de aplicação	Grava os valores na tabela base e registra a data/hora de aplicação do item.
Não aplicar	Não grava os valores desse item.
Aguarda revisão e ainda sem aplicação	Não grava seus valores e mantém o vínculo aberto para nova execução após a decisão do usuário.
Item já aplicado	Não aplica novamente, mesmo que o vínculo permaneça aberto por outros itens.
Item antigo sem ação informada e ainda não aplicado	É tratado como autorizado para aplicação, para compatibilidade com pré-tabelas anteriores ao controle de ações.

A ausência de ação em um item antigo não equivale a Não aplicar. Revise a ação desses itens antes de programar uma pré-tabela antiga.

O smart respeita as ações já gravadas. Ele não transforma automaticamente um item em Aplicar com base em tolerância, nem aprova itens que aguardam revisão.

Quais informações são gravadas

Para cada item autorizado, o sistema transfere à tabela base:

Valor de custo e valor de venda.
Margem de lucro.
Percentual padrão de comissão.
Percentuais mínimo e máximo.
Valores mínimo e máximo.
Percentual de desconto tributário.

Se o produto já existir na tabela base, essas informações são atualizadas. Se ainda não existir, é criado um item ativo para o produto nessa tabela.

A aplicação usa os valores salvos na pré-tabela, inclusive os limites de preço. Por isso, alterações de custo ou de fórmulas ocorridas depois do cálculo exigem revisão e recálculo no fluxo da pré-tabela antes da aplicação, quando necessário.

Quando o vínculo é concluído

O controle de conclusão é feito por vínculo de tabela base. Uma pré-tabela com várias tabelas pode ter vínculos em situações diferentes.

Se não houver item pendente em Aguarda revisão, o sistema registra a data/hora de vinculação e esse vínculo deixa de ser selecionado nas próximas execuções.
Se houver item ainda aguardando revisão, o vínculo permanece aberto. Itens autorizados podem ser aplicados nessa mesma execução, sem esperar a revisão dos demais.
Nas próximas execuções, os itens já aplicados são ignorados e os itens liberados posteriormente podem ser aplicados.

Um vínculo também pode ser concluído quando seus itens estão todos como Não aplicar: a conclusão não significa que todos os preços foram alterados.

Depois que um vínculo foi concluído, alterar a ação de um item para Aplicar não faz este smart selecioná-lo novamente. Confira a conclusão e utilize o fluxo apropriado da pré-tabela para tratar uma nova aplicação.

Exemplo com revisão pendente

Uma pré-tabela possui data estimada para as 18:00 e está dentro do período configurado. Na execução das 18:05, seus produtos estão assim:

Produto	Ação	Resultado
Produto A	Aplicar	Tem os valores gravados e recebe data/hora de aplicação.
Produto B	Aguarda revisão	Permanece pendente.
Produto C	Não aplicar	Seus valores não são gravados.

O vínculo permanece aberto por causa do Produto B. Depois que o usuário revisar esse produto e salvar sua ação como Aplicar, uma nova execução elegível poderá aplicar seus valores. O Produto A não será aplicado novamente.

Se não restarem itens aguardando revisão, o vínculo será concluído. Para que a nova execução encontre a pendência, a data inicial de análise precisa continuar abrangendo a data estimada dessa pré-tabela.

Como configurar e acompanhar

Configure uma execução do componente SCExecVinculacaoPreTabelaPrecoBase no fluxo de tarefas/smarts utilizado pela empresa.
Informe P_DATA_INICIO_ANALISE.
Defina a frequência de execução de acordo com os horários de aplicação desejados.
Na pré-tabela, confira as tabelas de destino, os valores, as ações e a data estimada.
Acompanhe o status da execução.
Confira a data/hora de aplicação dos itens, a conclusão de cada vínculo e os valores efetivos nas tabelas base.

Exemplo de parâmetro: informe como data inicial o primeiro dia do período de programações que deseja abranger. O smart considera as pré-tabelas com data estimada entre essa data e o momento de cada execução.

Uma execução com sucesso pode não alterar preços: isso acontece quando não existem vínculos elegíveis ou quando os itens não estão autorizados para aplicação. O componente não apresenta um resumo quantitativo próprio de preços aplicados; confira os registros da pré-tabela e da tabela base.

Integração com a precificação automática por notas

O componente SCExecPrecificacaoAutoNotasEntrada gera a pré-tabela e define as ações dos produtos. Para programar sua aplicação automática, utilize nele:

P_SETAR_DATA_ESTIMADA = 1 para preencher a data estimada.
P_HORARIO_APLICACAO quando desejar indicar a próxima ocorrência de um horário.

Sem horário, a data estimada é preenchida com o momento da geração, tornando a pré-tabela elegível para uma próxima execução deste smart, desde que seu período de análise a abranja.

Se a data estimada não for preenchida pelo smart de geração, programe-a pela tela da pré-tabela. Itens marcados como Aguarda revisão continuam dependendo da decisão do usuário, mesmo com data estimada atingida.

Erros e solução de problemas

Quando falta o parâmetro obrigatório, o smart retorna erro com a mensagem Data inicio analise nao informada.

Se ocorrer erro ao processar um vínculo, o componente registra a falha, informa a pré-tabela e a tabela base envolvidas e tenta continuar com os próximos vínculos. Ao final, o status permanece como erro se alguma dessas falhas tiver sido registrada.

Após uma execução com erro, confira o estado efetivo dos itens e vínculos antes de repetir. O status geral, isoladamente, não demonstra quais alterações foram efetivamente confirmadas.

Situação	O que conferir
Data inicial não informada.	Preencha P_DATA_INICIO_ANALISE e execute novamente.
Pré-tabela não foi selecionada.	Confira sua data estimada, o período configurado, a tabela vinculada, a presença de produtos e a conclusão do vínculo.
Horário estimado chegou, mas nada foi aplicado.	Confira a frequência e a execução da tarefa. A data estimada torna o vínculo elegível, mas não dispara uma execução por si só.
Alguns produtos foram aplicados e outros não.	Confira as ações e as datas de aplicação de cada item. Produtos Não aplicar ou Aguarda revisão não são gravados.
Vínculo continua aberto depois de aplicar preços.	Confira se ainda há itens não aplicados em Aguarda revisão.
Item liberado após revisão não foi aplicado.	Salve a alteração da ação, confira se o vínculo continua aberto e se a data inicial ainda abrange sua data estimada.
Alterei um item já aplicado, mas ele não foi atualizado novamente.	Itens com data/hora de aplicação são ignorados. Prepare a nova alteração pelo fluxo apropriado de precificação.
Preço aplicado difere do cálculo esperado atualmente.	Confira os valores efetivamente salvos na pré-tabela. O smart não recalcula as regras no momento da vinculação.
Produto foi incluído na tabela base.	Esse é o comportamento para um item autorizado cujo produto ainda não existia na tabela de destino.
Execução com erro de vinculação.	Consulte a mensagem com a pré-tabela, a tabela base e o motivo. Corrija a causa e confira o estado gravado antes de executar novamente.

Recursos relacionados

1363 — Pré-Tabela de Preços Base.
Tabela de Preços Base.
Smart de Precificação Automática por Notas de Entrada — SCExecPrecificacaoAutoNotasEntrada.
2103 — Informações de Precificação do Produto.