Erpworks

Configurador de Tributos · Migração

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

Centenas de TES, várias filiais e um prazo que não se move: IBS e CBS já só calculam no Configurador, e a convivência com a TES acaba na 12.1.2710. O que a TOTVS oferece para a migração, o que ela não faz por você e como montar o projeto sem multiplicar regras.

Revisado tecnicamente em 27/09/2026 · Por , Fundador e Gestor Executivo da Erpworks

Dois profissionais analisando em uma tela grande muitos blocos sendo agrupados em poucos grupos organizados

Este artigo faz parte do guia da Reforma Tributária no Protheus, com o calendário da transição, o que muda em 01/01/2027 e o checklist por área.

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:

ComponenteO que defineRotina
Perfil de produtoProdutos e origem da mercadoriaFISA166
Perfil de participanteClientes e fornecedoresFISA164
Perfil de operaçãoCFOPs e, se usado, o tipo de operaçãoFISA165
Perfil de origem e destinoUFs de origem e de destinoFISA163
Regra de cálculoTributo, base, alíquota, escrituração e vigênciaFISA160, com base (FISA161), alíquota (FISA162) e escrituração (FISA160J)

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

  • A TOTVS não converte a TES em regras: a migração é levantamento, agrupamento e homologação.
  • A regra só calcula quando os quatro perfis enquadram; sem enquadramento, a nota volta a ser calculada pela TES sem aviso.
  • O levantamento parte das combinações de TES, CFOP, NCM, participante e UF usadas nas notas, não do cadastro.
  • A convivência com a TES vai até a 12.1.2710, mas IBS e CBS já só calculam no Configurador.

Próximo passo: levantar as combinações realmente usadas nas notas e montar os perfis a partir delas, antes de criar a primeira regra.

Fontes e referências

  1. TDN: perguntas frequentes sobre a descontinuação da TES.
  2. TDN: Configurador de Tributos, rotinas e tabelas.
  3. TDN: boas práticas para perfis do Configurador.
  4. TDN: boas práticas para regras de cálculo.
  5. TDN: relatório de análise de regras legadas (OperationReport).
  6. TDN: Otimizador de Perfis Tributários de produtos.
  7. TDN: Simulador de Operação.
  8. TDN: compartilhamento de tabelas do Configurador.
  9. TDN: campos que permanecem na TES.

Perguntas frequentes

Principais dúvidas sobre o tema

A TOTVS migra a TES automaticamente para o Configurador de Tributos?

Não. A TOTVS informa que as configurações da TES não serão migradas automaticamente. Ela oferece facilitadores, o Otimizador de Perfis, simuladores e um relatório de apoio ao levantamento.

Até quando a TES pode calcular impostos no Protheus?

A convivência da TES com o Configurador vai até a release 12.1.2710, ligada à extinção do PIS e da Cofins em janeiro de 2027. IBS, CBS e Imposto Seletivo já só são calculados no Configurador.

Preciso de uma regra no Configurador para cada TES?

Não. O número de regras depende das combinações de tributo, perfil e comportamento, não do número de TES. Reaproveitar regras de base e usar alíquota por NCM reduz bastante o total.

O que acontece se a nota não enquadrar em nenhuma regra?

O sistema volta aos cadastros tradicionais e calcula pela TES, sem avisar. Por isso a homologação precisa conferir se o cálculo veio mesmo do Configurador.

Como saber quais TES estão em uso?

Pelas notas e pelo livro fiscal: campos D1_TES, D2_TES, FT_TES, os CFOPs e o NCM dos produtos. A TOTVS disponibiliza o relatório OperationReport, que agrupa essas combinações e conta as notas de cada uma.

Nota: este conteúdo tem finalidade informativa. Questões contratuais, tributárias ou jurídicas devem ser validadas com os responsáveis da sua empresa.

Empresas que confiam na Erpworks

AbbottUnimaq John DeereRocheAcerGrupo HinodeState Grid BrazilCristáliaMercadoCarNuveenLocomotivaNorsulRede Santa CatarinaAlubarSiem OffshoreGama ItalyOfnerGeneral WaterQuickeDrew MarineCleartechLMG AllianceAnhembiSMC
Alfa ElevadoresEmplamoldGrupo NáuticaLuminiMorandinNovitàValvugasYamá CosméticosEcobrazGamaroGrupo In PressEVSAFortbrase-valEco UrbisAmend CosméticosAlkhemyLabLaboratório ExatoOptitexSomos PremiumAVLFLC Plásticos e Locomotiva

Próximo passo

Muitas TES, várias filiais e prazo até a 12.1.2710?

A Erpworks levanta as combinações de TES, CFOP e NCM da movimentação real do seu Protheus e conduz a montagem dos perfis, das regras e a homologação.

Falar com um especialista