Atualmente, as requisições de consulta por padrão, tem em seu retorno, um limite máximo de 100. Este limite é colocado para manter a eficiência no processo de consulta, trazendo as informações sempre de forma veloz.
"Mas e se eu precisar aplicar um filtro que me retorne mais de 100 registros?"
Sabendo que uma consulta retorna atualmente no máximo 100 registros, você pode implementar o conceito de paginação e fazer quantas consultas forem necessárias para retornar todos os registros desejados.
Mas para isso, precisamos garantir que cada consulta não duplique registros já previamente retornados.
Sendo assim, retornamos um campo a mais em nossa consulta, o campo "hashProximaPagina".
Exemplificando de forma Prática
Nesse exemplo, iremos utilizar o Postman. Caso você ainda não saiba como utilizá-lo, nós temos um post que explica como instalar e utilizar.
Caso você ainda não saiba como fazer uma requisição HTTP para o PlugNotas, nós também temos uma documentação para te auxiliar.
Considere a seguinte consulta: Todas as Destinadas do dia 16/10/21 ao dia 16/11/2021
https://api.plugnotas.com.br/nfe/destinada?dataInicial=2021-10-16&dataFinal=2021-11-16&cpfCnpj=29062609000177
Note que, ele irá trazer os 100 registros que tiver no período solicitado e retornar um hash para a próxima pagina.
https://api.plugnotas.com.br/nfe/destinada?dataInicial=2021-10-16&dataFinal=2021-11-16&cpfCnpj=29062609000177&hashProximaPagina=6193cd70fc7865572ac4bbf5
A nova consulta nos trouxe uma nova lista de notas, e devemos continuar consultando conforme esse procedimento até que o PlugNotas retorne a mensagem ""hashProximaPagina": null,", indicando não haver mais paginações para seguir.
Comentários
0 comentário
Por favor, entre para comentar.