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

arma/descr: descrição completa do armamento no XML da NF-e

<descr>det › prod › arma › descr

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

descr, em /nfeProc/NFe/infNFe/det/prod/arma/descr, contém a descrição completa do armamento identificado naquela ocorrência. Sua função é detalhar características do objeto, além das séries registradas em nSerie e nCano.

O que precisa estar na descrição

O MOC enumera calibre, marca, capacidade, tipo de funcionamento, comprimento e outros elementos necessários à perfeita identificação. Uma palavra genérica pode passar no comprimento mínimo do XSD e continuar insuficiente diante dessa finalidade. A descrição deve resultar das características documentadas do armamento; o leiaute não ensina a classificar o calibre ou a determinar permissões de comercialização. Fonte: MOC 7.0 — Anexo I 7.00, novembro/2020, L05, p. 24.

prod/xProd é a descrição geral do item. arma/descr é o detalhamento da unidade dentro do ramo de armamento. Em um item com várias ocorrências de arma, não presuma que uma descrição comercial comum resolve todas as diferenças individuais.

Formato e fragmento comentado

Há exatamente um descr em cada arma, depois de tpArma, nSerie e nCano. Ele aceita de 1 a 256 caracteres, seguindo TString; espaços nas extremidades não atendem ao padrão do tipo. Fonte: XSD NF-e/NFC-e PL_010f_v1.04, arma/descr, linhas 1886–1896.

Fragmento sintético apenas para leitura da tag; é parcial e não descreve um produto real:

<descr xmlns="http://www.portalfiscal.inf.br/nfe">Armamento fictício: calibre X; marca DIDATICA; capacidade Y; funcionamento Z; comprimento documentado W</descr>

As letras demonstram quais características precisam ser obtidas da documentação, sem oferecer especificação operacional ou classificação legal. No XML efetivo, caracteres reservados precisam de escape; por exemplo, um & textual é serializado como &amp;.

Como conferir uma descrição truncada ou fora de contexto

Compare a descrição na origem, a informação serializada e a ocorrência correta de arma. Se o integrador corta o texto em 256 caracteres, verifique se alguma característica essencial foi perdida; ajustar apenas o tamanho não garante descrição suficiente. Confira também se foi usado xProd por engano no mapeamento.

Um erro 738 se refere à combinação do grupo com NFC-e ou NF-e de DANFE Simplificado Tipo 2, não ao texto de descr. Essa distinção evita reescrever uma descrição correta para resolver problema de modelo/impressão. Fonte: NT 2026.002 1.11, setembro/2026, L01-10, p. 13. A conformidade documental e regulatória depende das características e documentos reais; não pode ser certificada por uma string aceita no schema.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/arma/descr
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
256
minLength
1
pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}
whiteSpace
preserve