nDup na NF-e: número da parcela e rejeição 852
<nDup>cobr › dup › nDupRevisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
nDup, em /nfeProc/NFe/infNFe/cobr/dup/nDup, identifica o número da parcela de cobrança no XML da NF-e. A regra de negócio pede três algarismos sequenciais e consecutivos, como 001, 002, 003. Não é a quantidade de parcelas nem um lugar para copiar livremente a linha digitável do boleto.
Por que o XSD aceita texto maior e a regra exige três algarismos
A definição estrutural histórica admite texto de 1 a 60 caracteres e ocorrência zero ou uma dentro de dup. A regra Y08-10, para NF-e modelo 55 com parcelas, é mais restritiva: número ausente ou inválido pode gerar a rejeição 852. A observação do MOC estabelece o padrão com três algarismos, sequencial e consecutivo, obrigatório desde 03/09/2018.
Assim, passar no XSD com FAT-100/1 não comprova atendimento à regra. A estrutura dá suporte a dados, mas não substitui as verificações de autorização. A NFC-e modelo 65 também não recebe essas parcelas: a presença de cobr gera a rejeição 760.
Número da parcela, da fatura e do título
fat/nFat identifica a fatura como um todo. dup/nDup identifica cada parcela na sequência do XML. O contas a receber pode guardar um identificador próprio de título, e o banco pode atribuir “nosso número” ou outros códigos. Esses identificadores pertencem a contratos diferentes; não devem substituir automaticamente o número da parcela.
Suponha uma fatura comercial FAT-2026-100 dividida em duas parcelas. O financeiro pode guardar títulos T-901 e T-902; a geração precisa manter essa associação interna e representar as parcelas como 001 e 002. Essa separação permite rastrear o título sem usar seu código em um campo que exige outra forma.
Fragmento parcial e sintético; outros dados da NF-e e fatura omitidos, sem aptidão para transmissão:
<dup xmlns="http://www.portalfiscal.inf.br/nfe"><nDup>001</nDup><dVenc>2026-10-26</dVenc><vDup>450.00</vDup></dup>
<dup xmlns="http://www.portalfiscal.inf.br/nfe"><nDup>002</nDup><dVenc>2026-11-26</dVenc><vDup>450.00</vDup></dup>
001 é texto e conserva os zeros iniciais. Converter em inteiro e serializar 1 perde o formato. Informar 001 duas vezes duplica o número; saltar de 001 para 003 quebra a sequência. O teto estrutural de 120 parcelas não significa que nDup=120 descreva 120 parcelas; ele identifica apenas a posição correspondente.
Como investigar a rejeição 852
Abra o XML efetivamente enviado, localize todos os grupos dup e anote os números na ordem em que aparecem. Confira ausência, tamanho, caracteres, zeros iniciais, duplicidade e lacunas. Se os valores aparecem corretos na tela, compare o objeto de origem com o XML: conversão numérica, ordenação e mapeamento do identificador financeiro podem ser a causa.
Corrija a associação ou o gerador do rascunho e revalide a lista inteira. Depois, confira também dVenc e vDup: renumerar uma lista não resolve vencimentos fora de ordem nem uma soma diferente de vLiq. Não altere a identidade de títulos comerciais já existentes apenas para corrigir a representação da parcela.
A natureza jurídica ou a substituição de um título não é definida por nDup. Leve contrato, fatura e identificação do contas a receber ao responsável por essa decisão quando houver divergência comercial. A conferência de cada data continua em dVenc; o conjunto da cobrança é explicado em cobr.
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.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/cobr/dup/nDup- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- 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.
- maxLength
60- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve