Configurações fiscais — cadastros que precisam estar prontos ANTES da primeira emissão
Antes de emitir qualquer documento fiscal (NFCom, NFe, NFSe, DE Paraguai), há cadastros-base que precisam estar configurados: empresa emitente (CNPJ, razão social, regime tributário), CFOPs, CSTs, NCMs, alíquotas, certificado digital. Esta wiki cobre cada cadastro fiscal de base.
📸 Telas do sistema
As telas abaixo mostram como o sistema se apresenta em cada parte do fluxo descrito.
Listagem de Categorias de Produto — agrupa produtos por classificação fiscal e define qual série/tipo de nota será usada quando o produto entra na operação.
Listagem de Categorias Fiscais — define a tributação base (CFOP, CST, alíquotas) que será aplicada em cada operação fiscal.
Listagem de Séries Fiscais — cada série representa um talão de notas (ex: NFe Série 1, NFCom Série 1). Vincula o tipo de nota à empresa fiscal emissora.
Listagem de Situações Tributárias — códigos CST/CSOSN usados para classificar a tributação de ICMS, PIS, COFINS de cada item da nota.
Listagem de Naturezas de Operação — texto descritivo (ex: "Venda de mercadoria", "Prestação de serviço") que aparece no DANFE/NF.
Cadastro de Empresa Fiscal — onde se configura razão social, CNPJ, endereço, certificado digital e parâmetros de emissão.
Configurações gerais do sistema — chaves de configuração que afetam emissão de notas, modo de tributação padrão, integrações.
1 Categoria fiscal
Fiscal → Categoria fiscal
Agrupa produtos por tipo de tributação. Exemplos: "Internet", "Telefonia", "Equipamento", "Instalação". Cada categoria tem alíquotas e CFOPs padrão.
2 Modelo fiscal
Fiscal → Modelo fiscal
Define qual tipo de documento será emitido para cada operação. Modelos disponíveis no sistema:
| Código |
Modelo |
| 55 |
NFe (produtos/serviços) |
| 65 |
NFCe (consumidor) |
| 21 |
NFE 21 — depreciada |
| 22 |
NFE 22 — depreciada |
| nfse |
NFSe (serviço) |
| sva |
NFe SVA (SP) |
| nfcom |
NFCom (telecom) |
| fact |
Factura (Paraguai) |
| py-de |
DE Paraguai |
3 Série fiscal
Fiscal → Serie fiscal
Numeração sequencial das notas, separada por série e estabelecimento. Cada empresa fiscal pode ter múltiplas séries (uma por estabelecimento ou tipo de operação).
4 Situação Tributária
Fiscal → Situação tributária
Códigos CST (regime normal) e CSOSN (Simples Nacional) que definem como os tributos são aplicados em cada operação. Tipos suportados: ICMS, IPI, PIS, COFINS, ISS, IBS, CBS.
5 Natureza de Operação
Fiscal → Natureza de operação
Define o tipo de operação (venda, transferência, devolução, demonstração, etc.). Cada natureza tem CFOP associado e regras tributárias específicas.
6 Produto fiscal
Fiscal → Producto
Cadastro de produtos para emissão fiscal. Cada produto vincula:
-
NCM — Nomenclatura Comum do Mercosul (classificação fiscal)
-
CFOP — Código Fiscal de Operações e Prestações
-
CEST — Código Especificador da Substituição Tributária (quando aplicável)
-
Categoria fiscal e situação tributária
- Alíquotas de IBS/CBS, ICMS, IPI, ISS conforme aplicável
Setup recomendado
- Cadastrar Categorias agrupando seu portfólio (Internet, Telefonia, etc.).
- Cadastrar Modelo conforme operação fiscal da empresa (NFe 55 mais NFCom para telecom).
- Cadastrar Série por estabelecimento.
- Cadastrar Situação Tributária conforme regime fiscal.
- Cadastrar Natureza de Operação para cada tipo de venda.
- Cadastrar Produto fiscal vinculando os 5 itens acima.
- Vincular o produto fiscal aos planos de venda (em Plano de Vendas
).
PADRÃO OPERACIONAL — FLUXO COMUM
──────────────────────────────────
1. Cadastro inicial / configuração
│
▼
2. Permissões definidas por papel
│
▼
3. Operação normal:
┌──────────────────────────────────┐
│ - input do operador / cron │
│ - validação automática │
│ - persistência no banco │
│ - log de auditoria │
│ - notificação (se aplicável) │
└──────────────┬───────────────────┘
│
▼
4. Revisão / supervisão
│
┌──────┴──────┐
▼ ▼
OK normal Desvio detectado
│ │
▼ ▼
Histórico Ação corretiva +
alerta ao supervisor
Documentos relacionados
🔀 Como o Sistema Decide Qual Tipo de Nota Cada Produto Gera
Esta é uma das partes mais importantes (e às vezes confusas) do fiscal. Cada produto tem uma cadeia de configurações que determina qual modelo de nota será emitida (NFe 55, NFCom, NFSe, etc.):
| Passo |
Configuração |
O que define |
| 1 |
Produto |
Cadastro do item — vinculado a uma Categoria de Produto
|
| 2 |
Categoria de Produto |
Aponta para uma Série Fiscal + Empresa Fiscal (NFe Empresa) |
| 3 |
Série Fiscal |
Define o Tipo de Nota (NFe 55, NFCom, NFSe, NFe SVA, etc.) |
| 4 |
Empresa Fiscal |
Empresa que emite a nota (CNPJ/RUC, certificado digital) |
Resumo da cadeia: Produto → Categoria → Série → Tipo de Nota + Empresa Fiscal. Por isso a Categoria de Produto é tão importante: ela define em qual nota o produto vai aparecer.
Exemplo prático — empresa que emite 3 tipos de nota
Suponha um provedor que vende internet, telefonia VoIP e instalação. Ele cadastra:
| Categoria de Produto |
Série Fiscal |
Tipo de Nota |
Produtos vinculados |
| "Telecom" |
Série 1 (NFCom) |
NFCom |
Internet 500MB, Internet 1GB, IPTV |
| "Serviços" |
Série 2 (NFSe) |
NFSe |
Instalação, Visita técnica, Manutenção |
| "Equipamentos" |
Série 3 (NFe 55) |
NFe modelo 55 |
Roteador, ONU, Splitter |
Agora, se um cliente contrata:
- Internet 500MB (R$ 80) → vai pra NFCom
- Instalação (R$ 100) → vai pra NFSe
- Roteador (R$ 250) → vai pra NFe 55
O sistema gera 3 notas separadas automaticamente — cada uma com seu modelo, série, empresa fiscal, tributação.
Quando um contrato gera múltiplas notas
Para que o sistema emita várias notas para um único contrato, é preciso:
- Ativar a configuração "Múltiplas notas por contrato" em Admin → Configurações.
- Os produtos do contrato devem estar em Categorias com Séries diferentes.
- Cada nota é gerada independentemente — pode ser que uma seja aprovada e outra rejeitada (cada uma tem seu fluxo).
Cuidado: ao desabilitar "Múltiplas notas", o sistema tenta consolidar tudo em uma única nota — mas só funciona se todos os produtos do contrato tiverem o mesmo tipo de nota. Se houver tipos misturados, vai dar erro na geração.
Categoria fiscal vs Categoria de produto
São duas coisas diferentes que confundem na hora do cadastro:
| Item |
O que faz |
|
Categoria fiscal (Fiscal → Categoria) |
Define tributação — quais tributos (ICMS, ISS, IBS/CBS) e alíquotas se aplicam ao produto. Vincula com Situação Tributária. |
|
Categoria de produto (Estoque → Categoria) |
Define tipo de nota e empresa fiscal — como vimos acima. Vincula com Série fiscal. |
O produto tem os dois: Categoria de Produto (define tipo de nota) e Categoria Fiscal (define tributação dentro daquele tipo).
🔗 Veja também
Glossário
| Termo |
Significado |
| Quaza |
Sistema ERP/BSS pra ISP — gestão integrada de cliente, financeiro, fiscal, técnico. |
| Contrato |
Vínculo formal entre cliente e empresa, define o que está sendo prestado. |
| Fatura |
Documento de cobrança gerado a partir do contrato. |
| Auditoria |
Revisão sistemática de registros para detectar inconsistências. |
| Permissão |
Direito de acesso/edição vinculado a papel ou usuário. |
| API REST |
Interface programática que permite integração com sistemas externos. |
| Cron / crontab |
Agendador de tarefas que roda em horários definidos. |
| Webhook |
Notificação automática que sistema externo recebe quando evento ocorre. |
| Centro de custo |
Dimensão transversal — filial, projeto, setor. |
| Conciliação |
Processo de garantir que extrato bancário bate com Quaza. |
Pegadinhas frequentes
1. Falta de validação pós-configuração. Cadastro feito sem teste real = pega o erro quando vai pra produção. Sempre teste com dado dummy antes.
2. Permissões mal definidas. Operador com acesso de admin = risco. Defina papéis claros.
3. Não treinar equipe nova. Funcionário novo opera no escuro, faz besteira por desconhecimento.
4. Mudar configuração sem registrar. Quem mudou, quando, por quê — perde-se rastro.
5. Ignorar alertas/notificações. Alerta que ninguém olha não serve.
6. Operações em massa sem dry-run. Antes de aplicar a 1000 registros, teste com 5.
FAQ
Como começar a usar este módulo?
Configure os pré-requisitos listados acima, faça um teste em ambiente seguro (ou com poucos registros), valide com a equipe, e só então ative em produção.
Preciso de permissão especial pra acessar?
Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com o administrador do Quaza.
Posso integrar com sistemas externos?
Via API REST do Quaza. Webhooks notificam eventos importantes. Consulte a equipe técnica para credenciais.
O que acontece se houver erro?
Os logs ficam no painel de tarefas/auditoria. Configure alertas (email/Slack) para falhas críticas — não confie em ninguém olhar log manualmente.
Como acompanhar mudanças?
Cada registro tem histórico (timestamp, usuário, ação). Use o filtro de auditoria pra rastrear modificações suspeitas.
O módulo funciona multi-filial?
Sim — via centro de custo (filial) atribuído ao lançamento. Relatórios filtram por filial.