qBCMono total: quantidade do ICMS monofásico próprio
<qBCMono>total › ICMSTot › qBCMonoRevisã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