CFGTRIB - ICMS-ST

ICMS-ST no CFGTRIB: Fórmulas e dependências no TOTVS Protheus

Artigo premium sobre icms-st no cfgtrib no CFGTRIB, baseado em documentação oficial TOTVS, com mapear ordem de cálculo e relações entre regras, homologação e controles.

Introdução

ICMS-ST no CFGTRIB é um cenário avançado do Configurador de Tributos do TOTVS Protheus. Este artigo aborda o tema como fórmulas e dependências, com foco em mapear ordem de cálculo e relações entre regras. A análise parte de documentação oficial da TOTVS e preserva uma regra essencial: números, NCMs, percentuais e códigos usados nos exemplos oficiais não devem ser copiados para produção sem validação fiscal.

O que a TOTVS documenta

  • A TOTVS documenta ICMS-ST com regra por NCM, perfis, base, alíquota e escrituração.
  • No exemplo, NCM sujeito ao ICMS-ST usa ICMS com CST 10 para o grupo correspondente no XML.
  • O cenário demonstra MVA e convivência com outros tributos no CFGTRIB.

Esses pontos delimitam o comportamento documentado do produto. A área Fiscal continua responsável por confirmar a legislação, o enquadramento, a classificação, a alíquota e a vigência aplicáveis à empresa.

Estrutura do cenário no CFGTRIB

O cenário deve ser decomposto em contexto, perfis, cálculo, escrituração e processos posteriores. Esse modelo evita tratar o CFGTRIB como uma única fórmula.

Produto e classificação

Revise NCM, origem e demais dados usados pela regra. O produto precisa estar coerente com o tratamento fiscal escolhido.

Participante

Cliente ou fornecedor deve estar no perfil correto. Perfis amplos demais podem fazer uma regra alcançar operações indevidas.

Operação

CFOP, Tipo de Operação e Código de Serviço podem participar do enquadramento. A operação efetiva precisa coincidir com o critério configurado.

Origem e destino

Tributos estaduais, benefícios e cenários interestaduais exigem atenção a UF e territorialidade.

Base de cálculo

Uma base simples é mais fácil de auditar; uma Fórmula Manual exige documentação. Registre operandos, regras consultadas e cálculo manual de referência.

Alíquota

Documente de onde a alíquota vem e qual sua vigência. Nunca trate a alíquota do exemplo TOTVS como regra jurídica geral.

Escrituração

Cálculo e escrituração são camadas diferentes. CST, incidência, totalização, CJ3 e demais reflexos devem ser validados quando fizerem parte do cenário.

Fórmulas e dependências

Para mapear ordem de cálculo e relações entre regras, crie uma ficha técnica de cada regra com: objetivo, fonte TOTVS, responsável Fiscal, release, perfis, base, alíquota, dependências, escrituração, cenário de teste e evidência de aprovação.

A regra só deve ser considerada estabilizada quando outra pessoa consegue reproduzir o teste e explicar por que ela foi aplicada.

Sequência recomendada

  1. Confirmar o tratamento fiscal.
  2. Registrar a documentação oficial.
  3. Conferir release e pacotes.
  4. Revisar os quatro perfis principais.
  5. Recalcular a base manualmente.
  6. Validar a origem da alíquota.
  7. Mapear dependências.
  8. Conferir a escrituração.
  9. Executar simulação quando aplicável.
  10. Gerar documento em homologação.
  11. Conferir XML e registros fiscais.
  12. Validar títulos, guias ou integrações posteriores.
  13. Guardar evidências.
  14. Registrar aprovação funcional.

Cenário prático de diagnóstico

O cálculo fecha, porém a equipe não consegue demonstrar qual regra foi aplicada. O teste deve rastrear enquadramento, base, alíquota e escrituração, não apenas o valor final.

Esse tipo de análise evita alterar a primeira configuração visível e introduzir efeitos colaterais em outras regras.

Matriz de impacto

Antes de mexer no ambiente, classifique o impacto em cinco dimensões.

Fiscal: quais tributos, bases, classificações e vigências são afetados.

Operacional: quais rotinas de compra, venda, devolução, serviço ou frete usam a regra.

Dados: quais cadastros alimentam o enquadramento.

Tecnologia: quais integrações, XMLs, relatórios, customizações ou APIs consomem o resultado.

Financeiro: quais títulos, retenções, guias ou apurações dependem do cálculo.

Essa matriz reduz o risco de testar apenas o módulo onde a regra foi criada.

Fórmulas e dependências entre tributos

Diversos cenários oficiais mostram dependências: ICMS, ISS ou IPI podem influenciar PIS/COFINS; DIFAL convive com outros tributos; IBS/CBS pode utilizar bases formadas após exclusões.

Sempre que uma regra consultar outra, trate a relação como dependência explícita. Documente qual regra precisa existir primeiro, qual valor é consultado e qual resultado esperado.

Uma boa prática é manter pelo menos três cálculos manuais: valor simples, valor com desconto/frete e valor de borda. Isso aumenta a confiança na fórmula.

XML, escrituração e CJ3

A autorização do XML não prova que o enquadramento fiscal está correto. Ela demonstra apenas que o documento passou pelas validações ativas do autorizador.

Confronte XML com a Regra de Escrituração e, quando aplicável, CJ3. Na Reforma Tributária, a documentação TOTVS usa CJ3 em diversos cenários. Em devoluções híbridas, a própria TOTVS destaca a necessidade de sua geração para transmissão.

Não corrija diretamente tabelas fiscais para ajustar um documento. A origem deve ser corrigida na regra, perfil ou cadastro que produziu o resultado.

Financeiro, retenções e guias

Retenções, FUNRURAL e GNRE mostram que o CFGTRIB pode atravessar o Financeiro. Quando houver Regra Financeira, valide participante, natureza, carteira, tipo de título, vencimento e relação com a regra fiscal.

Evite parametrização concorrente em Fornecedor/Natureza quando o cenário oficial orienta concentrar o tratamento na Regra Financeira.

Critérios de aceite

Defina critérios objetivos antes do teste. Um cenário pode ser aceito quando:

  • enquadra a regra esperada;
  • reproduz o cálculo manual;
  • grava a escrituração esperada;
  • gera o XML compatível com a documentação;
  • produz títulos ou guias corretos, se aplicável;
  • funciona em entrada e saída quando o processo exige;
  • trata cancelamento ou devolução quando previsto;
  • mantém rastreabilidade;
  • não altera cenários não relacionados;
  • possui aprovação Fiscal registrada.

Sem critérios prévios, a homologação tende a virar validação subjetiva.

Migração do legado

Durante a coexistência, mantenha inventário das operações migradas. Um valor correto pode ser resultado do motor tradicional e não do CFGTRIB.

Crie um indicador de cobertura: quantidade de cenários identificados, configurados, homologados, aprovados e efetivamente migrados. Essa visão ajuda a evitar lacunas.

Governança de filiais

Padronize nomes e documentação, mas não force compartilhamento entre filiais com realidades diferentes. Estado, benefício, regime, tipo de operação ou legislação local podem exigir regras separadas.

Ao alterar regra compartilhada, identifique previamente todas as filiais consumidoras e execute regressão nas operações críticas.

Troubleshooting estruturado

Quando houver divergência, investigue nesta ordem:

  1. aplicabilidade fiscal;
  2. dados cadastrais;
  3. enquadramento dos perfis;
  4. regra selecionada;
  5. base;
  6. alíquota;
  7. fórmula/dependência;
  8. escrituração;
  9. documento eletrônico;
  10. integração financeira ou posterior.

Essa ordem é mais eficiente do que começar por banco de dados ou customização.

Sustentação e monitoramento

Após produção, acompanhe rejeições, diferenças de cálculo, falhas de enquadramento e alterações da documentação TOTVS. Mantenha data de última revisão da regra e responsável.

Toda atualização de release, pacote fiscal ou requisito legal deve acionar uma avaliação de regressão nos cenários mais críticos.

O que não fazer

  • copiar alíquota de exemplo;
  • criar regra sem responsável Fiscal;
  • usar NCM de demonstração na empresa;
  • alterar banco diretamente;
  • ignorar dependências;
  • testar apenas o total da nota;
  • confundir XML autorizado com conformidade;
  • migrar sem comprovar origem do cálculo;
  • compartilhar regra sem análise regional;
  • deixar fórmula sem documentação.

Conclusão

ICMS-ST no CFGTRIB demonstra a flexibilidade do CFGTRIB e também a necessidade de governança. O sistema permite combinar perfis, bases, alíquotas, fórmulas, escrituração e integrações, mas a qualidade do resultado depende de dados corretos e de uma interpretação fiscal validada.

Para mapear ordem de cálculo e relações entre regras, o caminho mais seguro é transformar cada configuração em uma unidade auditável: fonte oficial, requisito fiscal, regra documentada, teste reproduzível e aprovação formal.

Fontes e referências

  1. FISA170 - Como calcular o ICMS ST? — TOTVS Central de Atendimento · Acessar fonte · acesso 2026-09-01
  2. FISA170 - Procedimentos de configuração e utilização da rotina Configurador de Tributos — TOTVS Central de Atendimento · Acessar fonte · acesso 2026-09-01
  3. Escrita Fiscal - Configurador de Tributos — TOTVS Central de Atendimento · Acessar fonte · acesso 2026-09-01
Aviso educacional

Este artigo é informativo e não substitui orientação profissional individualizada.

Conteúdos relacionados