Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · IPI, II e ISSQN

qSelo no IPI: quantidade de selos de controle da mercadoria

<qSelo>det › imposto › IPI › qSelo

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

qSelo registra a quantidade de selos de controle do IPI no item. Ele aparece em /nfeProc/NFe/infNFe/det/imposto/IPI/qSelo, ao lado do código do selo em cSelo. Não representa valor do IPI nem quantidade comercial automaticamente.

Quantidade de selos e quantidade do produto têm origens diferentes

A quantidade comercial pode estar expressa em caixas, unidades ou outra unidade adotada na operação. A quantidade de selos corresponde ao controle aplicável aos produtos efetivamente selados. O leiaute não fixa uma equivalência universal de um selo por unidade comercial. Confirme a apresentação, o controle e a documentação do produto antes de relacionar qSelo a qCom. Fonte: MOC 7.0 — Anexo I 7.00, novembro/2020, O05, p. 50; RFB — Selos de controle de IPI: bebidas e cigarros atualizado em 12/08/2026, orientações de fornecimento e utilização de selos por produto.

Por exemplo, uma contagem documental de 24 selos não se torna 2 apenas porque a venda foi apresentada em duas caixas. Esse exemplo ilustra contagens diferentes; não estabelece quantos selos cada embalagem exige.

Formato e exemplo de contagem documentada

qSelo é opcional no XSD e, se informado, aceita de 1 a 12 dígitos. É um inteiro textual, sem parte decimal, sinal, unidade ou separador de milhar. Aparece depois de cSelo e antes de cEnq. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, TIpi/qSelo, linhas 7600–7610.

Fragmento parcial, supondo apenas para demonstrar a serialização que a contagem documental seja 24:

<qSelo xmlns="http://www.portalfiscal.inf.br/nfe">24</qSelo>

O XSD permite ausência independentemente de cSelo; essa liberdade estrutural não determina a informação correta para uma mercadoria sujeita ao controle. Zero também não deve substituir informação desconhecida.

O que conferir quando a quantidade diverge

Compare a documentação do controle, a quantidade física correspondente e a memória de conversão da unidade comercial. Verifique se o sistema copiou qCom, arredondou uma quantidade fracionária ou somou selos de itens diferentes. Cada qSelo pertence ao IPI do seu próprio item, não ao total da nota.

Se a documentação não permite determinar o número de selos, falta um dado de origem; não o estime para produzir XML. A exigência e a modalidade do controle precisam de confirmação específica, enquanto a integração deve preservar o código cSelo e a contagem efetivamente confirmados.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/imposto/IPI/qSelo
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
inline:xs:string · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
[0-9]{1,12}
whiteSpace
preserve