cStat 656 (Consumo Indevido): por que a SEFAZ bloqueou sua consulta de DF-e

Quem consome o web service de Distribuição de DF-e (NFeDistribuicaoDFe) para baixar as notas emitidas contra o próprio CNPJ mais cedo ou mais tarde esbarra no cStat 656 — Rejeição: Consumo Indevido. O erro não é sobre o conteúdo da consulta: é a SEFAZ dizendo que você está consultando do jeito errado ou com frequência demais — e aplicando um bloqueio temporário de aproximadamente uma hora para o seu CNPJ.

Como a distribuição de DF-e funciona

Cada documento distribuído para o seu CNPJ recebe um NSU (número sequencial único). A consulta informa o último NSU que você já processou (ultNSU) e o serviço devolve um lote com os próximos documentos, junto com dois marcadores:

• ultNSU — último NSU retornado neste lote;
• maxNSU — maior NSU disponível para o seu CNPJ no ambiente.

O contrato é: repita a consulta enquanto ultNSU < maxNSU (ainda há lote a buscar). Quando os dois se igualam, você está em dia — e aí vale a outra regra de frequência.

As duas regras que geram o 656

1. Consultou em dia, espere cerca de uma hora. Se a resposta veio com cStat 137 (nenhum documento localizado) ou você já alcançou o maxNSU, uma nova consulta só é bem-vinda depois de ~1 hora. Insistir antes disso é o caminho mais comum para o 656.
2. Não reinicie o NSU. Consultar repetidamente com ultNSU = 0 (ou voltar para um NSU antigo sem necessidade) reprocessa documentos já entregues e também caracteriza consumo indevido. O ultNSU precisa ser persistido por CNPJ/ambiente e só avançar.

Erros de implementação típicos: agendar a consulta a cada minuto “para pegar nota mais rápido”, zerar o NSU a cada reinício do sistema, e rodar dois processos concorrentes com o mesmo CNPJ (um invalida o NSU do outro e os dois entram em loop).

Como tratar o 656 quando ele acontece

• Pare imediatamente as consultas do CNPJ afetado — insistir renova o bloqueio.
• Agende a próxima tentativa para depois de 1 hora, com folga.
• Em operação normal, uma consulta por hora já costuma bastar: o prazo de manifestação se conta em dias, não em minutos.

Como o KiPDV faz

No módulo de compras (plano Completo), a consulta à SEFAZ é acionada no painel (não é um robô a cada minuto). Em cada ciclo o sistema:

• Persiste o ultNSU por empresa e só avança com o que a SEFAZ devolve;
• Drena lotes enquanto ultNSU < maxNSU (dentro do limite seguro de iterações por consulta);
• Respeita janela de ~1 hora entre consultas bem-sucedidas em dia e, em caso de 656, aplica o mesmo tipo de cooldown — o painel mostra o countdown até a próxima tentativa liberada.

As notas que chegam entram no fluxo de DF-e / importação de XML. Resumo não é estoque ainda: depois de baixar o XML e processar a importação, itens novos viram produtos pendentes de aprovação; a entrada de mercadoria segue sem redigitar a nota inteira.

Mais sobre o fluxo de compra: DF-e: notas contra o seu CNPJ e importação de XML.