Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Totais

qBCMono total: quantidade do ICMS monofásico próprio

<qBCMono>total › ICMSTot › qBCMono

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

qBCMono em total/ICMSTot é a quantidade total tributada do ICMS monofásico próprio. A tag representa quantidade física na unidade tributável aplicável ao combustível; não é uma base em reais nem o valor do imposto.

Localização e representação no XML

XPath da ocorrência: /nfeProc/NFe/infNFe/total/ICMSTot/qBCMono.

Propriedade no PL 010f v1.04 Valor
Tipo TDec_1302
Ocorrência no pai 0–1
Namespace http://www.portalfiscal.inf.br/nfe

Até 13 algarismos inteiros e duas casas decimais, com ponto; sem vírgula, sinal ou separador de milhar. A ocorrência local não elimina condições de negócio; valores desconhecidos não devem ser convertidos em zero. Para consultas XPath, associe o prefixo nfe: ao namespace; em arquivos sem nfeProc, comece em NFe. XSD oficial.

Quais quantidades entram na soma

O total consolida os campos qBCMono dos grupos de ICMS dos itens que os utilizam, como ICMS02, ICMS15 e ICMS53. O caminho começa em det/imposto/ICMS e segue a alternativa efetiva. Não use prod/qCom ou prod/qTrib automaticamente: a quantidade fiscal monofásica pode refletir composição e parâmetros próprios. W06b.1-10 é facultativa, modelo 55, com rejeição 700; remete aos itens N37a. NT 2023.001 v1.60, pp.25–27 e 39.

A precisão do total difere da precisão do item

No PL 010f v1.04, o item usa TDec_1104v, com até quatro casas decimais, e ICMSTot/qBCMono usa TDec_1302, com duas. Some com precisão decimal, preserve os valores originais dos itens e faça a representação do total conforme o tipo correto. Não copie quatro casas para o total só porque são admitidas no item, nem trate quantidade como moeda por causa do nome do tipo.

Exemplo com unidade física declarada

Hipótese sintética: duas quantidades próprias de 10,00 e 20,00 litros, já apuradas na mesma unidade tributável. O total é 30,00 litros, representado por 30.00. Se a alíquota ad rem hipotética fosse R$ 1,20 por litro, o imposto desses valores seria R$ 36,00, registrado em vICMSMono, e não em qBCMono. A alíquota é apenas hipótese aritmética.

Diagnosticar 700 sem alterar a quantidade real

Compare N37a por item com W06b.1 e confira unidade, conversão e precisão. qBCMonoReten e qBCMonoRet têm outras categorias e não entram na soma própria. A NT orienta considerar zero se não informado para esta validação; isso não autoriza converter quantidade desconhecida em zero no cadastro. A nota registra a implantação da regra até 25/09/2023 em homologação e 30/10/2023 em produção, sem atribuir essas datas ao surgimento de todos os campos monofásicos.

Fragmento XML e limites da conferência

Fragmento sintético da tag qBCMono, no ancestral indicado acima, com o resultado do exemplo. É parcial: não contém o grupo pai completo nem uma nota pronta para transmissão.

<qBCMono xmlns="http://www.portalfiscal.inf.br/nfe">30.00</qBCMono>

O XSD confere a representação, não a apuração nem a autorização. Preserve o XML autorizado; a correção de divergências exige identificar sua origem e o procedimento fiscal aplicável.

Comparações para aprofundar a conferência

As diferenças essenciais entre as parcelas foram explicadas acima. Para acompanhar os campos relacionados em seu próprio contexto XML:

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ICMSTot/qBCMono
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
TDec_1302 · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve