vLiqFor na aquisição de cana: como conferir o valor líquido
<vLiqFor>cana › vLiqForRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vLiqFor é o valor líquido dos fornecimentos de cana, identificado como ZC15 no MOC. Está em /nfeProc/NFe/infNFe/cana/vLiqFor, no encerramento do grupo cana. O campo descreve o líquido do fornecimento; não é confirmação de pagamento, recibo de quitação nem autorização da NF-e.
Como separar bruto, deduções e líquido?
Leia juntos vFor (valor dos fornecimentos), vTotDed (total das deduções) e vLiqFor (líquido). A discriminação das deduções aparece em até dez grupos deduc, cada um com descrição xDed e valor vDed. Essa relação permite investigar um acerto sem confundir o total da parcela com o total consolidado.
Num demonstrativo sintético de R$ 12.000,00 em fornecimentos e R$ 480,00 em deduções, o líquido reconciliado é R$ 11.520,00: 12000,00 − 480,00 = 11520,00. A conta verifica as parcelas assumidas do acerto; não define quais taxas podem ser descontadas nem substitui os critérios contratuais e fiscais da operação.
Se o banco mostrar R$ 10.000,00, essa diferença não prova erro em vLiqFor: o documento pode prever adiantamentos, pagamentos parciais ou outra relação financeira que precisa ser demonstrada. Não há campo de status de pagamento embutido em ZC15. Tampouco se deve copiar automaticamente total/ICMSTot/vNF, que tem finalidade e composição distintas.
Existe líquido sem deduções?
Sim, no cenário em que o acerto não tem deduções, o grupo deduc pode ser omitido e o total das deduções pode ser zero, enquanto o valor líquido corresponde ao bruto. Exemplo assumido: fornecimentos de R$ 2.500,00, deduções efetivamente inexistentes, líquido de R$ 2.500,00. A ausência de informação de origem não autoriza substituir uma dedução desconhecida por zero.
vLiqFor continua obrigatório dentro de cana. O tipo TDec_1302 não aceita valor negativo e admite até 13 posições inteiras, com duas casas quando há fração. Se o demonstrativo levar a saldo negativo, não envie o sinal nem troque por zero para passar no XSD: investigue se as parcelas, o período ou o conceito transportado para o campo estão corretos.
Como localizar o líquido no XML?
Este fragmento sintético representa apenas ZC15 do primeiro cenário, sem compor uma NF-e completa:
<vLiqFor xmlns="http://www.portalfiscal.inf.br/nfe">11520.00</vLiqFor>
No grupo completo, ele sucede vFor e vTotDed. O namespace é o da NF-e; diferença de maiúsculas, como vLiqfor, produz outro nome XML. Use ponto decimal e sem separador de milhar. O XSD comum contém a estrutura, mas a regra ZC01-10 rejeita NFC-e com dados de cana (763); não transfira o grupo para modelo 65 por ele aparecer no schema.
O que conferir se a diferença persistir?
Confronte o XML efetivo com o demonstrativo da mesma safra, referência e fornecedor. Refaça a soma das deduções discriminadas e compare o total consolidado antes de conferir o líquido. Divergência apenas entre bruto e líquido sugere examinar as parcelas, enquanto divergência entre demonstrativo e XML pede examinar geração e mapeamento. Confirme a causa com os dados reais e regenere pelos meios do emissor; não edite o XML autorizado para ajustar um pagamento.
Fontes técnicas
MOC 7.0 — Anexo I — 7.0: p. 65, ZC10–ZC15; p. 128, ZC01-10/763.
XSD NF-e/NFC-e — PL_010f_v1.04: linhas 6363–6477, deduc e valores da cana.
Tipos básicos NF-e/NFC-e — PL_010f_v1.04: linhas 301–309, TDec_1302.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/cana/vLiqFor- 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