How to - Sugestão Automática da Natureza de Operação
PD0301 – Atualização Parâmetros Pedidos
Parâmetro "Sugestão Automática de Natureza de Operação". Ao confirmar os parâmetros de Pedidos com a "Sugestão Automática da Natureza de Operação" selecionada, serão criados campos padrões que podem ser utilizados nas regras para busca da natureza de operação.
CD0821 – Manutenção Permissão Usuário
- Parâmetro “Tipo de Operação de Venda” na aba “Principal”: Quando selecionado, permite que o valor do campo “Tipo de Operação de Venda” seja alterado pelo usuário nas telas de cadastro de pedidos.
- Parâmetro “Utiliza Sugestão Automática da Natureza de Operação de Venda” na aba “Parâmetros”: Quando selecionado, habilita a sugestão automática da natureza de operação a nível de usuário.
CD0640 – Manutenção Tipo Operação Venda
- Cadastro para o Tipo de Operação de Venda que será informado nas telas de cadastro do pedido. O Tipo de Operação de Venda será utilizado no cadastro "Regras da Natureza de Operação" e informado pelo usuário nas telas de cadastro do pedido de venda.
- É possível listar os clientes vinculados a determinado Tipo de Operação de Venda acionando o botão "Listar clientes com o tipo de operação de venda atual".
- É possível exportar o tipo de operação de venda para uma determinada faixa de clientes. Para isso, o botão "Exportar tipo de operação para clientes" abre uma janela para seleção da faixa de cliente para alteração.
CD0640 - Manutenção Tipo de Operação de Venda
CD0640A - Exportação Tipo de Operação de Venda
CD1510 - Atualização Clientes
- É possível vincular ao cliente um Tipo de Operação de Venda Default. Assim, ao cadastrar o pedido, o Tipo de Operação de Venda já estará preenchido.
Campos para Regra da Natureza de Operação
- Nesse cadastro serão listados todos os campos cadastrados para a regra da natureza de operação.
- Somente os campos marcados como "Sim" na coluna "Considera na Regra" serão apresentados no cadastro das regras para a sugestão da natureza de operação.
- A informação de peso serve para critérios de desempate. (Os critérios de desempate serão detalhados posteriormente)
- É possível adicionar campos com Regras Customizadas.
- Novo Campo Customizável: Essa opção é indicada para quando o cliente sente a necessidade de incluir algum campo específico ou regra customízada. É obrigatório o desenvolvimento da lógica específica por parte do cliente no programa pdp/pdapi516conf.p. (O processo será detalhado posteriormente)
Regras da Natureza de Operação
- Permite o cadastro dos valores para os campos que fazem parte de uma regra para busca da natureza de operação.
- A ordem dos campos em tela segue a ordem estipulada no cadastro Campos para Regra da Natureza de Operação.
- Ao selecionar a opção "Nova Regra", será apresentada uma janela para cadastro dos valores para os campos.
Opção Salvar Alterações na Grade:
- Permite que as alterações nas regras sejam efetuadas diretamente na grade, agilizando o processo de manutenção das regras.
Opção Nova Regra
- Permite o cadastro de valores com o interroga "?" para flexibilizar a regra.
- O "Tipo de Operação de Venda" é uma informação obrigatória, ou seja, não será possível parametriza-lo com o interroga "?".
- O botão "Pesquisar", considera os valores preenchidos nos campos e faz uma busca nas regras já cadastradas por esses valores. Dessa forma é possível identificar se existem regras já cadastradas para determinadas combinações de valores.
Opção Histórico
- Permite visualizar as alterações realizadas na regra, assim como a observação realizada para a mesma.
- Existem duas formas de visualização disponíveis: Grade ou Lista
Opção Simulação
- Permite executar uma simulação da sugestão da natureza baseando-se nos dados de um pedido ou item.
Opção Cópia
- Permite a cópia de uma ou mais regras já existentes, facilitando o cadastro.
Opção Exportação para Planilha
- Permite a exportação das regras cadastradas para a planilha.
- É possível exportar todas as regras cadastradas ou apenas as filtradas em tela.
Configuração de Clientes e Representantes
- Para uso da Sugestão Automática da Natureza de Operação no Portal de Clientes e Representantes, é possível parametrizar quais Tipos de Operação de Venda estarão disponíveis para seleção pelo Cliente ou Representante.
- No papel do Cliente, quando vinculado ao mesmo apenas 1 Tipo de Operação de Venda, o campo Tipo de Operação de Venda não será apresentado no Portal, mas internamente será gravado no Pedido. Esse tratamento é válido para as empresas que não desejam apresentar esse campo para os seus clientes, mas desejam utilizar a funcionalidade da sugestão.
Exemplo de uso
- Regra cadastrada para o Tipo de Operação 1606, com todos os valores preenchidos com o interroga "?".
- Ao cadastrar o pedido de venda, deve ser informado o Tipo de Operação de Venda 1606
- Ao salvar o item do pedido, será executada a lógica para pesquisa da natureza de operação, e nesse momento a natureza do item é alterada de 5111 para 511a.
A sugestão da natureza é realizada ao salvar o item, pois nesse momento todas as informações necessárias para as regras estarão preenchidas. Obs: A execução da sugestão só é realizada caso a natureza do item seja igual a natureza do pedido, indicando assim que a mesma não foi alterada pelo usuário.
Regra cadastrada para sugestão da natureza 511a (Estadual), 611a (Interestadual) ou 711a (Exportação).
Inclusão do pedido com o Tipo de Operação 1606.
Antes de salvar o item, é possível visualizar que a natureza de operação do item ainda encontra-se com a natureza de operação do cabeçalho.
Após salvar o item, nota-se que a natureza foi alterada conforme a regra cadastrada.
Critérios para desempate
- Como o cadastro das regras permite informar o interroga "?" nos campos que não devem ser considerados, existe a possibilidade do sistema encontrar mais de uma regra que se encaixe com as informações do item/pedido.
Nesses casos o desempate ocorre de duas formas, 1º pelos pesos, e 2º pela quantidade de campos diferentes de ?:
Exemplo:
Campo e respectivo peso no cadastro "Campos para Sugestão da Natureza de Operação"
NOME DO CAMPO | PESO |
EMITENTE | 4 |
CANAL DE VENDA | 3 |
CÓDIGO DO ITEM | 2 |
FAMÍLIA COMERCIAL | 1 |
1º Critério de desempate: Será selecionado a regra que possuir a maior somatória dos pesos
EMITENTE | CANAL DE VENDA | CÓDIGO DO ITEM | FAMÍLIA COMERCIAL | TOTAL DO PESO DOS CAMPOS DIFERENTES DE ? | TOTAL CAMPOS DIFERENTES DE ? | REGRA SELECIONADA |
X | ? | ? | ? | 4 | 1 | SELECIONADO |
? | X | ? | ? | 3 | 1 |
|
2º Critério de desempate: Será selecionado a regra que possuir a maior quantidade de campos diferentes de ?.
EMITENTE | CANAL DE VENDA | CÓDIGO DO ITEM | FAMÍLIA COMERCIAL | TOTAL DO PESO DOS CAMPOS DIFERENTES DE ? | TOTAL CAMPOS DIFERENTES DE ? | REGRA SELECIONADA |
X | ? | ? | ? | 4 | 1 |
|
? | X | ? | X | 4 | 2 | SELECIONADO |
Novo Campo Customizável
Essa opção é indicada para quando o cliente sente a necessidade de incluir algum campo ou regra específica. É obrigatório o desenvolvimento da lógica específica por parte do cliente no programa pdp/pdapi516conf.p.
Exemplo de um Novo Campo Customizável
- Supondo que a empresa deseja criar uma regra que considera se o item do pedido, estado de origem e estado de destino possuem cadastro no CD0904A (Subst Tribut Item / Unidade Federação), indicando assim que o item possui ICMS ST. Para essa situação, é necessário o cadastro de um campo customizável, pois será necessário efetuar uma regra para a consulta dessa informação.
- Para isso, é necessário o cadastro de um campo customizável do tipo Lógico, que será apresentado na tela de cadastro de valores da regra. Conforme o exemplo abaixo.
Tela Campos para Regra da Natureza de Operação
Tela Regras da Natureza de Operação
- A regra de busca e validação deve ser implementada no programa pdp/pdapi516conf.p liberado como um fonte aberto.
- O programa é executado durante a sugestão da natureza de operação, que ocorre ao salvar o item do pedido.
- Ele recebe como parâmetro o identificador do campo, o seu valor na regra que está sendo validada, a origem da execução (atualmente apenas Pedido), e os handles da ped-venda e ped-item.
- O retorno deve ser um valor lógico, que indica se a regra é válida ou não.
Programa fonte liberado: pdapi516conf.p
Como executar a Sugestão Automática da Natureza de Operação a partir de um programa específico?
A API de sugestão automática pode ser executada através de programas específicos. Para implementar a função, devem ser seguidos os seguintes passos:
- Instanciar a API pdp/pdapi516.p de forma persistente.
- Executar a procedure exec-sugest-natur-oper, passando os parâmetros conforme a necessidade de sugerir a natureza para um pedido ou nota fiscal. A execução deve acontecer dentro de um loop de forma a ser executada uma vez para cada item do pedido ou nota fiscal. Caso a sugestão seja executada no pedido, não é necessário executar novamente na nota fiscal.
- A procedure recebe três parâmetros, e retorna a natureza encontrada, conforme detalhamento a seguir.
- Eliminar a execução persistente.
Parâmetros de entrada/saída da procedure exec-sugest-natur-oper
Nome | I/O | Tipo | Descrição |
---|
c-origem | Entrada | Character | Indica a origem dos próximos parâmetros. Deve ser enviado com os valores "PEDIDO" ou "FATURAMENTO" para sugerir a natureza para os itens do pedido ou da nota fiscal, respectivamente. |
h-cabecalho | Entrada | Handle | Recebe o handle da temp-table de cabeçalho do pedido (ped-venda) ou da nota fiscal (wt-docto). A definição da temp-tables deve seguir a definição utilizada pelas BO's padrões das tabelas. |
h-item | Entrada | Handle | Recebe o handle da temp-table do item do pedido (ped-item) ou da nota fiscal (wt-it-docto). A definição da temp-tables deve seguir a definição utilizada pelas BO's padrões das tabelas. |
p-c-natureza-sugerida | Saída | Character | Retorna a natureza encontrada pelo sistema. Importante: A rotina identifica automaticamente se a natureza encontrada deve ser estadual, interestadual ou de exportação, e caso a regra escolhida pelo sistema não possua natureza informada para o tipo determinado, será retornado o valor "" (branco). |
Exemplo de execução da Sugestão Automática da Natureza de Operação
Abaixo um exemplo de como executar a procedure de sugestão automática da natureza de operação para os itens do pedido. A execução para a nota fiscal ocorre de maneira análoga, observadas as definições acima. É importante ressaltar a criação de um buffer das temp-tables utilizadas na passagem de parâmetros, ou reposicionamento do registro após o procedimento, pois é característico da tecnologia que a tabela temporária perca o posicionamento após a manipulação do handle.