# Totalização da NF-e

> Totalização da NF-e é o grupo de campos da nota fiscal eletrônica que reúne a soma dos valores de todos os itens, como produtos, impostos, frete, seguro, descontos e outras despesas, chegando ao valor total da nota. A SEFAZ confere esses totais com os itens e rejeita a nota quando os números não batem.

**Também conhecido como:** Totais da NF-e, Grupo de totais da NF-e, Grupo total da NF-e, ICMSTot

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** T

## O que é a totalização da NF-e?

Toda NF-e é composta por itens, e cada item tem seus próprios valores: preço do produto, impostos, descontos e despesas. A totalização é a parte da nota que soma tudo isso e mostra os valores consolidados do documento inteiro.

No arquivo XML, esses dados ficam em um grupo chamado total. Dentro dele, o subgrupo mais conhecido é o ICMSTot, que concentra os totais de produtos, impostos e o valor final da nota. É esse resumo que aparece no quadro de cálculo do imposto do DANFE.

## Quais valores aparecem na totalização?

Os principais campos são: valor total dos produtos, base de cálculo e valor do ICMS, base e valor do ICMS por substituição tributária, FCP, IPI, PIS, COFINS, frete, seguro, descontos, outras despesas acessórias e o valor total da nota (vNF). Há também o valor aproximado dos tributos, usado para informar a carga tributária ao consumidor.

Quando a nota inclui serviços sujeitos ao ISSQN, existe um grupo próprio para esses totais. Com a reforma tributária, os leiautes passaram a prever também totais específicos para IBS e CBS, conforme as notas técnicas vigentes.

## Como o valor total da nota é calculado?

De forma simplificada, o valor total da NF-e parte da soma dos produtos, subtrai os descontos e o ICMS desonerado, quando houver, e acrescenta frete, seguro, outras despesas, ICMS-ST, FCP-ST, IPI e imposto de importação, entre outros valores previstos no leiaute.

Nem todo imposto entra nessa conta. O ICMS próprio, o PIS e a COFINS, por exemplo, normalmente já estão embutidos no preço do produto e por isso são informados, mas não somados novamente ao total.

## Por que a SEFAZ rejeita notas por erro de totalização?

A SEFAZ faz uma conferência automática: soma os valores informados em cada item e compara com os campos do grupo de totais. Se houver diferença, a nota é rejeitada e não recebe autorização de uso.

As causas mais comuns são arredondamentos feitos de forma diferente em cada item e no total, descontos rateados de modo incorreto entre os itens, frete informado só no total e não nos itens, ou a inclusão indevida de um imposto no valor final.

## Como a totalização funciona na emissão por API?

Em uma integração fiscal, o sistema do cliente envia os dados da venda no payload, geralmente em JSON. Dependendo da API, os totais podem ser enviados prontos pelo sistema ou calculados automaticamente a partir dos itens antes da geração do XML.

Mesmo quando a API calcula os totais, os valores de cada item precisam estar corretos, porque o total é apenas a soma deles. Testar cenários com desconto, frete e substituição tributária no ambiente de homologação ajuda a evitar rejeições em produção.

## Exemplos de Totalização da NF-e

- Um ERP emite uma NF-e com três itens e um desconto de R$ 10,00 no pedido. O sistema rateia o desconto entre os itens, e a soma dos descontos por item precisa resultar exatamente nos R$ 10,00 informados no total.
- Uma plataforma de vendas envia uma nota com frete de R$ 25,00. O valor é distribuído nos itens e somado ao total da nota, que passa a refletir produtos mais frete.
- Uma distribuidora vende produto sujeito a ICMS-ST. O valor do ICMS-ST de cada item é somado no campo de total do ST e acrescentado ao valor final da NF-e, que o cliente efetivamente paga.
- Uma nota é rejeitada porque o total dos produtos ficou um centavo diferente da soma dos itens, resultado de arredondamento feito apenas no total. O desenvolvedor ajusta o cálculo para arredondar item a item.

## Perguntas frequentes

### Posso informar só o total sem preencher os valores dos itens?

Não. A NF-e exige os valores de cada item, e a SEFAZ confere se a soma deles corresponde aos totais. O grupo de totalização é um resumo dos itens, não um substituto.

### O ICMS entra no valor total da NF-e?

O ICMS próprio normalmente não é somado ao total, pois já está incluído no preço do produto. Já o ICMS por substituição tributária costuma ser acrescentado ao valor final da nota.

### Diferença de um centavo causa rejeição?

Pode causar. Divergências por arredondamento entre itens e totais são uma causa frequente de rejeição. O ideal é calcular e arredondar por item e depois somar os valores já arredondados.

### Onde vejo os totais no DANFE?

No quadro de cálculo do imposto, que mostra base de cálculo, ICMS, ICMS-ST, frete, seguro, desconto, outras despesas, IPI e o valor total da nota.

## Termos relacionados

- [NF-e](https://conota.dev/glossario/nf-e.md)
- [Base de cálculo do ICMS](https://conota.dev/glossario/base-de-calculo-do-icms.md)
- [Frete na NF-e](https://conota.dev/glossario/frete-na-nf-e.md)
- [Substituição tributária](https://conota.dev/glossario/substituicao-tributaria.md)
- [Rejeição fiscal](https://conota.dev/glossario/rejeicao-fiscal.md)
- [DANFE](https://conota.dev/glossario/danfe.md)

---

Fonte: [Totalização da NF-e](https://conota.dev/glossario/totalizacao-da-nf-e/) · Atualizado em 2026-10-22