Rejeição 254: NF-e complementar não possui NF referenciada
Descrição oficial da SEFAZ: NF-e complementar não possui NF referenciada
O que significa
A nota foi emitida com finalidade complementar (finNFe = 2), mas o XML não trouxe nenhuma NF-e referenciada. Complementar sempre complementa uma nota anterior, então a referência é obrigatória.
Por que acontece
A finalidade foi marcada como complementar sem preencher o grupo de documento referenciado, geralmente por digitação ou por rotina de emissão que não pede a chave de origem. Também ocorre quando a nota na verdade é normal e a finalidade foi marcada errada.
Como resolver
Decida qual é o caso: se a nota é mesmo complementar, informe a chave de acesso da NF-e original no grupo de documentos referenciados. Se não é complementar, mude a finalidade para normal (finNFe = 1). Corrija, reassine e retransmita.
Como evitar
Só permita salvar nota com finalidade complementar depois da chave da nota original informada.