qBCMono no grupo conjunto legado: quantidade histórica da monofasia

qBCMono era a quantidade tributada usada pelo antigo gMonoPadrao conjunto de IBS e CBS. O caminho /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBSMono/gMonoPadrao/qBCMono pertence ao PL_010e_v1.02. No PL_010f_v1.04, há campos homônimos em ramos ad rem distintos; esta página trata da identidade histórica exata.

Quantidade tributada não é valor da mercadoria

A NT 2025.002 v1.40, página 22 orientava informar a base em quantidade na unidade de medida estabelecida na legislação do produto. Essa quantidade era multiplicada por adRemIBS e adRemCBS para obter os respectivos valores monofásicos. Não era uma base em reais e não podia ser determinada pelo preço da nota.

O antigo grupo tinha cinco filhos obrigatórios: qBCMono, adRemIBS, adRemCBS, vIBSMono e vCBSMono. O grupo era opcional no XSD, com aplicação contextual histórica ligada ao indicador ind_gMonoPadrao. A estrutura não autoriza concluir que a quantidade comercial ou tributável do cadastro é automaticamente a base monofásica correta.

Precisão e ausência no arquivo antigo

No PL_010e_v1.02, qBCMono usa TDec1104RTC, com até onze dígitos inteiros. O padrão histórico aceita o inteiro sem fração ou, havendo parte decimal, exatamente quatro casas. 25, 25.0000 e 25.5000 passam nesse formato; 25.5, 25.50, vírgula decimal e negativos não passam. Essa exigência lexical do pacote histórico é mais específica que a indicação de tamanho 11v0-4 da tabela.

Zero explícito, campo vazio e campo ausente são distintos. Um elemento vazio não representa uma quantidade zero válida nesse tipo. Se o grupo estiver ausente, não fabrique qBCMono=0 para completar um relatório. Registre a ausência como tal e mantenha a relação com o item original.

Exemplo: 25,5 unidades não são R$ 25,50

Suponha uma base fiscal confirmada, apenas no exemplo, de 25,5 unidades, com IBS de R$ 0,40 por unidade e CBS de R$ 0,60 por unidade. As contas são 25,5 × R$ 0,40 = R$ 10,20 de IBS e 25,5 × R$ 0,60 = R$ 15,30 de CBS. A representação textual da quantidade histórica é 25.5000.

Se o valor do produto fosse R$ 255,00, usar 255 como quantidade elevaria os resultados a R$ 102,00 e R$ 153,00. O erro não seria de arredondamento: seria trocar dinheiro por unidade. Se a origem comercial fosse dez embalagens, também seria necessário comprovar a conversão para 25,5 unidades fiscais; não há fator universal dedutível da tag.

Para conferir a origem, compare unidade legal, quantidade documentada, unidade comercial/tributável, eventual fator de conversão e base serializada. Os parâmetros do cenário são sintéticos; a determinação da unidade e da base concretas exige documentação da operação e confirmação do responsável contábil.

A quantidade no leiaute reformulado

A NT 2025.002 v1.52, páginas 22 e 25 e o PL_010f_v1.04 apresentam qBCMono sob gIBSMonoAdRem/gMonoPadrao e sob gCBSMonoAdRem/gMonoPadrao. Os ramos ad valorem usam vBCMono, base monetária. A reformulação é registrada no histórico da versão 1.50.

Não copie a antiga quantidade para vBCMono nem presuma que a base única antiga deva ser replicada para todos os ramos atuais. Primeiro confirme tributo, modalidade e dados da operação. O nome homônimo é insuficiente para decidir um mapeamento.

Limite do exemplo XML: os números são comparação textual histórica, sem fragmento para envio. Inserir qBCMono no antigo caminho conjunto de um XML atual seria incorreto. Para um erro de geração, identifique pacote, item e retorno e revise o contrato do emissor; preserve originais assinados e esclareça resultados incertos antes de nova tentativa. Validade estrutural não significa autorização ou correção da base fiscal.