01. Princípios Fundamentais

Configurador de Tributos centraliza a definição de todas as regras tributárias da empresa. A configuração correta do compartilhamento de tabelas é essencial para garantir a integridade dos dados, consistência nas operações fiscais e performance do sistema.

02. Definição do Modo de Compartilhamento

A definição do modo de compartilhamento das tabelas do Configurador de Tributos requer análise específica de cada cenário organizacional, considerando fatores como estrutura empresarial, modelo de negócio e requisitos fiscais particulares. Cada implementação possui características únicas que influenciam a escolha entre tabelas exclusivas ou compartilhadas.

Os principais fatores a considerar nesta análise incluem:


Este documento reúne sugestões de agrupamentos específicos como material de referência. Cabe a cada organização avaliar e validar essas orientações conforme seu contexto operacional e necessidades específicas.



03. Grupos de Tabelas com Compartilhamento Obrigatoriamente Alinhado

As tabelas do configurador de tributos estão organizadas em grupos lógicos que compartilham relacionamentos diretos. O compartilhamento deve ser configurado respeitando esses grupos, evitando inconsistências que podem gerar avisos do sistema durante operações.

Grupo 1: Perfis Tributários Base (F20-F26) + CIO (Hierárquico)

Este grupo define quem paga o quê: quais são seus clientes (consumidores, revendedores, contribuintes), em quais estados você vende, quais produtos comercializa e quais tipos de operações realiza (venda, devolução, transferência).

Em termos práticos: Se você quer que todas as suas filiais usem as mesmas classificações de clientes e produtos, configure F20-F26 como compartilhado. Se cada filial precisa ter sua própria classificação, configure como exclusivo.


Compartilhamento Recomendado:


HIERARQUIA CORRETA - CIO com Flexibilidade: A tabela CIO (Códigos ISS Municipais) pode ter compartilhamento diferente das demais:

TabelaNomeFinalidade
F20Perfis TributáriosCabeçalho dos perfis
F21Perfil Tributário Orig./Dest.Especifica UF de origem e destino dentro de cada perfil
F22Perfil Trib. de ParticipanteClassifica clientes/fornecedores
F23Perfil Tributário de OperaçãoDefine os tipos de operações por CFOP (entrada, saída, devolução)
F24Perfil Tributário de ProdutoEstabelece categorias de produtos para tributação
F25Perfil Produto x OrigemRelaciona produtos com a origem 
F26Perfil Tipo de OperaçãoDefine comportamento de cada tipo de operação
CIOCódigo de Serviço Municipal do perfil de operaçõesAssocia códigos de serviço municipal às operações tributárias 

⚖️ Hierarquia de Compartilhamento

Configurações Validas:

#F20-F26 (ORIGEM)CIO (DESTINO)StatusQuando Usar
1Exclusivas (E)Compartilhada (C) VÁLIDORECOMENDADO: Perfis por filial + ISS centralizado
2Exclusivas (E)Exclusiva (E) VÁLIDOAutonomia fiscal total por filial
3Compartilhadas (C)Compartilhada (C) VÁLIDOPerfis E códigos ISS uniformes em todas as filiais
4Compartilhadas (C)Exclusiva (E) PODE GERAR PROBLEMASPODE GERAR CONFLITO DE INTEGRIDADE.


Exemplo prático (Configuração 1):

F20-F26 (Exclusivas por filial):
  → Filial 01 (São Paulo/SP): Perfil "REV001-SP" com regras específicas de SP
  → Filial 02 (Rio de Janeiro/RJ): Perfil "REV001-RJ" com regras específicas de RJ
  → Filial 03 (Belo Horizonte/MG): Perfil "REV001-MG" com regras específicas de MG
  
CIO (Compartilhada - única e global):
  → CIO_CODIGO = "050301" (Serviços de informática - ISS)
  → Visível e acessível por TODAS as filiais
  → Campo CIO_FILIAL = '' (vazio, pois é compartilhada)

Resultado: 
✅ Cada filial tem seus próprios perfis tributários
✅ TODAS referenciam o mesmo código ISS centralizado
✅ Sem necessidade de replicação de dados
✅ Manutenção simplificada do cadastro de ISS

⚠️ Por que Configuração 4 pode gerar problemas:

F20 (Compartilhada - única e global):
  F20_FILIAL = '' (vazio)
  F20_CODIGO = "REV001"
  F20_CODISS = "050301" -- Aponta para CIO

CIO (Exclusiva por filial):
  → Filial 01: CIO_FILIAL='0101', CIO_CODIGO="050301"
  → Filial 02: CIO_FILIAL='0201', CIO_CODIGO="050301"
  → Filial 03: CIO_FILIAL='0301', CIO_CODIGO="050301"

Problema quando usuário acessa da Filial 02:
  Sistema busca: CIO_CODIGO='050301' AND CIO_FILIAL='0201'
  ❌ MAS F20 é compartilhada (F20_FILIAL=''), não especifica qual filial!
  ❌ Como o sistema sabe se deve buscar CIO da 0101, 0201 ou 0301?
  ❌ AMBIGUIDADE = ERRO DE INTEGRIDADE REFERENCIAL!


Justificativa do Alinhamento F20-F26: Estas tabelas formam uma estrutura hierárquica interdependente rígida. A tabela F20 é a raiz, e F21 a F26 complementam suas definições. Devem sempre ter o mesmo compartilhamento entre si. Qualquer inconsistência causará problemas na aplicação das regras tributárias, pois o sistema não conseguirá encontrar dados válidos ao cruzar as informações.

Justificativa da Flexibilidade CIO: CIO possui relacionamento especial com F20 que permite hierarquia de compartilhamento. O sistema suporta CIO mais restritiva (exclusiva) que F20-F26 (compartilhadas) devido à natureza municipal do ISS e ao campo CIO_FILIAL que garante isolamento adequado.

Relacionamentos Identificados no Sistema:

Cenários de Uso:


Grupo 2: Motor de Cálculo Tributário (F2B, CIN, F27, F28) + F29 (Hierárquico)

Este é o coração do sistema tributário! Aqui ficam as regras de cálculo dos impostos: quanto de ICMS cobrar, como calcular o ISS, quando aplicar substituição tributária, etc.

Em termos práticos: Se todas as suas filiais calculam impostos da mesma forma (mesmas fórmulas, mesmas regras de ST, mesmos percentuais), configure como compartilhado. Se cada filial tem suas próprias regras de cálculo (comum quando operam em estados diferentes), configure como exclusivo.


Compartilhamento Recomendado:

Este é o coração do sistema tributário! Aqui ficam:

⚠️ ATENÇÃO: F2B, CIN, F27 e F28 trabalham em CONJUNTO no cálculo tributário:

HIERARQUIA - F29 com Flexibilidade: Similar à CIO no Grupo 1, a tabela F29 pode ter compartilhamento diferente das tabelas F2B/CIN/F27/F28:


Em termos práticos: Se todas as suas filiais calculam impostos da mesma forma (mesmas fórmulas, mesmas regras de ST, mesmos percentuais), configure F2B/CIN/F27/F28 como compartilhado. Se cada filial tem suas próprias regras de cálculo (comum quando operam em estados diferentes), configure como exclusivo. F29 pode ser compartilhada mesmo com cálculos exclusivos por filial.


Por que o alinhamento F2B/CIN/F27/F28 é OBRIGATÓRIO?

Fluxo de Cálculo:
1. Sistema busca regra F2B aplicável
2. F2B consulta CIN para resolver a fórmula cadastrada:
   - Operandos
   - Índices de cálculo
   - Outros tributos
   - Base de cálculo
   - Alíquota
3. Com base na fórmula, PODE consultar:
   - F27 (Base de cálculo)
   - F28 (Alíquota)
   - Outra F2B (Regra tributária)
   - F29 (URF - hierárquico)

⚠️ CIN é o REPOSITÓRIO CENTRAL de fórmulas!
Tudo é resolvido pela fórmula - após o cadastro da regra (F2B → F27/F28),
a execução é 100% baseada nas fórmulas armazenadas em CIN.

Se F2B/CIN/F27/F28 tiverem compartilhamentos diferentes:
❌ F2B não encontra fórmulas CIN na filial correta
❌ CIN não consegue resolver referências para F27/F28/F2B
❌ F27 não encontra suas fórmulas em CIN
❌ F28 não encontra suas fórmulas em CIN
❌ Cálculo FALHA!


⚠️ REGRA: F2B, CIN, F27, F28 = SEMPRE NO MESMO NÍVEL! F29 pode ser compartilhada (URFs públicas).

TabelaNomeFinalidade
F2BRegra TributáriaDefine regras tributárias genéricas aplicáveis aos documentos
CINCadastro de FórmulasDefine as fórmulas de cálculo de tributos e seus parâmetros (NPI)
F27Regra de Base de CálculoDefine qual será a base de cálculo para os tributos
F28Regra de AlíquotaEstabelece as alíquotas a serem aplicadas sobre a base
F29Unidade de Referência FiscalDefine unidades de referência para cálculo de tributos


⚖️ Hierarquia de Compartilhamento Permitida

Justificativa do Alinhamento CRÍTICO F2B/CIN/F27/F28:

Estas 4 tabelas formam o motor de cálculo tributário com relacionamentos em duas fases:

Relacionamentos Identificados no Sistema:

Fase de CADASTRO:

Fase de EXECUÇÃO (Runtime):

A tabela CIN é o repositório central. Após o cadastro, toda execução é baseada em fórmulas armazenadas em CIN.

A tabela F2B orquestra o cadastro e referencia:


Se F2B/CIN/F27/F28 tiverem compartilhamentos diferentes:

No CADASTRO:  F2B não consegue vincular F27/F28 na filial correta  F27/F28 não conseguem gravar fórmulas em CIN da filial correta

Na EXECUÇÃO:  F2B não encontra fórmulas em CIN  CIN não consegue resolver referências para F27/F28/F2B  Fórmulas não localizam os dados necessários

Resultado: CÁLCULO FALHA!


Justificativa da Flexibilidade F29: F29 possui relacionamento especial que permite hierarquia de compartilhamento. F28 pode referenciar F29 (cadastro), e durante a execução, a fórmula em CIN pode consultar F29. O sistema suporta F29 compartilhada (valores públicos de URF) com F28 exclusiva (alíquotas por filial), pois URFs são valores de referência fiscal definidos por legislação.

Cenários de Uso: