Bom dia a todos, e ótima semana.
Por gentileza, qual seria a endpoint mais confiavel a se utilizar para fazer as consultas?
Encontrei 2 Endpoint que me retornam os XML’s, ADN e SEFIN.
ADN pelo código sequencial de NSU é possivel encontrar todos os documentos. SEFIN só consegui buscar através de chaves_NFS especificas, não sendo possivel buscar notas novas. Porém não sou programador, sou contador com conhecimentos básicos em programação + I.A ajudando, resolvi perguntar pra manter minhas consultas da forma mais confiavel possivel e sem causar consultar excessivas ao portal.
Olá,
O controle deve ser feito pelo NSU. Atualmente, a API do sistema nacional não retorna automaticamente o último NSU, portanto é necessário gerenciar esse controle localmente.
A abordagem recomendada é implementar um fluxo contínuo, semelhante ao da distribuição de DF-e/NF-e, conforme abaixo:
-
Inicie a consulta utilizando um NSU base (armazenado previamente ou inicial).
-
Envie a requisição para a API com esse NSU.
-
Receba a resposta e processe os documentos e eventos retornados.
-
Identifique e armazene o maior NSU presente na resposta.
-
Imediatamente após o processamento, realize uma nova consulta utilizando esse NSU atualizado.
-
Repita esse ciclo continuamente enquanto a API retornar novos dados(status documento localizado).
Esse fluxo cria um loop de consumo incremental, onde você sempre avança a partir do último NSU processado, garantindo que nenhum documento seja perdido.
Caso a API retorne o HTTP status 429 (Too Many Requests) ou HTTP 404 com status de nenhum documento localizado:
-
Interrompa o loop temporariamente.
-
Aguarde um período (por exemplo, 1 hora, semelhante o NF-e e CT-e).
-
Retome o processo a partir do último NSU armazenado.
Dessa forma, você mantém um processamento eficiente, contínuo e resiliente a limitações de rate limit da API. Dessa forma vc sempre vai manter a base atualizada