ENDPOINT's consultas

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:

  1. Inicie a consulta utilizando um NSU base (armazenado previamente ou inicial).

  2. Envie a requisição para a API com esse NSU.

  3. Receba a resposta e processe os documentos e eventos retornados.

  4. Identifique e armazene o maior NSU presente na resposta.

  5. Imediatamente após o processamento, realize uma nova consulta utilizando esse NSU atualizado.

  6. 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

1 curtida