IBS Municipal no CFGTRIB no Protheus: CFGTRIB e TSS

# IBS Municipal no CFGTRIB no TOTVS Protheus

Visão geral

Cadastro e cálculo do IBSMUN é um tema diretamente ligado à implantação do IBS e da CBS nos documentos fiscais eletrônicos. No Protheus, a análise não deve começar pela tentativa de alterar parâmetros até a nota autorizar. O procedimento profissional é identificar a regra fiscal da operação, rastrear a parametrização utilizada, reconstruir o cálculo e comparar o resultado com o XML efetivamente transmitido.

O ponto de atenção deste tema é: O componente municipal do IBS precisa de cadastro e regras próprias. A documentação pesquisada indica o seguinte direcionamento específico: A TOTVS identifica IBSMUN como tributo municipal em sua documentação de configuração para importação.

Do ponto de vista técnico, concentre a investigação em tributo municipal, regra de cálculo, escrituração e integração. A tag ou grupo de referência para localizar o problema no documento é IBSMUN quando aplicável.

Contexto da Reforma Tributária em 2026

A Receita Federal informa que 2026 é o ano de teste da CBS e do IBS. Os contribuintes abrangidos devem adaptar documentos fiscais eletrônicos aos leiautes definidos nas respectivas Notas Técnicas. Ao mesmo tempo, RFB e CGIBS anunciaram flexibilização das regras que provocariam rejeição pela simples ausência de campos IBS/CBS em determinados DF-e.

Essa flexibilização precisa ser interpretada corretamente: ausência de informação e informação transmitida de forma inconsistente são situações diferentes. Se o Protheus gerar grupos IBS/CBS, CST, cClassTrib, bases, percentuais ou valores, a empresa deve manter coerência entre enquadramento fiscal, parametrização, cálculo e XML.

Onde a informação nasce no Protheus

Uma investigação consistente percorre uma cadeia: operação → cadastros → regra fiscal → CFGTRIB → cálculo → escrituração → documento eletrônico → TSS → SEFAZ. Pular etapas costuma produzir correções temporárias.

No Configurador de Tributos, identifique a Regra de Cálculo efetivamente acionada e a Regra de Escrituração associada. Confira vigência, tributo, incidência, condições, classificação e eventuais regras de alíquota, redução ou diferimento. Quando houver cClassTrib, valide a versão da tabela e seus indicadores.

CST e cClassTrib

CST e cClassTrib precisam ser analisados em conjunto. Os indicadores vinculados a esses códigos determinam se determinados grupos devem existir, podem existir ou não devem ser gerados. As rejeições 1021, 1022 e 1065 são exemplos claros de validações condicionais dessa natureza.

Não escolha um CST ou cClassTrib apenas porque ele elimina uma rejeição. A classificação deve representar a operação real e ser validada pela área fiscal responsável.

Arquitetura CFGTRIB → XML → TSS

Para IBS Municipal no CFGTRIB, a investigação deve começar antes do TSS. O CFGTRIB determina regras e classificações que alimentam o cálculo e a escrituração; o processo de documento eletrônico transforma esse resultado em XML; o TSS participa da camada de mensageria/transmissão.

No CFGTRIB

Confirme o cadastro do tributo e sua esfera, quando aplicável. Identifique regras de cálculo, alíquota e escrituração. Valide condições, vigência e classificação. O ponto técnico deste artigo é tributo municipal, regra de cálculo, escrituração e integração.

A TOTVS informa que a adequação da RTC inclui atualização do Configurador de Tributos e cadastro/importação dos códigos de Classificação Tributária. Isso torna a governança da tabela cClassTrib parte do processo de atualização.

Na geração do XML

Confira se IBSMUN e os grupos associados refletem exatamente o resultado das regras. Uma diferença entre memória de cálculo e XML precisa ser localizada antes da transmissão.

No TSS

Confirme versão e compatibilidade com a implementação da NT utilizada. A TOTVS cita em artigos de rejeições a necessidade de Protheus e TSS atualizados. Para TSS Cloud compartilhado, artigos da TOTVS informam que a manutenção de atualização é realizada pela equipe do serviço; ainda assim, registre ambiente e versão durante o diagnóstico.

Patches e fontes

Não aplique pacote em produção sem homologação. Leia pré-requisitos, versão alvo e componentes do pacote. A rejeição 1021, por exemplo, possui orientação TOTVS específica envolvendo pacote e o fonte nfesefaz.prw; esse tipo de instrução deve ser seguido conforme a versão efetivamente instalada, e não generalizado para qualquer rejeição.

Customizações

Mapeie pontos de entrada, fontes customizados e integrações que alterem cálculo ou XML. Uma customização anterior à RTC pode continuar compilando e, ainda assim, interferir em uma nova estrutura de tags.

Checklist de atualização

backup e inventário do ambiente;
versão/release do Protheus;
dicionário e fontes;
pacotes RTC aplicáveis;
versão/ambiente do TSS;
tabela cClassTrib atualizada;
teste unitário por operação;
comparação de XML;
regressão;
plano de rollback.

Impacto prático

A correção de IBS Municipal no CFGTRIB deve produzir dois resultados simultâneos: autorização técnica do documento e coerência tributária. Se apenas a rejeição desapareceu, mas a classificação ou o cálculo ficaram incompatíveis com a operação, o problema não foi realmente resolvido.

FAQ

Atualizar o TSS sozinho resolve?

Não necessariamente. Primeiro determine em qual camada nasce a divergência. Muitas rejeições têm origem em classificação, regra de cálculo ou escrituração no ERP.

Posso trocar o cClassTrib para a nota passar?

A classificação não deve ser escolhida com esse objetivo. Ela precisa representar o tratamento tributário correto da operação.

A flexibilização de 2026 elimina a necessidade de configurar IBS/CBS?

Não. A comunicação oficial tratou da suspensão de validações que rejeitariam pela ausência dos campos em determinados documentos durante a adaptação. A implantação e a consistência das informações continuam relevantes.

Devo testar em produção?

Não é recomendável usar produção como ambiente primário de diagnóstico. Reproduza em homologação sempre que possível e preserve evidências.

Conclusão

A Reforma Tributária tornou o diagnóstico fiscal no Protheus mais dependente da rastreabilidade entre cadastro, classificação, CFGTRIB, cálculo, XML e TSS. Tratar cada rejeição como um problema isolado aumenta retrabalho. A abordagem mais segura é construir uma matriz de configuração e testes baseada na documentação oficial e atualizar essa base conforme novas Notas Técnicas, tabelas e pacotes forem publicados.