Série Fiscal
Numeração sequencial das notas fiscais — uma série por modelo
Cada nota fiscal emitida pelo Quaza (NFe, NFCe, NFCom, NFSe, NFe SVA, DE-PY) consome o próximo número disponível em uma série fiscal. Esta wiki cobre o que é uma série, como ela se conecta com produtos e categorias, como cadastrar novas séries, e os tipos de nota suportados.
Glossário
| Termo |
O que é |
| Série Fiscal |
Talão (faixa) de numeração identificado por um número (ex: 1, 2, 100). Cada modelo de nota usa uma série independente. |
| Número da série |
Identificador da série que aparece no XML/DANFE (campo serie do XML). |
| Tipo de Nota |
Modelo fiscal que a série atende: NFe, NFCe, NFCom, NFSe, NFe SVA ou DE-PY. |
| Próximo número |
Sequencial atômico calculado pelo Quaza por série + empresa. |
Para que serve
A série fiscal organiza a emissão por faixas de numeração. Você precisa criar uma série quando:
- Tem mais de uma empresa fiscal emitindo o mesmo modelo de nota.
- Quer separar talões por finalidade (produção × testes × contingência).
- Tem filiais distintas que precisam de numeração própria.
📌 Default: o Quaza já vem com 4 séries pré-cadastradas no Brasil (NFe-55, NFe-21, NFSe e NFe SVA), uma por modelo. Quem só precisa de uma faixa por modelo não precisa criar nada.
Como a série é usada na emissão
A série não é escolhida na hora da venda — ela é herdada via cadastros pré-configurados:
📋 1. SÉRIE FISCAL (esta tela)
Você cria a série: número, descrição e tipo de nota.
↓
📦 2. CATEGORIA DE PRODUTO
A categoria de produto aponta para uma série fiscal — define qual modelo de nota cada produto vai gerar.
↓
🧾 3. EMISSÃO DA NOTA
Na hora da venda, o sistema lê a categoria do produto e usa a série configurada — sem escolha manual.
💡 Por que assim: garante consistência fiscal — o mesmo tipo de produto sempre gera o mesmo modelo de nota, sem chance do operador escolher errado.
Tela de listagem
Para acessar:
Fiscal › Série Fiscal
Listagem de séries fiscais cadastradas — colunas Código, Número, Descrição, Tipo de Nota e Criador.
A listagem mostra todas as séries cadastradas com suas colunas básicas. Use o + Adicionar Série Fiscal para criar uma nova; clique em uma linha existente para editar.
Cadastrar uma nova série
Clique em + Adicionar Série Fiscal. O formulário tem 3 campos:
Formulário de cadastro — Descrição, Número e Tipo de Nota.
| Campo |
O que preencher |
Obrigatório |
| Descrição |
Texto livre para identificar a série (ex: "Série principal", "Filial Sul", "Talão de testes"). |
Sim |
| Número |
Número da série (1-999). É o que aparece no XML/DANFE. |
Sim |
| Tipo de Nota |
Modelo fiscal: NFe-55, NFe-21, NFSe, NFe SVA, NFCom (Brasil), Factura (Argentina) ou DE (Paraguai). |
Sim |
⚠️ Validação: não pode existir duas séries com o mesmo número e mesmo tipo de nota. Se você tentar criar série 1 NFe quando já existe, o sistema rejeita. Use número diferente ou outro tipo.
Tipos de nota suportados
Os tipos disponíveis variam por país (locale do sistema):
| Tipo |
Modelo / país |
Descrição |
| NFe-55 |
Brasil — modelo 55 |
Nota fiscal eletrônica de mercadorias. |
| NFe-21 |
Brasil — modelo 21/22 (legado) |
Nota fiscal de comunicação antiga, descontinuada pelo Convênio 201/17. |
| NFSe |
Brasil |
Nota fiscal de serviço (municipal). |
| NFe SVA |
Brasil — SP |
Nota fiscal avulsa para cobrança SVA (PDF local, não eletrônico legalmente). |
| NFCom-62 |
Brasil — modelo 62 |
Nota fiscal de comunicação (sucessora do NFe-21). |
| Factura |
Argentina |
Disponível apenas quando o sistema está configurado para AR. |
| DE |
Paraguai |
Documento Eletrônico (Factura, Nota de Crédito, Nota de Débito). Disponível apenas em PY. |
💡 O sistema mostra apenas os tipos válidos para o seu país. Provedor brasileiro vê 5 opções; Argentina vê 1 (Factura); Paraguai vê 1 (DE).
Numeração automática
Quando uma nota é emitida, o Quaza pede o próximo número via uma sequência atômica:
- Cada combinação série × empresa fiscal tem seu próprio contador independente.
- O incremento é feito sob lock — sem risco de colisão entre operadores simultâneos.
- Notas canceladas ou rejeitadas mantêm o número consumido (não volta para a fila).
- Para "queimar" um número (corrigir pulo sequencial), use Inutilizar NFe/NFCe em vez de mexer na série.
Pegadinhas
⚠️ 1. Apagar série em uso quebra emissão. Antes de excluir, confira se nenhuma categoria de produto aponta para ela. Sem série válida na categoria, a venda não consegue gerar nota.
⚠️ 2. Mudar o número de uma série já usada confunde a SEFAZ. A série + número já estão consumidos no XML emitido. Crie uma série nova em vez de alterar.
🛑 3. Tipo de nota não pode ser alterado depois. Se você criou uma série como NFe-55 e quer trocar pra NFCom, melhor desativar e criar nova.
⚠️ 4. Brasil não tem série compartilhada entre empresas. Mesmo a série "1 NFe" pertence a cada empresa fiscal individualmente — duas empresas podem ter a série 1 NFe simultaneamente, sem conflito.
Perguntas frequentes
Preciso criar uma série antes de emitir minha primeira nota?
Não. As séries pré-cadastradas (1 para cada modelo) cobrem o caso simples. Crie séries adicionais só se tiver várias empresas, filiais ou talões separados.
Onde aponto qual série um produto usa?
Não no produto direto — na Categoria de Produto. A categoria carrega a série, e os produtos herdam da categoria. Veja Categoria Fiscal
.
O que acontece se eu mudar a descrição de uma série?
Nada nas notas já emitidas — descrição é só auxiliar para o operador. O número é o que entra no XML.
Posso usar a mesma série em duas empresas diferentes?
Sim. O contador de numeração é por série + empresa, então cada empresa terá sua própria sequência mesmo usando a mesma série.
O Paraguai e Argentina precisam de série fiscal também?
Sim, mas com tipos próprios (DE para PY, Factura para AR). O sistema mostra apenas os tipos válidos para o país configurado.
Wikis relacionadas