Configurador de tributos na prática
No dia 12 de novembro de 2026, a Geeker Company realizou mais um workshop do Geeker Lab — dessa vez com foco no Configurador de Tributos do Protheus, a rotina FISA170. A Fabíola, consultora que já implantou o configurador em vários clientes, foi quem conduziu a sessão. Quem não conseguiu assistir ao vivo vai encontrar aqui os principais pontos abordados.
O assunto interessa a quem trabalha com documentos fiscais no Protheus: analistas fiscais, profissionais de TI, usuários-chave envolvidos em migração e gestores que querem entender o impacto antes que o prazo aperte.
Por que o Configurador existe e o que muda na prática
O Configurador de Tributos (FISA170) surgiu porque as ferramentas tradicionais do Protheus chegaram a um limite. A quantidade de exceções fiscais, benefícios e regras estaduais ficou grande demais para ser tratada só pela TES e pelos parâmetros espalhados pelo sistema.
A diferença central é essa: antes, o Protheus reunia informações de vários lugares — cadastro de cliente, cadastro de produto, campos da TES, parâmetros — e montava o cálculo. Com o Configurador, toda a inteligência tributária fica concentrada em um único ambiente. Quem configura é o próprio cliente, não a TOTVS. Isso traz agilidade para implementar regras novas, mas exige um aprendizado inicial que não é trivial.
Um ponto importante destacado no workshop: quando TES e Configurador coexistem no ambiente, o Configurador prevalece no cálculo. E toda nova implementação tributária no Protheus a partir de 2025 passa por ele. Quanto antes a equipe entender como funciona, mais tranquila fica a migração.
O que sai da TES e vai para o Configurador
A Fabíola foi direta: em vez de listar o que a TES ainda faz, ela preferiu mostrar o que migrou para o Configurador. Tudo que não foi listado continua sendo tratado pela TES ou por outros cadastros.
O que passou para o Configurador:
- As características fiscais de clientes e fornecedores (contribuinte, simples nacional, retém imposto) deixam de ser lidas diretamente nos cadastros. Elas viram perfis de participante. Se chegar um cliente novo, ele precisa ser vinculado manualmente ao perfil correto — o Configurador não vai buscar informação no cadastro do parceiro de negócios.
- O grupo fiscal (exceção fiscal) também serve só de base para criação de perfis.
- A unidade federativa de origem e destino passa a ser tratada pelo perfil de origem e destino dentro do Configurador.
- O CFOP da TES continua sendo lido, mas como variável dentro do perfil de operação.
- CST e livro fiscal migram para a regra de escrituração.
- Redução de base de cálculo e regras de composição de base vão para as regras de base de cálculo por tributo.
- Alíquotas que ficavam em cadastros de cliente, fornecedor, produto ou parâmetros passam para regras de alíquota ou para o cadastro por NCM.
Perfis: o filtro que conecta o documento à regra
Quando o Protheus processa um pedido de venda ou um documento de entrada, ele usa cinco variáveis para encontrar a regra de cálculo correta: CFOP, produto, origem, destino, participante e, quando informado, o tipo de operação. São os perfis que fazem esse filtro.
Existem quatro tipos de perfil:
- Perfil de produto: agrupa produtos por comportamento tributário. Se todos os produtos tiverem o mesmo tratamento, dá para usar o grupo "todos" — e qualquer produto novo já entra automaticamente. O problema aparece quando há cálculos diferentes para o mesmo tributo e o mesmo CFOP: nesse caso, é obrigatório separar os grupos. Produto com redução de base de ICMS não pode ficar no mesmo grupo que produto tributado integralmente, porque a regra do grupo "todos" engloba os dois e o cálculo vai duplicar.
- Perfil de operação: agrupa CFOPs. Também recebe o tipo de operação, que funciona como um filtro extra quando o mesmo CFOP pode ter cálculos diferentes dependendo da finalidade da compra (consumo versus industrialização, por exemplo).
- Perfil de participante: agrupa clientes e fornecedores. A mesma lógica do perfil de produto se aplica aqui: se houver tratamento diferenciado por tributo, os grupos precisam ser segregados.
- Perfil de origem e destino: trata as UFs da operação. É uma carga automática do Protheus com todas as combinações de estados. Quem trabalha com alíquotas por NCM pode usar o perfil "todas" aqui, porque quem define a alíquota por UF é o próprio cadastro de NCM — não o perfil de origem e destino.
Um cuidado prático levantado no workshop: quando o cálculo aparece mas está errado, o problema está nas regras. Quando o cálculo não aparece nem errado, o problema está nos perfis. Essa distinção ajuda muito na hora de debugar.
Cadastro por NCM: vale o esforço?
O cadastro por NCM permite definir alíquotas por tributo, por UF de origem e destino, e por origem do produto (nacional ou importado), tudo em um único lugar. A vantagem principal: quando entra um produto novo com aquele NCM, a alíquota já está correta automaticamente — sem precisar de um perfil de produto por faixa de alíquota.
Sem o cadastro por NCM, seria necessário criar um perfil de produto para cada alíquota diferente. Isso aumenta a complexidade de manutenção: quem cadastra um produto novo precisa saber não só se ele é tributado ou isento, mas também qual a alíquota exata — e aí o risco de erro cresce.
A ressalva é que a carga inicial é trabalhosa, dependendo da quantidade de NCMs e estados envolvidos. Para quem tem muitos produtos com redução de base de ICMS variada, ainda vai precisar de perfis de produto segregados de qualquer forma. A recomendação é sempre estudar o ambiente antes de decidir a abordagem.
O mesmo conceito se aplica ao cadastro de regras por código de serviço, para empresas que operam com prestação de serviço.
Regras de base, alíquota e escrituração
Com os perfis definidos, as regras determinam o que calcular. Há três tipos principais:
- Regra de base de cálculo: define o que compõe a base. Pode ser o valor da mercadoria puro, o valor com deduções ou adições (como somar o valor de outro tributo já calculado), ou uma base com redução percentual. O Configurador oferece atalhos para cenários comuns; quando nenhum atende, existe a opção de fórmula manual, onde é possível combinar variáveis disponíveis no sistema. A regra de base é genérica — uma mesma regra de "valor da mercadoria" serve para ICMS, IPI e qualquer outro tributo que use essa base. Não há necessidade de duplicar.
- Regra de alíquota: pode ser um percentual informado diretamente ou uma referência ao cadastro de NCM (nesse caso, o sistema vai buscar a alíquota no NCM do produto e na UF da operação no momento do cálculo). Também suporta fórmula manual, mas é menos comum.
- Regra de escrituração: define o CST da operação, o livro fiscal em que o tributo será escriturado e, quando aplicável, informações de diferimento (parcial ou total) e desoneração. É aqui que ficará a configuração de como CBS e IBS vão se comportar no total da nota quando o pacote da TOTVS com o novo modelo de DANFE for liberado.
A regra fiscal: onde tudo se junta
A regra fiscal é o último passo e o mais crítico. É onde os perfis e as regras se encontram: para determinada combinação de perfil de operação, perfil de produto, perfil de participante e perfil de origem/destino, o sistema executa a regra de base, aplica a regra de alíquota e usa a regra de escrituração definida.
O erro mais comum mostrado ao vivo no workshop foi exatamente esse: usar o perfil "todos" no produto quando já existe um perfil segregado para o mesmo tributo e o mesmo CFOP. O resultado é o cálculo duplicado — o produto cai nas duas regras ao mesmo tempo. A correção é simples, mas exige disciplina: a partir do momento em que qualquer produto recebe tratamento diferenciado dentro de um tributo, todos os produtos daquele tributo precisam estar em perfis segregados, sem exceção.
Manutenção do dia a dia: o ponto que mais preocupa
Ficou claro no workshop que o maior desafio depois da implantação não é o cadastro inicial — é a manutenção. Toda vez que entra um produto novo ou um cliente novo, alguém precisa saber em qual perfil ele se enquadra para cada tributo.
A prática adotada pela Fabíola é incluir o nome do tributo no nome do perfil — "participantes tributados IPI", "participantes isentos IPI" — para que quem faz a manutenção saiba de cara onde classificar. Se o produto ou cliente não exige perfil segregado para um tributo, ele simplesmente faz parte do "todos" e não precisa de vínculo manual.
O que está gerando mais problema nos ambientes acompanhados: produto ou cliente fora do perfil correto, sem que ninguém perceba até aparecer uma divergência no cálculo.
Perguntas do público
Dá para usar o CBS no cadastro por NCM?
Sim. Qualquer tributo pode ser cadastrado por NCM desde que a alíquota seja padrão para aquele NCM. O CBS pode entrar da mesma forma que ICMS, PIS e COFINS. A observação feita é que muitos clientes que já passaram pela implementação do CBS/IBS não utilizaram o cadastro por NCM para esses tributos, porque a carga automática da TOTVS não foi feita por essa via. Mas tecnicamente é possível.
Como somar CBS e IBS na base de cálculo do ICMS?
A Fabíola montou ao vivo uma regra de base com essa lógica: parte do valor da mercadoria e adiciona o valor calculado do CBS e do IBS usando a opção de fórmula manual, referenciando os tributos pelo campo de regra de tributo. Ela sinalizou que a conferência do resultado gerou dúvida — a base do CBS já desconta o ICMS por definição, então somar o CBS de volta na base do ICMS cria uma conta circular que precisa ser analisada com calma para confirmar se o cálculo esperado é mesmo esse. O mecanismo funciona no Configurador; o que precisa de validação é a lógica tributária que justifica o cenário.
O que acontece com a regra de escrituração do CBS/IBS quando o CBS/IBS passar a somar no total da nota?
No momento do workshop, o pacote da TOTVS com o novo modelo de DANFE ainda não havia sido liberado. A expectativa é de que a alteração passe pela regra de escrituração, da mesma forma que o IPI tem um indicador que define se ele soma no total da nota e na duplicata.
Quer ver cada um desses pontos na prática, com o sistema aberto e os cliques sendo feitos ao vivo? A gravação completa está disponível.





