total
Valores Totais do CTe
Onde fica no arquivo
No documento
-
CTeSimp/infCte/total
Obrigatório, uma vez
-
cteSimpProc/CTeSimp/infCte/total
Obrigatório, uma vez
O caminho até aqui, nível a nível
Dentro do grupo infCte , informações do CT-e
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 da Prestação sem tributos (tag: total\vTPrestLiq) difere do somatório do valor líquido da prestação sem tributos declarada nos itens (vPrestLiq).
Mensagem: Total Líquido da prestação 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 |
| 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 |
| NFAg | Dados dos totais da NFAg | NFAg/infNFAg/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 — 5
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 | Total de IBS e CBS | Opcional, no máximo uma vez |
| vTotDFe | Valor total do documento fiscal (vTPrest) | Opcional, no máximo uma vez |
| vTPrest | Valor Total da Prestação do Serviço | Obrigatório, uma vez |
| vTPrestLiq | Valor Líquido da Prestação SEM tributos | Opcional, no máximo uma vez |
| vTRec | Valor total a Receber | Obrigatório, uma vez |
Campos do mesmo grupo — 17
São os campos que ficam ao lado deste no arquivo, dentro de CTeSimp/infCte. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo total do CT-e?
Valores Totais do CTe No XML ele fica em CTeSimp/infCte/total. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.
O que vai dentro do grupo total do CT-e?
5 campos: IBSCBSTot, vTotDFe, vTPrest, vTPrestLiq, vTRec. 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 do CT-e?
Em 2 posições do esquema oficial: CTeSimp/infCte/total, cteSimpProc/CTeSimp/infCte/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 no CT-e?
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 no CT-e é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 7 outros documentos (BP-e, DC-e, NF-e, NF3e, NFAg, 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 do CT-e?
Do esquema XML oficial (PL_CTe_400_NT2026.004_RTC_1.00). 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.