Rejeição 589: recupere o controle do NSU na distribuição da NF-e

A rejeição 589 informa que o NSU utilizado na consulta é maior que o disponível no Ambiente Nacional. Ela exige investigar a sincronização dos documentos recebidos pela empresa. Alterar o número da NF-e, inutilizar uma faixa ou pedir ao fornecedor que emita outra nota não corrige esse controle.

NSU é o Número Sequencial Único atribuído pelo serviço de distribuição aos documentos de interesse de cada participante. Ele não é o número comercial da nota, a série ou a chave de acesso. Uma mesma operação pode produzir resumos e eventos distribuídos em momentos diferentes.

Primeiro, identifique o serviço consultado

A NT 2014.002 v1.40, página 11, apresenta a regra H06 como obrigatória. A chamada de nota “1” limita sua aplicação às consultas distNSU e consNSU do NFeDistribuicaoDFe. Algumas extrações juntam essa chamada ao identificador e exibem “H061”.

O serviço atende atores da NF-e modelo 55 e documentos relacionados, conforme os vínculos e permissões previstos. Não se deve transportar esse procedimento para a consulta pública do QR Code da NFC-e modelo 65. Também não se trata do serviço que autoriza a nota emitida pela empresa.

O MOC 7.0, Visão Geral, página 96, já descreve H06 nesse contexto. Documentação antiga usa a redação “base de dados da SEFAZ”: o MOC 6 traz H04 no serviço histórico NfeConsultaDest, página 109. Esse nome antigo pode permanecer em telas e mensagens de suporte, mas não justifica reconstruir a integração atual com o contrato daquela consulta.

Entenda ultNSU e maxNSU

Na distribuição por distNSU, o solicitante informa ultNSU, que representa o ponto de continuidade da leitura. A resposta fornece o próximo ponto a utilizar. O campo maxNSU indica o maior NSU existente para o CNPJ ou CPF consultado naquele ambiente. “Maior NSU” é a descrição; a tag do leiaute atual se chama maxNSU.

Quando um retorno válido informa ultNSU igual a maxNSU, a leitura chegou ao final disponível. O sistema não deve somar uma unidade por iniciativa própria. É necessário respeitar o intervalo previsto e continuar com o valor devolvido pelo serviço, sem inventar um novo ponto de consulta.

Se ultNSU ainda está abaixo de maxNSU, trocar o primeiro pelo segundo também é perigoso: o programa pode avançar sobre uma parte que ainda não processou. O objetivo é recuperar a sequência com segurança, e não apenas encontrar um número que deixe de produzir rejeição.

A consulta consNSU tem outra finalidade: buscar pontualmente um documento por um NSU específico, por exemplo para investigar uma lacuna identificada. Ela não deve ser usada para testar sucessivos números até descobrir o que existe. Já consChNFe consulta uma chave de acesso; H06 não é sua validação de entrada.

Por que o controle local fica diferente

Uma migração pode transportar o ponto de leitura da empresa errada. Uma restauração de backup pode recuperar configuração antiga. Homologação e produção podem compartilhar indevidamente o mesmo registro. Duas aplicações consultando o mesmo interessado também podem disputar o controle da sequência.

Esses são caminhos de investigação, não causas comprovadas pelo código. A conferência deve comparar CNPJ/CPF completo, ambiente, método, solicitação enviada e últimas respostas válidas. Ter certificado da mesma empresa não torna intercambiáveis os registros de matriz e filiais.

O Ambiente Nacional organiza a distribuição conforme recebe os documentos, sem exigir sincronização imediata com toda autorização estadual. Portanto, a data de emissão da última nota não permite calcular o próximo NSU. A integração precisa acompanhar os retornos efetivos.

Corrija a sequência com evidência

1. Suspenda as tentativas automáticas repetidas que estejam reproduzindo o erro

2. Preserve os registros de consulta e identifique todas as aplicações que consultam o mesmo interessado

3. Confira se empresa, ambiente e método correspondem ao controle armazenado

4. Recupere o último ponto válido a partir dos retornos e concilie os documentos já processados

5. Faça o ajuste pelo procedimento do fornecedor, com possibilidade de recuperação e sem apagar os arquivos recebidos

6. Retome a leitura respeitando os intervalos e confirme o processamento dos documentos devolvidos

A TOTVS documenta um ajuste no TSS para seu cenário de sincronização. Essa receita modifica uma configuração de produto e não deve ser executada como solução universal. Zerar o controle sem conciliação pode provocar releitura, duplicidades locais ou novos bloqueios.

A NS7 recomenda revisar o NSU e a sincronização. Sua orientação genérica de usar o maior número precisa ser confrontada com o contrato: distNSU continua com ultNSU retornado, sem saltar automaticamente para maxNSU. No Projeto ACBr, um caso discutido e resolvido mostra precisamente o erro de somar uma unidade ao último retorno. As orientações práticas são úteis quando preservam essas diferenças.

Respeite os limites para não receber 656

A NT 2014.002, páginas 14–15, determina espera de uma hora quando não há mais documentos, inclusive após cStat=137 ou quando ultNSU e maxNSU são iguais. Consultar novamente antes do prazo pode resultar em consumo indevido, código 656.

Aplicações que consultam o mesmo CNPJ devem seguir a mesma sequência. Para consultas pontuais consNSU e consChNFe, a nota técnica descreve limite de 20 consultas por hora. Isso não autoriza montar varreduras periódicas por tentativa.

Recebido 656, aguarde a hora de bloqueio sem novas chamadas; uma tentativa antecipada reinicia a contagem. Quando distNSU retorna ultNSU junto desse erro, a informação pode auxiliar a reconciliação prevista no contrato, respeitando a espera. Não provoque deliberadamente o bloqueio apenas para obter esse dado.

O que a retomada não recupera automaticamente

A documentação prevê disponibilidade por até 90 dias após a recepção pelo Ambiente Nacional e informa que novos usuários passam a ter NSU gerado a partir do primeiro acesso. Após mais de 60 dias sem utilizar distNSU, a NT determina a interrupção da geração e sua retomada na consulta seguinte com esse método, sem retroatividade para o período de interrupção.

Assim, zerar o contador não garante recuperar todo o histórico fiscal. Uma resposta sem documentos também não prova ausência de compras. A empresa precisa conciliar os arquivos disponíveis, verificar pendências reais e preservar seu próprio arquivo fiscal.

Considere a ocorrência resolvida quando o controle corresponde ao interessado e ao ambiente corretos, a consulta segue a sequência oficial e os documentos retornados são armazenados sem omissões ou duplicidades locais. O desaparecimento do código, sozinho, é uma verificação insuficiente.

Base consultada e limites

Corpus oficial com corte em 9 de outubro de 2026, relido em 10 de outubro. A v1.40, de julho de 2026, atualiza o tratamento do CNPJ; não transforma NSU em numeração da nota. Três editores práticos lidos: TOTVS, sincronização no TSS, NS7, rejeição 589 e Projeto ACBr, continuidade do NSU. O último é um relato técnico contextual, não garantia de funcionamento em qualquer aplicativo.