Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

arma na NF-e: detalhamento individual e limites do XML

<arma>det › prod › arma

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

O grupo arma detalha armamentos no produto de um item da NF-e: /nfeProc/NFe/infNFe/det/prod/arma. Ele associa a classificação de uso, a série da arma, a série do cano e a descrição de cada unidade. Não substitui os documentos e controles próprios da atividade.

O que compõe cada ocorrência

Quando o ramo de armamento é aplicável, o leiaute admite de uma a 500 ocorrências, cada qual com quatro elementos obrigatórios, nesta ordem: tpArma, nSerie, nCano, descr. tpArma aceita 0 para uso permitido e 1 para uso restrito, conforme classificação documental aplicável; as séries aceitam 1–15 caracteres, e a descrição 1–256 caracteres. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, prod/arma, linhas 1846–1897; MOC 7.0 — Anexo I 7.00, novembro/2020, L01–L05, pp. 23–24.

O grupo não reúne uma lista de séries numa única tag. Ao conferir várias unidades, compare cada ocorrência com o armamento real e seus documentos, preservando o vínculo entre a série da arma e a série do respectivo cano. O máximo do schema não cria uma autorização para operações com determinada quantidade.

Exemplo apenas de estrutura

Fragmento didático completo do grupo, parcial em relação à NF-e. Os identificadores e a descrição abaixo são fictícios; tpArma=0 é hipótese de representação, sem classificar um armamento real:

<arma xmlns="http://www.portalfiscal.inf.br/nfe">
  <tpArma>0</tpArma>
  <nSerie>SERIE-EXEMPLO-1</nSerie>
  <nCano>CANO-EXEMPLO-1</nCano>
  <descr>Exemplo fictício: calibre, marca, capacidade, funcionamento e comprimento documentados do armamento</descr>
</arma>

A descrição real deve desenvolver os elementos que permitem identificar o produto. O XSD não verifica se o calibre foi corretamente classificado, se as séries existem ou se o emitente pode comercializar o produto.

Quando o modelo e o DANFE causam rejeição

A L01-10, rejeição 738, alcança NFC-e e NF-e com DANFE Simplificado Tipo 2 (tpImp=6) que contenham arma. A NT 2026.002 v1.11 mantém essa redação, e o cronograma da alteração indica produção em 03/08/2026. A data pertence à mudança da validação; não é a criação do grupo de armamento. Fonte: NT 2026.002 1.11, setembro/2026, cronograma p. 3; L01-10, p. 13.

Para diagnosticar, leia ide/mod, ide/tpImp e o grupo do item apontado. Um schema compartilhado por modelos 55/65 pode reconhecer a estrutura e ainda assim a regra fiscal rejeitar sua combinação com o modelo. Não remova dados verdadeiros do produto para ultrapassar a validação: confirme a origem do modelo e do tipo de impressão adequados à operação. A autorização da NF-e, por sua vez, não comprova toda a conformidade regulatória da comercialização.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/arma
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–500 no contexto do elemento pai
Tipo
inline:complexType
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.