Guia de integração
Sincronização
Use o cursor retornado pela API e o filtro `atualizadoDesde` para sincronizar recursos sem depender de paginação por número de página.
Exemplo
GET /v1/nfse?limite=50&atualizadoDesde=2026-10-01T00%3A00%3A00Z
Authorization: Bearer <JWT>
# Próxima página: reutilize literalmente o valor de paginacao.proximoCursor
GET /v1/nfse?limite=50&atualizadoDesde=2026-10-01T00%3A00%3A00Z&cursor=<CURSOR_OPACO>Primeira página
Defina o limite (padrão 50, máximo 100) e os filtros necessários. A resposta contém dados e paginacao.
Próximas páginas
Enquanto temMais for verdadeiro, envie proximoCursor sem tentar interpretá-lo. O cursor preserva os filtros originais; mantenha-os iguais durante a paginação.
Atualizações incrementais
atualizadoDesde é inclusivo e a ordenação é determinística por atualizadoEm e id. Portanto, podem ocorrer itens repetidos: faça upsert pela chave id e persista um ponto de retomada com margem de sobreposição.
Observação: O cursor é opaco e não deve ser decodificado, fabricado ou reutilizado com filtros diferentes.
← Voltar ao início