NCM Buscador
CAMPO DO XML · NFAG Grupo 2 posições

gMedida

Grupo de medida

✓ Conferido · 12 de outubro de 2026 NFAg (modelo 75): leiaute do XML e regras de validação — MOC NFAg — Anexo I: Leiaute e Regras de Validação, versão 1.00l · Portal Nacional dos DF-e / SVRS

Onde fica no arquivo

No documento

  • NFAg/infNFAg/det/prod/gMedicao/gMedida

    Obrigatório, uma vez · dentro de uma escolha: só uma das opções do grupo é informada

  • nfagProc/NFAg/infNFAg/det/prod/gMedicao/gMedida

    Obrigatório, uma vez · dentro de uma escolha: só uma das opções do grupo é informada

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

  1. NFAg — Nota Fiscal Eletrônica da Agua
  2. └ infNFAg — Informações da NFAg
  3. └ det — Detalhamento de Produtos e Serviços
  4. └ prod — Dados do Produto ou Serviço
  5. └ gMedicao — Grupo para referenciar qual medição e medida estão relacionadas ao item
  6. └ gMedida — você está aqui

Dentro do grupo gMedicao , grupo para referenciar qual medição e medida estão relacionadas ao item

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
TMedidaAG
Formato base
grupo

O mesmo nome em outros documentos fiscais — 2

gMedida 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 Grupo de medida NF3e/infNF3e/NFdet/det/detItem/prod/gMedicao/gMedida
NFGas Grupo de medida NFGas/infNFGas/det/gNormal/prod/gMedicao/gMedida

Os campos dos doze documentos fiscais, com filtro →

O que vai dentro deste grupo — 8

gMedida é um grupo: ele não carrega valor próprio, agrupa os campos abaixo. A obrigatoriedade de cada um vale dentro do grupo — campo obrigatório num grupo opcional só é exigido quando o grupo é informado.

Campo O que é Ocorrência
nUnidConsumo Número da unidade de consumo Opcional, no máximo uma vez
tpGrMed Tipo de grandeza medida Obrigatório, uma vez
uMed Unidade Básica de Medida Obrigatório, uma vez
vConst Indicar o fator de multiplicação do medidor Opcional, no máximo uma vez
vMed Valor da medição Obrigatório, uma vez
vMedAnt Valor da medição (leitura) anterior Obrigatório, uma vez
vMedAtu Valor da medição (leitura) atual Obrigatório, uma vez
vUnidConsumo Volume por unidade de consumo em m3 Opcional, no máximo uma vez

Campos do mesmo grupo — 2

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

Perguntas frequentes

O que é o campo gMedida da NFAg?

Grupo de medida No XML ele fica em NFAg/infNFAg/det/prod/gMedicao/gMedida. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.

O que vai dentro do grupo gMedida da NFAg?

8 campos: nUnidConsumo, tpGrMed, uMed, vConst, vMed, vMedAnt, vMedAtu, vUnidConsumo. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.

gMedida aparece em quantos lugares da NFAg?

Em 2 posições do esquema oficial: NFAg/infNFAg/det/prod/gMedicao/gMedida, nfagProc/NFAg/infNFAg/det/prod/gMedicao/gMedida. 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.

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

O nome se repete no leiaute de 2 outros documentos (NF3e, 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.

Voltar ao topo