TES Protheus: o que é e o que muda
O que é a TES no Protheus, o que ela ainda controla, como o sistema escolhe a TES (produto, TES inteligente, exceção fiscal), o que sai para o Configurador de Tributos e o prazo da 12.1.2710.

A TES, Tipo de Entrada e Saída, é o cadastro que diz ao Protheus o que acontece com cada operação de compra, venda, remessa ou devolução: se gera duplicata, se movimenta estoque, qual CFOP vai para a nota, se o bem entra no ativo e, durante vinte anos, quais tributos calcular e escriturar. Em 2026 essa última parte está mudando de lugar. A TOTVS confirmou que a configuração fiscal da TES está sendo descontinuada, que o Configurador de Tributos é o único lugar onde IBS, CBS e Imposto Seletivo existem, e que a convivência entre os dois modelos vai até a release 12.1.2710. O cadastro de TES não acaba: ele continua como integrador entre os módulos.
Este guia explica o que a TES é e o que ela controla, como o Protheus escolhe a TES de cada item (cadastro do produto, TES inteligente e exceção fiscal), o que sai dela para o Configurador e o que fica, o ciclo de vida que a TOTVS publicou, as perguntas que a própria TOTVS respondeu na FAQ oficial, como cadastrar uma TES hoje e o que o gestor de TI decide antes da migração. A WeePulse trabalha exatamente nesse ponto: levantar, migrar e validar, no Protheus que já está em operação.
O que é a TES no Protheus?
TES é a sigla de Tipo de Entrada e Saída, o cadastro do Protheus (rotina MATA080, tabela SF4) que classifica cada operação com mercadorias e serviços e define o comportamento do sistema para ela: geração de título financeiro, atualização de estoque e de custo, CFOP, texto padrão da nota, poder de terceiros, ativo fixo, CIAP e, no modelo legado, o cálculo e a escrituração de ICMS, IPI, ISS, PIS e Cofins.
A TES é informada no item do documento. Toda nota de entrada e toda nota de saída do Protheus passam por ela, e é por isso que erro de TES vira erro de estoque, de financeiro e de livro fiscal ao mesmo tempo. O código tem três posições alfanuméricas e o primeiro dígito define a direção:
| Faixa de código | O que representa |
|---|---|
| 000 a 500 | Entradas (compras, devoluções de venda, remessas recebidas) |
| 501 a 999 | Saídas (vendas, devoluções de compra, remessas, transferências) |
Como o campo aceita letras nas duas últimas posições, a combinação de um número com duas letras dá 2.500 códigos possíveis só nas entradas, segundo a própria Central de Atendimento da TOTVS. Na prática, empresas grandes acumulam centenas de TES, e boa parte delas existe só porque, no modelo antigo, cada variação fiscal exigia uma TES nova.
O que a TES controla
Vale separar o cadastro em dois grupos, porque é essa separação que a TOTVS está fazendo:
| Grupo | O que define | Situação em 2026 |
|---|---|---|
| Integração entre módulos | Gera duplicata, atualiza estoque, atualiza preço de compra, material de consumo, poder de terceiros, entrega futura, TES de devolução, TES de retorno e remessa simbólica, transferência entre filiais, ativo fixo, CIAP, comissão, condição de pagamento, texto padrão, CFOP, natureza da operação na NFS-e, movimentação física, bonificação | Permanece na TES |
| Regra fiscal | Cálculo, base, crédito, alíquota e escrituração de ICMS, IPI, ISS e, para os tributos novos, IBS, CBS e IS | Vai para o Configurador de Tributos; IBS, CBS e IS só existem lá |
A Central de Atendimento publicou a lista dos campos que permanecem ativos no cadastro com a função exclusiva de integração, a partir da release 12.1.2510. Entre os que mais importam para a operação:
| Campo | Função |
|---|---|
| F4_TIPO | Tipo da TES (entrada ou saída) |
| F4_DUPLIC | Gera duplicata no Financeiro |
| F4_ESTOQUE | Atualiza estoque |
| F4_CF | Código fiscal da operação (CFOP) |
| F4_TEXTO | Texto padrão da nota |
| F4_PODER3 e F4_SLDNPT | Poder de terceiros e saldo em terceiros |
| F4_UPRC | Atualiza preço de compra |
| F4_CONSUMO | Material de consumo |
| F4_CIAP, F4_CIAPTRB e F4_AJUSTE | Livro CIAP e ajustes |
| F4_ATUATF e F4_BENSATF | Atualiza ativo e desmembra itens no ativo |
| F4_TESDV, F4_TESP3 e F4_TESE3 | TES de devolução, de retorno simbólico e de remessa simbólica |
| F4_TRANFIL e F4_TRANSIT | Transferência entre filiais e em trânsito |
| F4_EFUTUR | Entrega futura |
| F4_PAGCOM e F4_CODPAG | Comissão e condição de pagamento |
| F4_TIPOPER | Tipo de operação |
| F4_NATOPNF | Natureza da operação na NFS-e |
| F4_CFPS | Código fiscal de prestação de serviço |
| F4_MSBLQL | Bloqueio da TES |
A mesma lista mantém, por enquanto, os campos de PIS e Cofins do cadastro (CST, alíquota majorada, natureza de receita, F100 da EFD Contribuições, crédito, redução de base, Zona Franca). O motivo está no ciclo de vida: a TOTVS decidiu manter o cadastro ativo em 2026 justamente porque PIS e Cofins acabam em janeiro de 2027, e não fazia sentido pedir que os clientes migrassem o cálculo de tributos em extinção.
Como o Protheus escolhe a TES de um item
Quem opera o sistema conhece três mecanismos, e todos continuam funcionando para a parte de integração:
- Cadastro do produto. O campo B1_TS do produto sugere a TES padrão na inclusão do item. É o caminho mais simples e o mais comum em operações pequenas.
- TES inteligente (MATA089). Regras que sugerem a TES a partir do tipo de operação, do cliente ou fornecedor e do produto. No pedido de venda, a sugestão só acontece se o tipo de operação for informado no item, no campo C6_OPER; sem ele, o sistema não aplica a regra. A Central também avisa que os campos de CFOP que aparecem na rotina (FM_CFO_O e FM_CFO_I) foram criados para um projeto fora do Brasil, estão obsoletos no dicionário nacional e devem ser ignorados.
- Exceção fiscal (MATA540). Regras por grupo de tributação do produto (campo B1_GRTRIB), UF e tipo de cliente ou fornecedor, que sobrepõem alíquotas, margens, pautas e reduções do ICMS, do IPI, do PIS e da Cofins. Só funciona vinculada a um produto.
Aqui está a primeira mudança prática. Pela FAQ oficial, a TES inteligente continua disponível para a função de integração, mas não pode mais ser usada como critério de decisão fiscal, e o campo “Tipo de Operação” foi levado para o Configurador para que o conceito continue existindo lá. A exceção fiscal, as regras UF x UF, os parâmetros MV_ de tributos e os campos fiscais dos cadastros de cliente, fornecedor e produto entram na lista do que o Configurador substitui.
O ciclo de vida da TES, segundo a TOTVS
O Espaço Legislação da TOTVS publicou a linha do tempo oficial:
| Ano | Marco |
|---|---|
| 2021 | Configurador de Tributos passa a existir como motor de cálculo do Protheus |
| 2022 | Todo novo cálculo de tributo passa a ser disponibilizado somente pelo Configurador |
| 2024 | Adequação dos campos fiscais da TES para o Configurador e para as mudanças da Reforma Tributária |
| Março de 2025 | Os IDTOTVS de CBS, IBS Estadual, IBS Municipal e IS ficam disponíveis no Configurador, única opção para os tributos novos |
| 2025 | Aviso nas rotinas sobre o planejamento para a Reforma, com os novos modelos de cálculo atendidos exclusivamente pelo Configurador |
| 2026 | Transição completa planejada até a expedição da release 12.1.2710, quando todas as operações fiscais estarão suportadas pelo Configurador para todos os clientes |
Dois recados acompanham a linha do tempo. O ciclo do cadastro de TES é respeitado para as operações existentes, mas o novo modelo de tributação e as novas regras dos tributos existentes são atendidos exclusivamente pelo Configurador. E a decisão de manter o cadastro ativo em 2026 está associada à extinção de PIS e Cofins em janeiro de 2027 e à alteração do comportamento do IPI no mesmo ano.
A pergunta que mais chega aos projetos é se a TES acaba na 12.1.2610. Não acaba. A release de outubro entrega o otimizador de perfis tributários e facilitadores para levar regras ao Configurador, e o marco de convivência publicado é a 12.1.2710. O que vale desde já: IBS, CBS e IS só são configurados no Configurador, e quem precisa de IBS e CBS na base do ICMS tem que calcular tudo pelo Configurador, porque a TOTVS não vai adaptar a solução híbrida para esse caso. O restante das mudanças da release está no guia da 12.1.2610.
O que a FAQ oficial responde
A TOTVS mantém no TDN uma FAQ sobre a descontinuação das operações fiscais da TES, atualizada em 8 de junho de 2026. As respostas que decidem o projeto:
- Por que descontinuar. A configuração fiscal da TES tem estrutura antiga, baseada em combinações UF x UF e exceções fiscais, limitada para os desafios atuais. Os campos de integração permanecem.
- 100 TES viram 100 regras? Não necessariamente. O Configurador usa lógica parametrizável e reduz a necessidade de múltiplas regras.
- Existe migração automática? Não. As configurações da TES não são migradas; a empresa parametriza as operações no Configurador, com apoio de facilitadores e simuladores.
- Os tributos novos estão na TES? Não. Desde março de 2025 estão só no Configurador. A recomendação é cadastrar perfis genéricos com as regras de 2026 em homologação, ou na opção de regras de homologação na base de produção, usando os simuladores.
- A TES deixa de calcular em 2026? Não. O Configurador trabalha de forma híbrida com o motor legado, mas gerenciar os dois será complexo e a TOTVS concentra atualização e suporte no novo modelo. Quem não migrar pode ter problemas de cálculo, emissão e apuração, e futuras atualizações do Protheus não serão compatíveis com a TES.
- Custo da mercadoria. O Configurador ganhou a aba “Estoque / Custos” para definir o comportamento dos impostos no custo e na contabilização.
- Natureza financeira. As retenções tratadas hoje na natureza financeira também vão para o Configurador.
- Contabilização. Os lançamentos padrão passam a ler a tabela do Configurador. Se as regras de LP usam campos da SF4, há impacto e elas precisam ser revistas; se usam SD1, SD2 ou SFT sem vínculo com a SF4, não há.
- Campos e customizações da TES. Cada um é analisado individualmente; as fórmulas do Configurador reduzem a necessidade de customização.
- O que o Configurador substitui. Todos os cadastros de cálculo, escrituração e apuração: natureza financeira, UF x UF, exceção fiscal, parâmetros MV_ e campos fiscais de cliente, fornecedor e produto.
- Integração com outros módulos. Não muda. Os campos de integração com Faturamento, Compras, Estoque, Financeiro e Ativo Fixo continuam na TES; a contabilidade pede avaliação individual.
- IBS e CBS na base do ICMS a partir de 2027. Tributos calculados pelo Configurador não servem de base de dedução para tributos das rotinas legadas. Quando IBS e CBS precisarem compor a base do ICMS, o cálculo inteiro vai para o Configurador, sem adaptação da solução híbrida.
Como cadastrar uma TES hoje
Com a parte fiscal migrando, cadastrar uma TES virou um exercício de integração. O que conferir, campo a campo, na inclusão pela MATA080:
- Código e tipo. Primeiro dígito de 0 a 4 para entrada e de 5 a 9 para saída; o restante segue o padrão de nomenclatura da empresa. Confira se já não existe uma TES idêntica antes de criar.
- Financeiro. Gera duplicata ou não. Remessas, devoluções e transferências normalmente não geram.
- Estoque e custo. Atualiza estoque, atualiza preço de compra, material de consumo, poder de terceiros e saldo em terceiros. Erro aqui aparece no inventário e no custo médio.
- Ativo. Atualiza ativo, desmembra itens, CIAP e tributação do CIAP para bens do imobilizado.
- Fiscal de integração. CFOP, texto padrão, natureza da operação na NFS-e e código fiscal de prestação de serviço.
- Ciclo da operação. TES de devolução, de retorno e de remessa simbólica, entrega futura, transferência entre filiais e em trânsito, bonificação.
- Comercial. Paga comissão e condição de pagamento.
- Regra fiscal. Para ICMS, IPI e ISS já migrados, e para IBS, CBS e IS sempre, a regra não está na TES: está no Configurador de Tributos, amarrada ao perfil tributário do produto, do participante e da operação.
Depois, vincule a TES ao produto (B1_TS) ou crie a regra de TES inteligente com o tipo de operação, e teste com um documento em homologação, conferindo título, estoque, CFOP e, na nota, os grupos de tributo gerados pelo Configurador.
Erros comuns na TES
- TES duplicada para a mesma operação. Resultado do modelo antigo, em que cada variação de alíquota pedia uma TES nova. Com o fiscal no Configurador, boa parte delas pode ser unificada.
- Produto sem TES padrão e sem regra inteligente. O usuário escolhe na mão e erra. Padronize B1_TS ou a TES inteligente por tipo de operação.
- TES inteligente que não sugere. No pedido de venda, falta o tipo de operação no item (C6_OPER).
- Lançamento padrão lendo a SF4. Depois da migração, a contabilização quebra. Revise as regras de LP que dependem de campos fiscais da TES.
- Dois motores para o mesmo tributo. Regra na TES e no Configurador ao mesmo tempo confunde a escrituração. Migre tributo a tributo, com data, e desligue a regra antiga.
- Exceção fiscal que ninguém documentou. Ela sobrepõe alíquota e base sem aparecer na TES. Levante as exceções por grupo de tributação antes de recriar as regras.
- Customização no cadastro. Campos e pontos de entrada da MATA080 que alimentam integrações precisam ser avaliados um a um.
O que o gestor de TI decide antes de migrar
- Inventário de TES. Quantas existem, quantas estão em uso nos últimos doze meses e quantas só variam no fiscal. Esse número define o tamanho do projeto.
- O que já saiu da TES. IBS, CBS e IS estão no Configurador desde 2025; confira se a emissão com os tributos novos já roda pelo FISA170 em produção.
- Ordem de migração. ICMS e IPI primeiro, por serem permanentes; PIS e Cofins por último ou nunca, porque acabam em janeiro de 2027, salvo quando IBS e CBS entram na base do ICMS e obrigam o cálculo integral no Configurador.
- Release e prazo. A convivência vai até a 12.1.2710. Quem está na 2510 ou vai para a 2610 tem a janela de 2026 e 2027 para terminar; quem está em release expirada precisa resolver a atualização antes.
- Contabilidade e integrações. Lançamentos padrão com SF4, extratores, BI e sistemas externos que leem a TES para obter dados fiscais entram no escopo.
- Dono das regras. Quem cadastra perfis e regras no Configurador, quem aprova e quem valida contra o histórico de escrituração.
- Métrica de aceite. Nota emitida em homologação com os mesmos tributos, base e crédito do modelo antigo, para cada cenário de TES migrado.
Roteiro de migração da TES para o Configurador
- Levantamento (semanas 1 e 2): inventário das TES em uso, exceções fiscais, regras UF x UF, parâmetros e campos fiscais de produto, cliente e fornecedor; mapeamento de LPs e integrações que leem a SF4.
- Desenho (semanas 2 a 4): perfis tributários de produto e participante, uso do otimizador de perfis da 2610, regras por tributo e por operação, aproveitando o “Tipo de Operação” migrado e as fórmulas.
- Homologação (semanas 4 a 8): regras em ambiente dedicado ou na opção de regras de homologação da base de produção, com os simuladores; comparação nota a nota com o cálculo antigo, inclusive ICMS ST e regras de escrituração.
- Virada por tributo (semanas 8 a 12): ICMS e IPI com data de início no Configurador e data de fim na TES; ajuste dos lançamentos padrão; compartilhamento das tabelas entre empresas e filiais.
- Limpeza (a partir da semana 12): unificação das TES que só variavam no fiscal, bloqueio das obsoletas, documentação do cadastro integrador.
- 2027: PIS e Cofins com data de fim em 31 de dezembro de 2026, nunca excluídos; CBS, IBS e IS com as alíquotas do ano, como detalha o guia da Reforma Tributária 2027 no Protheus.
É aqui que entra a WeePulse. Fazemos o inventário, desenhamos os perfis e as regras, conduzimos a homologação comparando os números e viramos tributo a tributo, no Protheus que já está em operação. Conheça a consultoria Protheus da WeePulse.
Perguntas frequentes sobre a TES no Protheus
O que é TES no Protheus?
Tipo de Entrada e Saída, o cadastro (rotina MATA080, tabela SF4) que classifica cada operação e define se gera duplicata, se movimenta estoque, qual CFOP vai para a nota, como trata ativo, CIAP e poder de terceiros e, no modelo legado, como calcula e escritura os tributos.
Qual a diferença entre TES de entrada e de saída?
O primeiro dígito do código. De 000 a 500 são entradas; de 501 a 999 são saídas. As demais posições podem ser letras, o que amplia as combinações possíveis.
A TES vai acabar?
Não. A TOTVS descontinua a configuração fiscal da TES, não o cadastro. Os campos de integração com Faturamento, Compras, Estoque, Financeiro e Ativo Fixo permanecem, e a rotina MATA080 segue como integradora entre os módulos.
Até quando a TES calcula imposto?
A convivência entre a TES e o Configurador de Tributos vai até a release 12.1.2710. A decisão está ligada à extinção de PIS e Cofins em janeiro de 2027. Desde 2025 a orientação da TOTVS é migrar para o Configurador, e os tributos novos só existem lá.
IBS e CBS podem ser configurados na TES?
Não. Desde março de 2025, CBS, IBS Estadual, IBS Municipal e IS existem apenas no Configurador de Tributos.
A migração da TES para o Configurador é automática?
Não. A empresa parametriza as operações no Configurador, com facilitadores e simuladores. Cem TES não viram necessariamente cem regras.
O que é TES inteligente?
A rotina MATA089, que sugere a TES a partir do tipo de operação, do cliente ou fornecedor e do produto. Continua disponível para integração, mas não é mais critério de decisão fiscal; o tipo de operação foi levado para o Configurador.
O que é exceção fiscal?
A rotina MATA540, que define alíquotas, margens, pautas e reduções por grupo de tributação do produto, UF e tipo de cliente ou fornecedor, sobrepondo a regra geral. Está na lista do que o Configurador substitui.
A TES acaba na 12.1.2610?
Não. A release de outubro de 2026 entrega facilitadores de migração, como o otimizador de perfis tributários, e o marco de convivência publicado é a 12.1.2710.
O que muda na contabilização?
Os lançamentos padrão passam a ler a tabela do Configurador. Regras de LP que usam campos da SF4 precisam ser revistas; as que usam SD1, SD2 ou SFT sem vínculo com a SF4 não são afetadas.
Posso manter ICMS na TES e IBS e CBS no Configurador?
A solução híbrida funciona, mas tributos calculados pelo Configurador não servem de base de dedução para os das rotinas legadas. Quando IBS e CBS compõem a base do ICMS, o cálculo precisa ser integral no Configurador.
Preciso de consultoria para migrar a TES?
Não é obrigatório, mas o inventário das TES, a tradução das exceções fiscais em perfis e regras e a validação dos números são onde o projeto ganha ou perde tempo. Um parceiro TOTVS com prática no Configurador encurta esse caminho.
Conclusão
A TES não morre; ela emagrece. O que era um cadastro que fazia tudo vira um cadastro de integração, e a regra fiscal muda para o Configurador de Tributos, onde IBS, CBS e Imposto Seletivo já moram. O prazo publicado é a 12.1.2710, mas a conta começa agora: quem levanta as TES, separa integração de regra e migra tributo a tributo chega a 2027 com a operação íntegra. Quem espera a release descobre o tamanho do cadastro no pior momento.
Se a sua empresa ainda não sabe quantas TES tem, ou tem IBS e CBS no Configurador e ICMS na TES sem um plano de virada, a WeePulse ajuda, do inventário à sustentação, no Protheus que já está em operação.
Fontes oficiais
- TDN: FAQ, Descontinuação das operações fiscais da TES e adoção do Configurador de Tributos, atualizada em 8 de junho de 2026.
- Central TOTVS: FISA170, campos da TES que permanecem com a implantação do Configurador de Tributos, a partir da release 12.1.2510.
- TOTVS Espaço Legislação: Protheus Reforma Tributária, ciclo de vida da TES.
- Central TOTVS: Criação de TES, possibilidades e quantidades.
- Central TOTVS: Livros Fiscais, Exceção Fiscal (MATA540).
- Central TOTVS: SIGAFAT, uso da TES Inteligente no pedido de venda e campos de CFOP na TES inteligente (MATA089).
- TDN: CFGTRIB, Configurador de Tributos P12.


