Migração da TES para o Configurador de Tributos em operações grandes: como levantar, agrupar e homologar

O que muda e até quando

A TES continua existindo, mas deixa de calcular tributos: ela vira um cadastro integrador entre os módulos, e o cálculo e a escrituração passam para o Configurador de Tributos. IBS, CBS e Imposto Seletivo só podem ser configurados nele desde março de 2025. Para os demais tributos, a TOTVS mantém a convivência com a TES até a release 12.1.2710, marco ligado à extinção do PIS e da Cofins em janeiro de 2027. Pela regra de nomes das releases, a 2710 deve sair em outubro de 2027, mas a data ainda não foi publicada.

O ponto que muitos projetos descobrem tarde está na FAQ oficial da TOTVS: "As configurações da TES não serão migradas automaticamente." Não existe conversor de TES para regras. O que existe são facilitadores, simuladores e relatórios de apoio, e o trabalho de decidir como agrupar as operações continua sendo da empresa.

Duas situações antecipam a migração. Se o ICMS precisa considerar IBS e CBS na base, o cálculo inteiro tem de ir para o Configurador, e a TOTVS informa que não vai adaptar o modelo híbrido para isso. E os ajustes automáticos de PIS e Cofins da LC 224/2025 só funcionam para notas calculadas pelo Configurador.

Como o Configurador enquadra uma nota

O Configurador fica no módulo Livros Fiscais (Atualizações, Facilitadores, Configurador de Tributos). Uma regra de cálculo só é aplicada quando os quatro perfis dela enquadram a operação ao mesmo tempo:

Se a nota não enquadra nos quatro perfis de nenhuma regra, o sistema volta aos cadastros tradicionais e calcula pela TES, sem avisar. Um perfil mal montado não aparece como erro: aparece como cálculo pelo legado. Os valores calculados pelo Configurador ficam na tabela F2D, ligados ao item da nota pelos campos D1_IDTRIB e D2_IDTRIB.

Passo 1: levantar o que está em uso

A pergunta certa não é quantas TES existem no cadastro, mas quais combinações aparecem de fato nas notas. A própria TOTVS lembra que ter 100 TES não significa precisar de 100 regras. Os dados para esse levantamento estão nas notas e no livro fiscal:

• TES e CFOP de cada item: D1_TES e D1_CF nas entradas, D2_TES e D2_CF nas saídas, e FT_TES e FT_CFOP no livro fiscal.
• Tipo de operação, quando a empresa usa: D1_OPER e D2_OPER.
• NCM do produto (B1_POSIPI), origem da mercadoria, participante e UF.

A TOTVS disponibiliza um relatório de apoio para isso, o OperationReport, que agrupa o livro fiscal por UF, CFOP, participante, origem, produto e TES, conta as notas de cada combinação e exporta para planilha. A documentação avisa que ele pode demorar em volumes grandes e gerar arquivos pesados. O Smart View de listagem de movimentos também mostra TES, CFOP e NCM por item. Em bases com anos de movimento, o que costuma funcionar é um levantamento a partir da movimentação real, que já entrega as combinações ranqueadas por volume e risco.

Passo 2: agrupar em perfis

• Produto: agrupe por NCM, tipo, destinação ou tratamento tributário (ST, redução de base, majoração). Na inclusão, todas as origens vêm marcadas, e as que não se aplicam precisam ser retiradas.
• Participante: agrupe por tipo, como contribuinte, não contribuinte, consumidor final e revendedor, ou por dentro e fora do estado.
• Operação e origem e destino: parta da carga automática de CFOPs e UFs que o Configurador faz no primeiro acesso e ajuste. O CFOP do perfil tem de bater com o CFOP que vem da TES usada na nota, porque a TES continua fornecendo o CFOP.

Para o volume, há três ferramentas. Os facilitadores incluem ou excluem registros em lote por filtro, mas não trazem produtos bloqueados nem participantes inativos. O Otimizador de Perfis Tributários, destaque da 12.1.2610, mantém o perfil atualizado sozinho a partir de um filtro salvo em campos como NCM, tipo, grupo, origem e grupo tributário do produto. E o perfil de produto aceita carga por execução automática, para quem prefere montar por programa.

Passo 3: o menor número de regras

• Reaproveite a mesma regra de base em várias regras de cálculo.
• Em mercadorias, use a alíquota por NCM (regras por NCM) em vez de uma regra por alíquota manual.
• Separe em regras diferentes só o que tem comportamento diferente, como o mesmo NCM com e sem substituição tributária.
• Amarre cada regra a uma regra de escrituração. Sem ela, livro, CST e total da nota continuam vindo da TES.

Muitas filiais: compartilhamento

O Configurador tem regras rígidas de compartilhamento de tabelas. Os perfis precisam estar no mesmo nível entre si, e as regras de cálculo, base, alíquota e fórmulas também. Uma configuração mista quebra o cálculo por inteiro. A TOTVS orienta definir o compartilhamento na implantação e não alterá-lo depois. A carga automática de regras de CBS e IBS roda filial por filial, e rodá-la de novo cria regras adicionais.

Passo 4: homologar antes de aprovar

Toda regra nasce com o status em teste e só passa a valer em nota real depois de aprovada. Uma regra aprovada não volta para teste. Enquanto está em teste, ela pode ser validada em duas ferramentas: o Simulador de Operação, que tem uma central de diagnóstico para explicar por que uma regra não enquadrou, e o Simulador Comparativo, que pega uma nota já lançada e compara o que foi calculado com o que as regras calculariam. Os dois ainda atendem só operações simples, então devoluções, beneficiamento e complementos precisam de roteiro próprio em base de homologação.

Armadilhas documentadas

• Perfil com "TODOS" somado a códigos individuais fazia a regra ser processada mais de uma vez. Cadastros antigos precisam ser saneados.
• Com regra de escrituração que tem incidência, o livro é gravado mesmo que a TES não tenha livro: os campos de livro da TES passam a ser ignorados.
• No modelo híbrido, se a TES agrega o imposto ao total e o Configurador também, o valor sai em dobro.
• Regra financeira e regra de apuração no mesmo tributo geram recolhimento duplo.
• A carga de CBS e IBS nasce com vigência até 31/12/2026 e precisa ser tratada para 2027.
• Alterar uma regra já usada em nota cria uma nova versão, e a devolução recalcula com a versão da nota original.
• Lançamentos padrão com condições na TES precisam ser revistos, porque os valores do Configurador ficam na F2D.
• O desempenho do Configurador recebeu várias correções em 2026, então a expedição contínua do ambiente precisa estar em dia.

O que muda no cálculo com IBS e CBS está em Configurador de Tributos no Protheus: preparo para IBS e CBS, e o cuidado com a classificação tributária, em cClassTrib, NCM e NBS no Protheus.

Em resumo