vPIS em PISQtde: resultado por quantidade e total do PIS
<vPIS>det › imposto › PIS › PISQtde › vPISRevisão editorial em 27 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vPIS em PISQtde é o valor em reais do PIS, Programa de Integração Social, calculado por quantidade para um item. Está em /nfeProc/NFe/infNFe/det/imposto/PIS/PISQtde/vPIS, depois de CST 03, qBCProd e vAliqProd.
A conta do item e a conferência do total da nota são etapas diferentes. Saber qual delas divergiu evita corrigir um valor que estava certo.
Produto de quantidade e valor por unidade
A relação é vPIS = qBCProd × vAliqProd. A primeira entrada é quantidade de base; a segunda, reais por unidade dessa base. Não se divide por 100 como em cálculo percentual. MOC 7.0, Anexo I, página 52.
Em hipótese sintética, com CST 03 e método já definidos, 62,5 unidades × R$ 0,3200 por unidade = R$ 20,00.
<PISQtde xmlns="http://www.portalfiscal.inf.br/nfe">
<CST>03</CST>
<qBCProd>62.5000</qBCProd>
<vAliqProd>0.3200</vAliqProd>
<vPIS>20.00</vPIS>
</PISQtde>
O fragmento é sintético e parcial da nota, não pronto para transmissão; código, unidade e parâmetro não são recomendação tributária. Quantidade de embalagens e valor por litro, por exemplo, não são entradas compatíveis sem conversão documental da quantidade.
No XSD real PL_010d_v1.03, referência histórica, as entradas usam TDec_1204v e TDec_1104v, admitindo uma a quatro casas fracionárias. O resultado usa TDec_1302, até 13 inteiros e duas casas quando há fração, com zero e inteiros também aceitos. 20.00 segue o padrão; 20,00 e 20.001 não seguem. Schemas 010d v1.03.
A apresentação monetária do resultado não autoriza arredondar prematuramente quantidade ou alíquota unitária. A faceta não estabelece tolerância SEFAZ nem método universal de arredondamento da apuração.
Três valores com nomes parecidos
Este PISQtde/vPIS é Q09, PIS próprio do item. ICMSTot/vPIS é W13, total de PIS no grupo de totais. PISST/vPIS é R06, PIS por substituição tributária.
W13-10 compara o total com Q09 dos itens sujeitos ao ICMS, identificados pela presença do grupo ICMS. É facultativa para modelos 55/65, associada à rejeição 602. A regra não soma R06 como se fosse Q09. MOC, página 121.
Exemplo sintético de totalização: dois itens com ICMS, PIS próprio R$ 20,00 e R$ 5,00, compõem soma de R$ 25,00. PIS-ST adicional de R$ 3,00 não transforma esse total próprio em R$ 28,00. O indicador indSomaPISST trata da contribuição de PIS-ST ao valor total da nota vNF, não da redefinição de W13. NT 2020.005 v1.21.
Investigar entradas antes do resultado
Se o resultado do item diverge, compare quantidade e unidade da base, fator de conversão comprovado e valor por unidade da origem com o XML. Confira perda de casas, conversão de centavos e divisão por 100 herdada indevidamente de outro método.
Se apenas o total diverge, liste nItem, presença de ICMS e Q09, depois some os valores monetários representados. Procure itens duplicados, excluídos indevidamente ou total que não foi atualizado após mudança de item.
Zero estrutural não deve substituir resultado desconhecido. Uma diferença de centavos precisa de evidência sobre as etapas de precisão; não é motivo para ajustar o último item nem presumir tolerância de R$ 0,01.
Corrija a causa comprovada no cálculo, serialização ou agregação, gere e valide novamente, sem editar XML assinado. A definição de método, unidade e alíquota real precisa dos dados da operação e da memória para confirmação com o responsável contábil.
Continue em qBCProd, vAliqProd e vPIS de PISST.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/PIS/PISQtde/vPIS- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–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