CAMPO DO XML · NFAG Obrigatório 6 posições

uMed

Unidade Básica de Medida

✓ Conferido · 12 de outubro de 2026

Onde fica no arquivo

No documento

NFAg/infNFAg/det/prod/uMed

Obrigatório, uma vez
NFAg/infNFAg/gAgencia/gHistCons/gCons/uMed

Obrigatório, uma vez
nfagProc/NFAg/infNFAg/det/prod/uMed

Obrigatório, uma vez
NFAg/infNFAg/det/prod/gMedicao/gMedida/uMed

Obrigatório, uma vez
nfagProc/NFAg/infNFAg/gAgencia/gHistCons/gCons/uMed

Obrigatório, uma vez
nfagProc/NFAg/infNFAg/det/prod/gMedicao/gMedida/uMed

Obrigatório, uma vez

O caminho até aqui, nível a nível

NFAg — Nota Fiscal Eletrônica da Agua
└ infNFAg — Informações da NFAg
└ det — Detalhamento de Produtos e Serviços
└ prod — Dados do Produto ou Serviço
└ uMed — você está aqui

Dentro do grupo prod , dados do Produto ou Serviço

O que o arquivo aceita neste campo

Ocorrência: 1-1
Tamanho: 1
Tipo no esquema: TUMedItemAG
Formato base: TUMedItemAG

Valores aceitos — 4

Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.

O mesmo nome em outros documentos fiscais — 3

uMed aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento	O que o leiaute dele diz	Caminho lá
NF3e	Unidade de Medida	NF3e/infNF3e/NFdet/det/detItem/gTarif/uMed
NFCom	Unidade Básica de Medida	NFCom/infNFCom/det/prod/uMed
NFGas	Unidade Básica de Medida	NFGas/infNFGas/det/gNormal/prod/gMedicao/gMedida/uMed

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 16

São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg/det/prod. Quem preenche um costuma precisar dos outros na mesma passada.

cClass Código de classificação cProd Código do produto ou serviço. fatorPoluicao Fator de poluição gMedicao Grupo para referenciar qual medição e medida estão relacionadas ao item gPagAntecipado Grupo de antecipação de pagamento Permite informar apenas quando tpPagAnt=3 indDevolucao Indicador de devolução do valor do item indOrigemQtd Indicador da origem da quantidade faturada qEconomias Quantidade de economias qFaturada Quantidade Faturada tpCategoria Categoria da ligação vItem Valor unitário do item vItemLiq Valor unitário do item sem tributos vProd Valor Total dos produtos e serviços vProdLiq Valor Total líquido dos produtos e serviços sem tributos xCategoria Detalhamento da Categoria xProd Descrição do produto ou serviço

Perguntas frequentes

O que é o campo uMed da NFAg?

Unidade Básica de Medida No XML ele fica em NFAg/infNFAg/det/prod/uMed. Obrigatório, uma vez, com tamanho 1.

uMed aparece em quantos lugares da NFAg?

Em 6 posições do esquema oficial: NFAg/infNFAg/det/prod/uMed, NFAg/infNFAg/gAgencia/gHistCons/gCons/uMed, nfagProc/NFAg/infNFAg/det/prod/uMed, NFAg/infNFAg/det/prod/gMedicao/gMedida/uMed, nfagProc/NFAg/infNFAg/gAgencia/gHistCons/gCons/uMed, nfagProc/NFAg/infNFAg/det/prod/gMedicao/gMedida/uMed. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Quais valores uMed aceita na NFAg?

O esquema oficial restringe a 4 valores: 1, 2, 5, 6. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.

uMed na NFAg é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 3 outros documentos (NF3e, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição da NFAg?

Do esquema XML oficial (PL_NFAg_NT2026.004_RTC_1.00_correcao). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.