Consulta em lote x consulta individual via API de NFS-e
· 5 min de leitura
Consultar em lote significa pedir vários documentos de uma vez, a partir de um ponto de referência (o NSU); consultar individualmente significa buscar um documento específico já conhecido. Os dois têm seu lugar, dependendo do que você já sabe no momento da consulta.
Vantagens do lote
A consulta em lote (a forma como a API de notas tomadas do Ambiente Nacional funciona por padrão) é o caminho natural para descobrir o que é novo desde a última verificação. Em vez de perguntar “essa nota específica chegou?” repetidamente, você pergunta “o que mudou desde o último NSU que eu processei?” uma vez, e recebe tudo de uma vez (dentro do limite por chamada).
Quando usar consulta individual
Faz sentido quando você já tem a identificação de um documento específico e só precisa confirmar ou reobter aquele registro pontual, por exemplo, para reprocessar uma nota que falhou ao ser tratada da primeira vez, sem precisar repetir toda a consulta em lote desde aquele ponto.
Impacto no desempenho
Usar consulta individual como estratégia principal de monitoramento (verificando nota por nota, em vez de em lote) multiplica o número de chamadas necessárias e o tempo total de sincronização, sem trazer benefício real quando o objetivo é descobrir tudo que é novo. O lote é mais eficiente exatamente para esse caso de uso.
Perguntas frequentes
A consulta em lote tem limite de notas por chamada?
Sim, cada chamada devolve um número limitado de documentos, não a base inteira de uma vez. Volumes maiores exigem repetir a consulta em sequência, avançando o NSU a cada chamada, até não haver mais nada novo.
É possível misturar as duas abordagens?
Sim, e é comum: lote como estratégia principal de monitoramento contínuo, e consulta individual como complemento para reprocessar casos pontuais que falharam. Se algum termo desta explicação não for familiar, veja o glossário técnico de termos usados em APIs de notas fiscais.
Decidir entre lote e consulta individual, e lidar com o limite por chamada, é exatamente o tipo de detalhe de implementação que a IntegroBR NFS-e Recebidas resolve por trás: você escolhe o período que quer monitorar, e a IntegroBR cuida da estratégia de consulta.