vDup na NF-e: valor da parcela e diferença de centavos

vDup é o valor de uma parcela da cobrança em /nfeProc/NFe/infNFe/cobr/dup/vDup. Na NF-e modelo 55 com parcelas, a soma de todos os vDup deve ser igual ao valor líquido da fatura, cobr/fat/vLiq. A regra Y10-10 relaciona a divergência à rejeição 851.

Valor obrigatório em uma parcela existente

Cada dup possui um vDup. A indicação de grupo opcional não permite gerar uma parcela sem valor. O formato monetário documentado tem até 13 algarismos na parte inteira e duas casas decimais; use ponto decimal no XML, sem R$ ou separador de milhar.

Na estrutura XSD conferida, vDup usa TDec_1302Opc, que não admite zero nem número negativo. Isso difere de outros campos monetários que admitem zero. Não mantenha uma ocorrência vazia ou de valor zero para indicar que uma parcela já foi paga: pagamento, saldo do financeiro e informação de cobrança têm funções distintas. O grupo cobr não é permitido na NFC-e modelo 65, conforme Y01-10/760.

O valor deve vir da lista de parcelas do acordo comercial, vinculada à fatura e à empresa emitente. A base de comparação não é uma parcela isolada, a soma das mercadorias ou o líquido creditado pelo adquirente após tarifas; é vLiq da fatura para essa regra.

Exemplo: três parcelas e um centavo restante

Suponha vOrig=105.00, desconto de fatura vDesc=5.00 e vLiq=100.00. Se o acordo prevê três parcelas e o financeiro definiu R$ 33,33, R$ 33,33 e R$ 33,34, a soma fecha R$ 100,00. Três valores de R$ 33,33 totalizariam R$ 99,99, deixando uma divergência de R$ 0,01.

Fragmento parcial e sintético, com fatura e demais grupos omitidos; não está pronto para transmissão:

<dup xmlns="http://www.portalfiscal.inf.br/nfe"><nDup>001</nDup><dVenc>2026-10-26</dVenc><vDup>33.33</vDup></dup>
<dup xmlns="http://www.portalfiscal.inf.br/nfe"><nDup>002</nDup><dVenc>2026-11-26</dVenc><vDup>33.33</vDup></dup>
<dup xmlns="http://www.portalfiscal.inf.br/nfe"><nDup>003</nDup><dVenc>2026-12-26</dVenc><vDup>33.34</vDup></dup>

A atribuição do centavo final é uma hipótese explícita de rateio comercial. A regra oficial exige a igualdade, mas não determina nesse ponto um algoritmo universal para escolher qual parcela recebe o resíduo. Não arredonde cada parcela independentemente e depois presuma tolerância; compare os valores monetários efetivamente serializados.

Diagnóstico da soma diferente de vLiq

Some todas as ocorrências no XML enviado. Inclua valores que possam ter sido duplicados por uma integração e confira se alguma parcela foi omitida. Compare essa soma com fat/vLiq, depois refaça vOrig − vDesc para descobrir se a diferença nasce nas parcelas ou na fatura.

Se R$ 100,00 foram cobrados e R$ 98,00 foram creditados por causa de tarifa, não substitua automaticamente o valor da parcela por R$ 98,00: o extrato de repasse líquido não demonstra mudança na dívida do comprador. Se houve desconto, pagamento parcial ou renegociação, confira como isso foi representado no documento comercial antes de regenerar o rascunho.

No emissor, investigue conversão de valores com vírgula, arredondamentos e perda de centavos; use valores decimais ou centavos inteiros na conferência para evitar erro de ponto flutuante. Revalide o XML gerado após a correção. Não altere XML assinado nem valores comerciais apenas para obter autorização.

vPag registra o valor associado a um meio de pagamento em outro grupo; ele não é outra parcela que deva ser somada a vDup. Veja vLiq e o líquido da fatura e vPag e os detalhes de pagamento.

Atenção ao DANFE Simplificado Tipo 2

A NT 2026.002 v1.10a estende a rejeição 760 a NF-e modelo 55 com tpImp=6 (DANFE Simplificado Tipo 2) e dados de cobrança. A regra Y01-10 está no conjunto cujo cronograma registra teste em 01/07/2026 e produção em 03/08/2026. As datas de 01/09/2026 e 05/10/2026 de outros conjuntos da mesma NT não devem ser transplantadas para essa regra. Na integração, confira modelo, tpImp, ambiente e regra recebida da autorizadora; o permissivo estrutural de cobr não elimina essa condição.

Fontes oficiais

• MOC 7.0 — Anexo I, 7.0; Grupo Y/YA, p. 61–62 e 125–126.
• NT 2026.002 — DANFE Simplificado Tipo 2, 1.10a; p. 3–4, cronograma; p.19, Y01-10.