Pular para o conteúdo
Fiscal ProBiblioteca
Rejeição 255 · Regra B25-40

Rejeição 255: mais de uma NF referenciada

Revisão editorial em 15 de out. de 2026. Confira as versões e condições das regras nas fontes do artigo.

A Rejeição 255, regra B25-40, aponta mais de uma ocorrência de NFref em uma NF-e 55 abrangida pela restrição. Hoje a regra contempla complemento, finNFe=2, e notas de crédito dos tipos 1, 3 ou 4. O alcance antigo restrito a complemento foi ampliado pela NT 2025.002, cuja mensagem é “NF-e possui mais de uma NF referenciada”. NT 2025.002 v1.52, p. 31.

O que contar no XML?

Abra o XML efetivamente enviado e conte as ocorrências de ide/NFref, considerando a condição de finalidade e tipo de crédito. Não conte números citados em textos livres nem linhas da tabela de produtos. Uma chave exibida duas vezes em uma tela pode ser apenas repetição visual; duas ocorrências no XML são uma multiplicidade estrutural real.

O schema compartilhado permite repetição do grupo em diversos contextos, mas B25-40 restringe os casos específicos descritos. Portanto, passar no XSD não comprova que a quantidade de referências seja permitida naquela finalidade.

Duplicar a mesma chave também exige investigação?

Sim. A condição da B25-40 trata mais de uma ocorrência, não apenas documentos diferentes. Se a mesma referência foi serializada duas vezes por um integrador, o gerador deve ser corrigido após comprovar que a duplicação é técnica. Existem ainda validações próprias de duplicidade; a ausência de uma delas no retorno não permite ignorar o envelope final.

Se as referências correspondem a documentos realmente distintos, não escolha arbitrariamente qual remover. A estrutura/documentação da operação deve ser definida com os responsáveis. O artigo não recomenda fracionar notas, escolher finalidade diferente ou eliminar vínculos verdadeiros para passar na 255.

Exemplos de duplicação e múltiplos originais

Exemplo sintético: uma NF-e complementar foi associada a um documento original, mas o mapper adiciona NFref uma vez pelo campo principal e outra pela lista de referências. O XML final tem duas ocorrências iguais. A comparação entre o vínculo único de origem e a saída duplicada demonstra a causa; corrija a montagem para não duplicar o mesmo vínculo.

Em outro exemplo, um crédito tipo 1 contém referências a dois documentos distintos. A regra atual inclui esse tipo, mesmo que a aplicação antiga só verificasse complemento. A multiplicidade é real e precisa de definição documental; retirar uma referência sem entender a operação não é uma correção técnica demonstrada.

Como conferir os demais vínculos e o resultado?

Uma única ocorrência resolve apenas a contagem da 255. A 254 verifica ausência; 269 e 678 verificam emitente e UF nos contextos em que se aplicam, com lista própria de tipos de crédito. As alternativas de referência também têm restrições atuais: a NT 2026.002 veda refNF/refNFP/refECF e adia BA02-35 para 14/12/2026, sem adiar todas as regras de referência. NT 2026.002 v1.11, p. 3 e 9-10.

Confira a origem dos vínculos e o XML regenerado, preservando documentos e histórico. Consulte tentativa de estado incerto antes de novo envio e não altere XML autorizado. O resultado fiscal depende da resposta individual da nota, não apenas da quantidade de NFref.

Os exemplos são cenários sintéticos de diagnóstico. Os valores são apresentados em texto para comparação; não constituem um XML fiscal pronto para transmitir. A conferência operacional exige o XML original e o retorno da mesma tentativa.