Atualmente, as requisições de consulta por padrão, tem em seu retorno, um limite máximo de 30 key's. 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 30 registros?"

Sabendo que uma consulta retorna atualmente no máximo 30 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 "last_id".

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 NFe's do dia 2022-04-06 ao dia 2022-05-06

https://app.plugstorage.com.br/api/invoices/keys?token=2426c2020bba73334f6f43eed67587a90e89ea28&date_ini=2022-04-06&date_end=2022-05-06&mod=NFE&transaction=RECEIVED

Note que, ele irá trazer os 30 registros que tiver no período solicitado e retornar um last_id para a próxima pagina. 

https://app.plugstorage.com.br/api/invoices/keys?token=2426c2020bba73334f6f43eed67587a90e89ea28&date_ini=2022-04-06&date_end=2022-05-06&mod=NFE&transaction=RECEIVED&last_id=187911744