# Relatório de Compatibilidade Fiscal

Este documento descreve como avaliar a compatibilidade dos dados atuais com a transição para o modelo fiscal de 2026, sem impacto na operação existente.

Ferramentas
- `php scripts/fiscal_compat_report.php <tenant>`: sumariza presença de `tax_model_version` e `tax_data` em documentos, e `tax_attributes` em `products`.
- `php scripts/fiscal_version_validation.php <tenant>`: executa validação cruzada de preview NFC-e entre o motor atual (legado) e o motor 2026.
- API: `GET /api/fiscal/nfce/preview` retorna preview normalizado incluindo `model_version` (`'2024'` ou `'2026'`).
- API: `GET /api/fiscal/nfce/preview/cross` retorna `{ legacy, next }` para comparação rápida entre motores.

Configuração
- `environment` é lido de `TaxConfig.options.environment` (padrão: `'homolog'`). Ao ajustar para `'prod'`, o preview herdará esse valor no payload.

Interpretação
- `with_version`/`with_data`: porcentagem de documentos já preparados para o novo modelo.
- `products.with_tax_attrs`: quantos produtos possuem atributos fiscais flexíveis para 2026.
- Notas: tabelas ausentes em ambientes iniciais não bloqueiam a transição; serão tratadas por migrações automáticas.

Ações Recomendadas
- Preencher gradualmente `tax_model_version` nos documentos novos (ex.: `'2024'` no fluxo atual), mantendo histórico.
- Iniciar mapeamento de atributos por produto em `tax_attributes` (ex.: categoria IBS/CBS, regimes especiais).
- Rodar `fiscal_version_validation` com amostras reais para comparar totais e identificar divergências relevantes.
 - Consumir os endpoints de preview (`/api/fiscal/nfce/preview` e `/api/fiscal/nfce/preview/cross`) no front-end para validação visual.

Desempenho
- Consultas do relatório usam agregações simples (COUNT/SUM) e não impactam o fluxo de produção.