qSelo no IPI: quantidade de selos de controle da mercadoria
<qSelo>det › imposto › IPI › qSeloRevisã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