total
Dados dos totais da NFAg
Onde fica no arquivo
No documento
-
NFAg/infNFAg/total
Obrigatório, uma vez
-
nfagProc/NFAg/infNFAg/total
Obrigatório, uma vez
O caminho até aqui, nível a nível
Dentro do grupo infNFAg , informações da NFAg
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- —
- Tipo no esquema
- grupo
- Formato base
- grupo
As regras que verificam este campo — 1
O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.
Total Líquido dos Produtos ou Serviços sem tributos (tag: total\vProdLiq) difere do somatório do valor líquido dos produtos ou serviços sem tributos dos itens.
Mensagem: Total Líquido dos Produtos ou Serviços sem tributos difere do somatório dos itens
O mesmo nome em outros documentos fiscais — 7
total 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á |
|---|---|---|
| BP-e | Informações dos totais do BPe TM | BPeTM/infBPe/total |
| CT-e | Valores Totais do CTe | CTeSimp/infCte/total |
| DC-e | Dados dos totais da DCe | DCe/infDCe/total |
| NF-e | Dados dos totais da NF-e | NFe/infNFe/total |
| NF3e | Dados dos totais da NF3e | NF3e/infNF3e/total |
| NFCom | Dados dos totais da NFCom | NFCom/infNFCom/total |
| NFGas | Dados dos totais da NFGas | NFGas/infNFGas/total |
O que vai dentro deste grupo — 10
total é 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 |
|---|---|---|
| IBSCBSTot | Totais de IBS e CBS | Obrigatório, uma vez |
| vCOFINS | Valor do COFINS | Obrigatório, uma vez |
| vNF | Valor Total da NF-e | Obrigatório, uma vez |
| vPIS | Valor do PIS | Obrigatório, uma vez |
| vProd | Valor Total dos produtos e serviços | Obrigatório, uma vez |
| vProdLiq | Valor Total líquido dos produtos e serviços sem tributos | Opcional, no máximo uma vez |
| vRetTribTot | Total da retenção de tributos federais | Obrigatório, uma vez |
| vTFS | Valor TFS | Obrigatório, uma vez |
| vTFU | Valor TFU | Obrigatório, uma vez |
| vTotDFe | Valor total do documento fiscal (vNF) | Obrigatório, uma vez |
Campos do mesmo grupo — 18
São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo total da NFAg?
Dados dos totais da NFAg No XML ele fica em NFAg/infNFAg/total. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.
O que vai dentro do grupo total da NFAg?
10 campos: IBSCBSTot, vCOFINS, vNF, vPIS, vProd, vProdLiq, vRetTribTot, vTFS, vTFU, vTotDFe. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.
total aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/total, nfagProc/NFAg/infNFAg/total. 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.
Que rejeição total pode causar na NFAg?
1 regra do manual cita este campo, disparando o código 1054. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.
total na NFAg é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 7 outros documentos (BP-e, CT-e, DC-e, NF-e, 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.