arma/descr: descrição completa do armamento no XML da NF-e
<descr>det › prod › arma › descrRevisã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 &.
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