nSerie em arma: série individual do armamento na NF-e
<nSerie>det › prod › arma › nSerieRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
arma/nSerie informa o número de série da arma. O caminho /nfeProc/NFe/infNFe/det/prod/arma/nSerie é indispensável para interpretar o nome: ele não é a série da NF-e em ide/serie nem um número de lote do produto.
A série identifica o objeto, não o documento fiscal
Dentro de arma, nSerie identifica a arma e nCano identifica seu cano; descr detalha as características. Cada ocorrência mantém esse conjunto. Duas armas no mesmo item exigem conferência das respectivas identificações, sem concatenar várias séries num único campo. O schema admite até 500 grupos, mas não valida cadastro ou titularidade do objeto. Fonte: MOC 7.0 — Anexo I 7.00, novembro/2020, L01–L05, pp. 23–24; XSD NF-e/NFC-e PL_010f_v1.04, arma, linhas 1846–1897.
Formato textual e exemplo de leitura
nSerie é obrigatório uma vez por grupo e aceita 1–15 caracteres conforme TString, na sequência depois de tpArma e antes de nCano. Trate o valor como texto: zeros iniciais, letras e sinais podem compor a identificação. Remover ou substituir caracteres para gerar um número muda o identificador. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, arma/nSerie, linhas 1864–1874.
Fragmento parcial e sintético:
<nSerie xmlns="http://www.portalfiscal.inf.br/nfe">SERIE-EXEMPLO-1</nSerie>
A série fictícia só ilustra a posição e o tamanho. O valor real deve vir da identificação documental da arma; sua validade não é demonstrada por caber no campo.
Como rastrear uma divergência de série
Comece pelo item correto da NF-e e pela unidade à qual a ocorrência corresponde. Compare a série documental com o cadastro e com o XML efetivamente gerado. Verifique se um processo de importação removeu zeros, se copiou a série do cano ou se repetiu a mesma série em todas as unidades. Corrija a transformação comprovadamente incorreta na origem.
Não trunque uma identificação longa nem substitua uma série desconhecida por marcador genérico. Isso pode produzir XML formalmente aceito que identifica outro objeto. Também não associe a rejeição 738 a um defeito na série: L01-10 trata do grupo em NFC-e ou em NF-e com tpImp=6. Fonte: NT 2026.002 1.11, setembro/2026, L01-10, p. 13. Os documentos de controle do armamento precisam ser conferidos independentemente da aceitação técnica da NF-e.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/arma/nSerie- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- 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.
- maxLength
15- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve