Cross Segmentos - Linha Datasul - MPD - Sugestão Automática da Natureza de Operação

 Tempo aproximado para leitura: 00:16:00 min

Dúvida
Como realizar a parametrização para utilizar a Sugestão Automática da Natureza de Operação?

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Pedidos de Vendas (MPD) - Todas as versões

Solução
1. PD0301 – Atualização Parâmetros Pedidos: ao selecionar o parâmetro Sugestão Automática de Natureza de Operação, existente na pasta Geral, serão criados campos padrões que podem ser utilizados nas regras para busca da natureza de operação:

2. CD0821 – Manutenção Permissão Usuário: ao marcar o parâmetro Tipo de Operação de Venda na pasta Principal, irá permitir que o valor do campo Tipo Op Venda seja alterado pelo usuário nas telas de cadastro de pedidos:

Ao selecionar o campo Utiliza Sugestão Automática da Natureza de Operação de Venda na pasta Parâmetros, irá habilitar a sugestão automática da natureza de operação a nível de usuário:

3. 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.

CD0640A - Exportação Tipo de Operação de Venda.

4. 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.

5. mpd.html.rulesoperationtype - Campos para Regra da Natureza Operação: lista 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 customizada. É obrigatório o desenvolvimento da lógica específica por parte do cliente no programa pdp/pdapi516conf.p, isso independente do Tipo do Campo Customizável, seja Lógico, Com validação ou Sem validação, o processo será detalhado posteriormente.

6. mpd.html.rulesoperations - 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 parametrizá-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.

7. mpd.html.portalconfigpdp - Configuração de Cliente e Representante:

• 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 um 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.

8. 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. 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.

Sugestão da Natureza de Operação no Faturamento

Na release 12.1.20, foi liberada oficialmente a Sugestão da Natureza de Operação no Faturamento, onde será possível selecionar o Tipo de Operação na tela FT4003B - Calculo Notas Fiscais, 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.

9. 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:

1º Critério de desempate: será selecionada a regra que possuir a maior somatória dos pesos​:

2º Critério de desempate: será selecionada a regra que possuir a maior quantidade de campos diferentes de ?:

10. 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.

10.1. Todos os dados técnicos podem ser visualizados no dicionário de dados da base.

10.2. Identificador para o Campo Customizado: é necessário informar um identificador para o campo, por exemplo: regra-custom-001, regra-custom-002, etc... Esse identificador será utilizado no programa Progress responsável por tratar a regra específica.

10.3. 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.

10.4. Tipo do Campo Customizado: é possível cadastrar o campo com os seguintes tipos:

10.4.1. 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.

10.4.2. 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.

10.4.3. 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. Exemplo: 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 - Superintendência da Zona Franca de Manaus, 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.

11. 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 - Imposto Sobre Circulação de Mercadorias e Serviços com Substituição Tributária. 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, em anexo ao final da página.
  
  
• 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, 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.

12. 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:

13. 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.

14. Sugestão Automática da Natureza de Operação com Central de Vendas.
Na inclusão dos itens no pedido a sugestão considera os dois estabelecimentos para busca das regras  -estabelecimento do cabeçalho e estabelecimento de atendimento, se estiver ativa a Central de Vendas,  mas ao efetivar o pedido se houver mais de um estabelecimento de atendimento, o pedido será quebrado e reaplicada a sugestão, com isso a natureza poderá mudar, pois o estabelecimento do cabeçalho não será mais o mesmo da regra inicial.
Para um perfeito funcionamento. Recomenda-se fortemente não utilizar o campo estabelecimento do cabeçalho se usar a Central de Vendas e sugestão de natureza, deve-se usar apenas o estabelecimento de atendimento, assim, ao quebrar os pedidos a sugestão será reaplicada e buscará as regras corretamente.

Saiba mais
Apresentação da funcionalidade: How to Sugestão Automática da Natureza de Operação.