Boletim Técnico - TES Inteligente

Criado por Erick Goncalves Dias, última alteração por Joao Victor Pellegrini de Oliveira em 20 jul, 2016

Tes Inteligente
Produto: Microsiga Protheus

Versões: 11 e 12

Ocorrência: MATA089- Tes inteligente

Passo a Passo
Está disponível o cadastro de TES Inteligente, com objetivo de facilitar e agilizar o preenchimento do código do
TES (Tipo de Entrada e Saída) nos documentos fiscais, considerando regras previamente cadastradas. A
vantagem da utilização desta rotina, é que podemos configurar quais códigos de TES serão utilizados em
determinados documentos fiscais.

Procedimentos de Configuração
No Configurador (SIGACFG) acesse Ambiente/ Cadastros/ Menus e inclua, no menu do módulo Livros
Fiscais (SIGAFIS), conforme especificação a seguir:

Nome do Menu Submenu Nome da Rotina Programa Tabelas

Atualizações Cadastros Tes inteligente MATA089 SFM

No Configurador (SIGACFG) acesse Ambiente/ Cadastros/ Parâmetros e verifique os parâmetros a seguir:

Nome da MV_OTICLI
Variável

Tipo Caractere

Conteúdo {1,2,3,4,5,6,7,8,9,10,11}

Descrição Informe a ordem de prioridade dos campos do cadastro de TES Inteligente nas
operações vinculadas com Clientes

Importante:
As informações deverão estar cadastradas entre chaves {}, informando somente números sem aspas. Exemplo
de preenchimento: {5,4,3,2,1,6,7,8,9,10,11}. Os números não poderão ser repetir.

Nome da MV_OTIFOR
Variável

Tipo Caractere

Conteúdo {1,2,3,4,5,6,7,8,9}
 Nome da MV_OTIFOR
Variável

Descrição Informe a ordem de prioridade dos campos do cadastro de TES Inteligente nas
operações vinculadas com Fornecedores

Importante:
As informações deverão estar cadastradas entre chaves {}, informando somente números sem aspas. Exemplo
de preenchimento: {8,4,3,2,1,6,7,5,9}. Os números não poderão ser repetir.

Para criação destes parâmetros na versão 11, é necessário processamento do compatibilizador u_updsigafis.

Procedimentos de Utilização
O cadastro do TES inteligente poderá ser acessado através rotina Tes Inteligente (MATA089.PRW), no
menu Cadastros Atualizações\Cadastros\Tes Inteligente do modulo SIGAFIS.

O cadastro das regras de preenchimento do código do TES está vinculado com um código de tipo de
movimentação (FM_TIPO), por exemplo: 01 - Venda de Mercadorias,02 - Simples Remessa de Material, 03
- Venda para Consumidor Final etc. Os códigos de Tipo de movimentação estão cadastrados na
tabela DJ da SX5, em tabelas genéricas.

Cada regra definida poderá ter um código de TES de saída (FM_TS) e/ou um código de TES de entrada
(FM_TE).
Uma vez definido na regra o Tipo de Movimento e TES a ser utilizado, será necessário preencher os demais
campos listados abaixo:
Campo Descrição

FM_CLIENTE Código de Cliente

FM_LOJACLI Loja do Cliente

FM_FORNECE Código de Fornecedor

FM_LOJAFOR Loja Fornecedor

FM_EST Estado

FM_GRTRIB Grupo Tributação

FM_PRODUTO Código de Produto

FM_GRPROD Grupo de Tributação do Produto

FM_POSIPI NCM do Produto

FM_REFGRD Código de Referência da Grade

FM_TIPOMOV Tipo de Pedido

 Campo Descrição

FM_GRPTI Grupo de TES Inteligente

FM_TIPOCLI Tipo de Cliente

FM_GRPCST Código de enquadramento de IPI

Observação:
O campo FM_REFGRD tem informação da Referência da Grade de Produto, e o campo FM_REFGRD terá a
descrição da referência selecionada no campo FM_ DESREF.
O campo FM_GRPTI tem o código do grupo de Tes Inteligente, que poderá ser informado no cadastro de
Produto, através do campo B1_ GRPTI.
Poderão ser preenchidos todos ou alguns campos da regra, variando conforme a necessidade do cliente.
Sempre será sugerido TES da regra que possuir informações que se enquadrem com o documento fiscal, se
alguma informação da regra não se enquadrar com o documento fiscal, esta regra será descartada. Regra que
possuir campos não preenchidos não será descartada, desde que os demais campos preenchidos se
enquadrem com documento fiscal.
Para exemplificar o preenchimento, vamos supor a criação de uma regra para sugerir o código de TES
500 nas Vendas de Mercadoria para Consumidor Final no Estado de São Paulo, devemos preencher da
seguinte maneira a regra do TES Inteligente:
Regra número 1:
Tipo de Movimentação Tes de Saída Estado Tipo de Cliente

01 500 SP F-Cons.Final

Quando houver escrituração de documento fiscal com Tipo de Movimentação 01, para Estado de São
Paulo utilizando cliente classificado como Consumidor Final, o TES 500 será sugerido na escrituração do
documento fiscal.
Vejamos mais um exemplo, Venda de Mercadoria do Produto "AAAA", sugerindo o código de TES 501:
Regra número 2:
Tipo de Movimentação Tes de Saída Código de Produto

01 501 AAAA

Com esta regra, quando for escriturada uma Venda de Mercadoria do Produto "AAAA", o TES 501 será
sugerido na digitação da nota fiscal.

As regras serão cadastradas em função do segmento e da necessidade de cada cliente, podendo criar regras
mais específicas ou mais genéricas.

Importante:

O campo de Tipo de Cliente será verificado somente para operações vinculadas com cliente, se a nota estiver
vinculada com um Fornecedor, o campo Tipo de Cliente não será considerado para enquadrar a regra.
Para enquadrar o participante, os campos FM_CLIENTE+FM_LOJACLI somente serão verificados caso
operações esteja vinculada com um Cliente. Se a operação estiver vinculada com um Fornecedor, então os
campos FM_FORNECE+ FM_LOJAFOR ser considerados para enquadrar o participante

Critério de Sugestão de TES - Específicas x Genéricas

A medida que as regras são cadastradas, é possível que existam regras mais genéricas, podendo entrar em
conflito com alguma regra mais específica, como nos próprios exemplos citados acima. Suponhamos o
seguinte cenário:
-Documento fiscal de Venda de Mercadoria para Consumidor Final, no Estado de São Paulo, vendendo o
produto de código "AAAA".
A princípio as duas regras atenderiam esta situação, pois ambas as regras atendem e se enquadram nas
informações do documento fiscal em questão, porém a rotina poderá sugerir somente um TES. Para resolver
este conflito, o critério adotado será considerar a regra que tiver mais informações enquadradas de acordo
com documento fiscal.
No nosso exemplo, a regra 1 possui duas informações enquadradas, o Estado e Tipo de Cliente, já a regra 2
possui apenas uma informação enquadrada, que é o Código de Produto. Neste caso a regra 1 possui mais
informações enquadradas que a regra 2, logo o TES 500 será sugerido, pois é a mais específica no contexto
deste documento fiscal.
Neste tipo de conflito, o TES sugerido será sempre o que pertencer a regra mais específica, ou seja, a regra
que tiver mais informações enquadradas.
Importante:
A combinação dos campos CLIENTE+LOJA será considerada somente como uma informação enquadrada,
bem como a combinação dos campos FORNECEDOR+LOJA.

Critério de Sugestão de TES - Regras diferentes com mesma quantidade de informações

enquadradas
Poderá ocorrer também conflito de regras distintas, cadastradas com campos diferentes, porém com a mesma
quantidade de informações enquadradas com documento fiscal. Abaixo temos um exemplo desta situação:
Regra número 3
Tipo de Movimentação TES Produto

02 502 BBBB

Regra número 4
Tipo de Movimentação TES Cliente

02 503 CCCC

Em uma operação de Simples Remessa de Material para o Cliente "CCCC", movimentando o Produto "BBBB",
as regras 3 e 4 se enquadram no documento fiscal, a regra 3 enquadrou o Código de Produto, e regra 4
enquadrou o Código de Cliente, as duas possuem a mesma quantidade de informações, tanto o TES 502
quanto o 503 poderiam ser sugeridos. Para resolver este conflito, o sistema adota o critério da ordem de
campos mais relevantes/prioritários do cadastro de TES inteligente, se o Código de Produto tem maior
relevância, então o TES 502 será sugerido, ou se o Código do Cliente tiver maior relevância, então o TES 503
será sugerido. O sistema possui uma ordem padrão de prioridades, que pode ser alterada pelo cliente se
necessário.
Para compreender esta ordem, cada campo (excluindo tipo de movimentação, TES de entrada e TES de
saída) da SFM terá um identificador fixo, conforme tabelas abaixo:
Identificadores campos da SFM - Operações com Cliente
Campo Descrição Código de Identificação

FM_PRODUTO Código de Produto 1

FM_GRPROD Grupo de Tributação do Produto 2

FM_POSIPI NCM 3

FM_CLIENTE+FM_LOJACLI Cliente+Loja Cliente 4

FM_GRTRIB Grupo Tributação 5

FM_EST Estado 6

FM_REFGRD Código de Referência da Grade 7

FM_GRPTI Grupo de TES Inteligente 8

FM_TIPOCLI Tipo de Cliente 9

FM_GRPCST Código de enquadramento de IPI 10

FM_TIPOMOV Tipo de Movimentação do Pedido de Venda 11

Para as operações vinculadas com Cliente, a ordem padrão do sistema é 1,2,3,4,5,6,7,8,9,10,11, onde cada
número representa um campo da tabela SFM, ou seja, a ordem dos campos prioritários é:
FM_PRODUTO, FM_GRPROD, FM_POSIPI, FM_CLIENTE+FM_LOJACLI, FM_GRTRIB, FM_EST, FM_REF
GRD, FM_GRPTI, FM_TIPOCLI, FM_GRPCST,FM_TIPOMOV.
Onde o campo com maior prioridade/relevância é o primeiro da esquerda para a direita, e o campo com menor
prioridade/relevância é o último da direita.

Identificadores campos da SFM - Operações com Fornecedor

Campo Descrição Código de Identificação

FM_PRODUTO Código de Produto 1

FM_GRPROD Grupo de Tributação do Produto 2

FM_POSIPI NCM 3

FM_FORNECE+FM_LOJAFOR Fornecedor+Loja Fornecedor 4

FM_GRTRIB Grupo Tributação 5

FM_EST Estado 6

FM_REFGRD Código de Referência da Grade 7

FM_GRPTI Grupo de TES Inteligente 8

FM_GRPCST Código de enquadramento de IPI 9

Para as operações vinculadas com Fornecedor, a ordem padrão do sistema é 1,2,3,4,5,6,7,8,9, onde cada
número representa um campo da tabela SFM, ou seja, a ordem dos campos prioritários é:
FM_PRODUTO, FM_GRPROD, FM_POSIPI, FM_FORNECE+FM_LOJAFOR, FM_GRTRIB, FM_EST, FM_RE
FGRD, FM_GRPTI, FM_GRPCST
Onde o campo com maior prioridade/relevância é o primeiro da esquerda para a direita, e o campo com menor
prioridade/relevância é o último da direita.

Voltando para o exemplo das regras 3 e 4, considerando a ordem padrão do sistema, o TES sugerido seria o
502, pois o Produto (identificação 1) tem maior relevância/prioridade que o Cliente+Loja (identificação 4):
1,2,3,4,5,6,7,8,9,10,11

Caso seja necessário alterar esta ordem de campos, basta alterar o conteúdo do parâmetro MV_OTICLI para
operações com clientes, e parâmetro MV_OTIFOR para operações com fornecedores.

Ainda neste exemplo, se quisermos alterar a ordem de prioridade padrão do sistema, dando maior prioridade
para Cliente ao invés do Produto, devemos preencher o parâmetro MV_OTICLI da seguinte maneira:
{4,1,2,3,5,6,7,8,9,10,11}.
Veja que o identificador do Cliente+Loja (4) é o primeiro da ordem, neste caso, o TES sugerido seria o 503, já
que o Cliente possui maior relevância que o Produto. O mesmo procedimento é válido para o
parâmetro MV_OTIFOR para as operações vinculadas com fornecedor.

Se por algum motivo a ordem prioritária dos campos definida pelo cliente não desempatar este conflito de
regras, o desempate será feito pela ordem padrão do sistema.

Critério de Sugestão de TES - Regras Duplicadas

Na situação onde existirem regras cadastradas de TES inteligente, onde as mesmas informações se repetem
mudando somente o código do TES, teremos um conflito que não poderá ser resolvido por nenhum dos
critérios citados acima. Para esta situação nenhum TES será sugerido, pois existem regras repetidas. Abaixo
um exemplo deste cenário:
Regra número 5
Tipo de Movimentação TES Produto

02 600 BBBB

Regra número 6
Tipo de Movimentação TES Produto

02 601 BBBB

Analisando as regras acima em uma Simples Remessa de Material movimentando o produto "BBBB", ambas
regras possuem a mesma quantidade de informações enquadradas no documento fiscal, que é o Código de
Produto. Para esta situação nem o TES 600 e nem o TES 601 será sugerido, pois neste caso entendemos que
existem regras de TES Inteligentes duplicadas, ficando sem nenhum critério de desempate.
 Estas regras deverão ser reavaliadas pelo cliente.

Orientações de Preenchimento de Regras

• A orientação no cadastro de TES Inteligente, é que não sejam criadas regras duplicadas, pois estas regras não
serão atendidas, e não haverá sugestão de TES nestas situações;
• Analisar a prioridade e relevância dos campos do cadastro da TES inteligente de acordo com necessidade,
verificando os parâmetros MV_OTICLI e MV_OTIFOR, pois a ordem dos campos definida nestes parâmetros
será considerada para resolver possíveis conflitos de regras (regras não duplicadas);
• Atentar que o TES será sugerido na escrituração do documento fiscal considerando primeiramente o critério de
regra de TES Inteligente mais específica, e em caso de conflito de regras genéricas, o critério de desempate
será pela ordem dos campos mais prioritários;
• Sempre que possível realizar cadastro de regras com maior quantidade de informações, evitando assim
conflitos das regras;
• Se existir determinada regra cadastrada e o TES não for sugerido na escrituração do documento fiscal, poderá
ser pelo motivo de ser uma regra duplicada, ou então poderá ser pelo motivo de alguma informação não ter
sido enquadrada com as informações do documento fiscal.
• As regras duplicadas serão sempre desconsideradas

Importante:
As regras e validações descritas neste boletim são válidas com a rotina MATA089 com data a maior ou igual a
17/05/2016.

Informações Técnicas
Tabelas Utilizadas SFM - Tes Inteligente

Funções Envolvidas MATA089 - Cadastro de TES Inteligente

Sistemas Operacionais Windows®/Linux®