refNFe em gPagAntecipado: chave da NF-e de antecipação

A tag refNFe dentro de ide/gPagAntecipado identifica uma NF-e modelo 55 emitida anteriormente para registrar pagamento antecipado. O grupo vincula essas notas ao documento em que as parcelas de antecipação são abatidas. Seu conteúdo é a chave de acesso do documento anterior; não é o valor recebido, um comprovante bancário ou o número isolado da nota. A função está documentada em BC01 e BC02 da NT 2025.002 v1.51, p. 17.

Uma chave para vincular a antecipação

O XPath desta ocorrência é /nfeProc/NFe/infNFe/ide/gPagAntecipado/refNFe, no namespace http://www.portalfiscal.inf.br/nfe. O elemento raiz nfeProc pertence ao arquivo que reúne nota e protocolo; no XML isolado, a localização começa em NFe/infNFe.

A estrutura admite uma ocorrência de gPagAntecipado, opcional no XSD. Dentro dela, exige de uma a 99 ocorrências de refNFe. Um grupo vazio não cumpre a estrutura. Duas notas anteriores são representadas por duas tags irmãs, cada uma com a sua chave, e não por chaves concatenadas.

A igualdade do nome refNFe não torna as duas ocorrências intercambiáveis. O grupo geral tem regras próprias; pag descreve pagamentos em outros campos. Vincular uma chave não demonstra, por si só, quitação nem cria direito a crédito tributário.

Como conferir a chave

A origem é a chave do documento anterior efetivamente emitido, obtida de seu XML autorizado e conferida com a identificação e o protocolo. Se o processo possui apenas o número da nota, ainda faltam os demais componentes para identificar o documento exato.

O tipo TChNFe do pacote oficial PL 010d v1.03 admite 44 caracteres: seis dígitos, 12 caracteres de 0–9 ou A–Z, seguidos de 26 dígitos. A mudança acomoda o CNPJ alfanumérico no bloco próprio da chave. A NT 2026.004 v1.01, p. 3, prevê o schema em produção em 01/07/2026. Uma chave anterior exclusivamente numérica deve ser preservada como recebida; a mudança não autoriza trocar caracteres nem recalcular uma chave.

Confira os 44 caracteres, inclusive zeros, com o XML anterior. Identifique seu modelo 55, UF e ano/mês. Depois relacione esse documento à parcela registrada e compare o vínculo na origem com o XML da nota atual. Formato aceito no XSD não comprova existência na base autorizadora ou cabimento fiscal.

Fragmento parcial e sintético, apenas para localização:

<gPagAntecipado xmlns="http://www.portalfiscal.inf.br/nfe">
  <refNFe>52260811222333000181550010000000011876543211</refNFe>
</gPagAntecipado>

A cadeia ilustra a posição de uma chave de 44 caracteres. Não identifica uma NF-e real consultada nem comprova dígito verificador ou autorização. O restante de ide, da NF-e e do protocolo está omitido; não é documento pronto para transmissão.

Se um fornecimento estiver vinculado a duas antecipações, cada parcela precisa continuar associada à sua nota anterior nos registros de origem. O XML lista as chaves; este grupo não contém um campo de valor para cada parcela. Valores e abatimento devem ser reconciliados nos documentos e cálculos pertinentes à operação.

Existência e tipo são verificações diferentes

A NT 2025.002 v1.51, p. 74 separa os seguintes testes:

A regra de existência possui duas exceções explícitas. A NF-e referenciada pode não existir na base consultada quando a UF da chave difere da SEFAZ autorizadora. Também há exceção para emissão em contingência com tpEmis=2,4,5, desde que o ano/mês da chave seja inferior a um mês da data atual ou exista o EPEC. Essas condições são próprias da 11BC01-20 e não dispensam documentação real.

Em 1147, compare primeiro a chave transmitida com o documento anterior. Depois confira UF e base, e então as condições da contingência e o EPEC existente. Uma diferença de UF explica o alcance de uma consulta; uma chave incorreta exige corrigir a origem da vinculação. Não transporte automaticamente para esta ocorrência todos os códigos de rejeição de NFref/refNFe.

Em 26/09/2026, a 11BC01-30 permanece identificada como implementação futura. O leiaute descreve a antecipação e a regra futura identifica débito 06, mas isso não permite afirmar que 1143 já esteja ativo. O cronograma de outra validação não é a data desta regra.

Finalidade, incidência, direito a crédito e parcelas que podem ser abatidas dependem da operação. Para a avaliação fiscal responsável, reúna o documento anterior, contrato ou pedido, registros dos recebimentos e nota de fornecimento. Após a definição, confira esses dados com a chave vinculada. Não mude finalidade para eliminar rejeição nem edite XML já assinado.

Veja também gPagAntecipado, tpNFDebito e a ocorrência diferente de refNFe em NFref.