Histórico da Página

01. Princípios Fundamentais

O 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:

• Estrutura de empresas, unidades de negócio e filiais

• Políticas fiscais e tributárias diferenciadas por localidade

• Segregação de dados entre operações independentes

...

...

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:

• F20, F21, F22, F23, F24, F25, F26: Mesmo nível de compartilhamento obrigatório
• CIO: Pode ser COMPARTILHADA se F20-F26 forem EXCLUSIVAS  (hierarquia permissiva)

⚖️ Hierarquia de Compartilhamento

✅

...

Configurações Validas:

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  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:

• F20 → F21-F26 (Perfis detalhados)
• F20 → CIO (Código ISS Municipal vinculado ao perfil)
• F20 → F2B (Regras tributárias que usam os perfis)

Cenários de Uso:

• Configuração 1 (Hierárquica): F20 F20-F26 F26 EXCLUSIVAS + CIO CIO COMPARTILHADA

  • Uso: Perfis tributários específicos por filial, códigos ISS centralizados
  • Exemplo: Cada filial tem suas regras tributárias, mas todas usam mesma tabela de códigos ISS
  • Benefício: Autonomia  Autonomia local + ISS padronizado + sem replicação de dados
  • Quando usar: Filiais  Filiais em diferentes municípios/estados, mas códigos ISS nacionais padronizados

• Configuração 2 (Tudo Exclusivo): F20 F20-F26 + CIO CIO EXCLUSIVAS

  • Uso: Cada filial possui suas próprias regras tributárias E códigos ISS distintos
  • Exemplo: Empresas com CNPJ por filial, autonomia fiscal total, ISS municipal específico
  • Quando usar: Necessidade  Necessidade de segregação total, incluindo códigos ISS diferentes por município

• Configuração 3 (Tudo Compartilhado): F20 F20-F26 + CIO CIO COMPARTILHADAS

  • Uso: Empresa com filiais que utilizam as mesmas regras tributárias E mesmos códigos ISS
  • Exemplo: Filiais que operam de forma idêntica, centralização total
  • Quando usar: Estrutura  Estrutura simplificada, mesmas regras para todas as filiais

...

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

Compartilhamento Recomendado:

...

)

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

...

 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:

...

• F2B, CIN, F27

...

• , F28: TODAS devem ter o MESMO nível de compartilhamento - Alinhamento OBRIGATÓRIO
• F29: Pode ser COMPARTILHADA se F2B/CIN/F27/F28 forem EXCLUSIVAS (hierarquia permissiva)

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

• Regras de cálculo dos impostos (F2B)
• Fórmulas de cálculo em notação NPI (CIN)
• Base de cálculo - sobre o que cobra imposto (F27)
• Alíquotas - quanto cobra de imposto (F28)
• URF - Unidades de Referência Fiscal (F29)

• F2B define a regra tributária e referencia F27 (base), F28 (alíquota) e CIN (fórmulas)
• F27 define a base de cálculo e grava fórmula na CIN
• F28 define a alíquota e grava fórmula na CIN ou pode referenciar F29 (URF)
• CIN armazena TODAS as fórmulas usadas por F2B, F27 e F28

Em termos práticos: Se

• F2B define a regra tributária e referencia F27 (base), F28 (alíquota) e CIN (fórmulas)
• F27 define a base de cálculo e grava fórmula na CIN
• F28 define a alíquota e grava fórmula na CIN ou pode referenciar F29 (URF)
• CIN armazena TODAS as fórmulas usadas por F2B, F27 e F28

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

• ✅ Cenário VÁLIDO: F2B/CIN/F27/F28 EXCLUSIVAS + F29 COMPARTILHADA = Cálculos por filial, URFs centralizadas
• ❌ Cenário PROIBIDO: F2B/CIN/F27/F28 COMPARTILHADAS + F29 EXCLUSIVA = Conflito de integridade!

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 como compartilhado. Se cada filial tem suas próprias regras de cálculo (comum quando operam em estados diferentes), configure como 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!

...

...

⚖️ Hierarquia de Compartilhamento Permitida

✅ CONFIGURAÇÕES VÁLIDAS para F2B/CIN/F27/F28:

...

...

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

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

Relacionamentos Identificados no Sistema:

Fase de CADASTRO:

• F2B → F27 (Regra base: F2B_RBASE)
• F2B → F28 (Regra alíquota: F2B_RALIQ)
• F27 → CIN (Grava fórmula de base)
• F28 → CIN (Grava fórmula de alíquota)
• F2B → CIN (Grava fórmula de cálculo)

Fase de EXECUÇÃO (Runtime):

• F2B busca fórmula em CIN
• CIN resolve dinamicamente:
  • F27 (Base de cálculo)
  • F28 (Alíquota)
  • Outra F2B (Outros tributos)
  • F29 (URF, se necessário)
  • Operandos e índices de cálculo

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

A tabela tabela F2B orquestra o cadastro e  e referencia:

• Perfis tributários (F20-F26, CIO)
• Regras de base (F27)
• Regras de alíquota (F28)
• Regras de escrituração (CJ2)
• Regras de apuração (F2G)

...

...

...

...

...

...

...

...

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:

• Configuração 1 (Hierárquica): F2B F2B/CIN/F27/F28 F28 EXCLUSIVAS + F29 F29 COMPARTILHADA

  • Uso: Regras de cálculo específicas por filial, URFs centralizadas
  • Exemplo: Cada filial tem suas regras, mas todas usam mesmos valores de UFIR/UPF
  • Benefício: Autonomia  Autonomia local + URF padronizada + sem replicação de dados
  • Quando usar: URFs  URFs são valores públicos, não há necessidade de valores diferentes por filial

• Configuração 2 (Tudo Exclusivo): F2B F2B/CIN/F27/F28 + F29 F29 EXCLUSIVAS

  • Uso: Cada filial possui suas próprias regras E valores de URF distintos (muito raro)
  • Exemplo: Customizações específicas por filial com URFs diferentes
  • Quando usar: Necessidade  Necessidade muito específica de URFs diferentes (cenário atípico)

• Configuração 3 (Tudo Compartilhado): F2B F2B/CIN/F27/F28 + F29 F29 COMPARTILHADAS

  • Uso: Regras de cálculo uniformes E URFs centralizadas
  • Exemplo: Estrutura simplificada, mesmas regras para todas as filiais
  • Quando usar: Centralização  Centralização total de cálculos tributários