Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Informações complementares da operação

vLiqFor na aquisição de cana: como conferir o valor líquido

<vLiqFor>cana › vLiqFor

Revisã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