Exibir origem

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.

Na release 12.1.20 será liberado oficialmente a Sugestão da Natureza de Operação no Faturamento, aonde será possível selecionar o Tipo de Operação na tela FT4003B (Gerais) que será utilizado para filtro das regras no momento de salvar o item do documento. O conceito é o mesmo da Sugestão da Natureza no Pedido de Venda.

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.

Todos os dados técnicos podem ser visualizados no dicionário de dados da base.
Identificador para o Campo Customizado: É necessário informar um identificador para o campo (Ex: regra-custom-001, regra-custom-002, etc..). Esse identificador será utilizado no programa progress responsável por tratar a regra específica.
Nome do Campo Customizado: É necessário informar um nome para o campo customizado. Esse é o nome que será visualizado nas telas HTML da Sugestão da Natureza de Operação.
Tipo do Campo Customizado: É possível cadastrar o campo com os seguintes tipos:
- Lógico (Campo limitado à "Sim", "Não" e "?")'
  - Utilizado quando se deseja limitar as opções durante cadastro de valores para um campo campo lógico.
- Sem validação (Campo livre, não será validado contra uma tabela)
  - Utilizado quando a informação a ser cadastrada é livre para a digitação do usuário
- Com validação (O valor do campo será validado contra uma tabela)
  - Utilizado quando deseja-se limitar os dados a registros existentes em uma outra determinada tabela.
  - Os campos "Banco", "Tabela", "Campo" devem ser preenchidos com as informações da tabela estrangeira relacionada ao pedido ou item do pedido, essa tabela será utilizada pelo Zoom para listar os valores disponíveis durante o cadastro dos valores da regra.
  - O campo "Possui Zoom" indica que o campo será apresentado na tela de "Regras da Natureza de Operação" em um componente de zoom. Ex: O campo "moeda" é proveniente de uma tabela com todas as moedas cadastradas no sistema, e pode ser selecionado como zoom. Já um campo como "Suframa", não é provido por uma tabela, então não deve possuir zoom.
  - O campo "Campo para coluna adicional no Zoom" deve ser preenchido com o campo responsável pela descrição da informação. Esse campo será apresentado como uma coluna do Zoom, para facilitar a identificação do registro (como no exemplo abaixo).

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.