Percorra lançamentos por período

Objetivo e pré-requisitosCopiar link da seção

Ler lançamentos de um intervalo com transactions:read. Configure chave e origem no servidor. Use um período inclusivo de até 366 dias.

1. Execute o exemplo completoCopiar link da seção

Baixe TypeScript ou Python. Os arquivos exibidos em Exemplos são os mesmos disponíveis para download.

npx tsx read-transactions.ts 2026-01-01 2026-01-31
# Ou, com Python 3:
python read-transactions.py 2026-01-01 2026-01-31

2. Percorra mantendo o contextoCopiar link da seção

O exemplo faz a requisição inicial, valida a resposta, trata tentativas e acompanha meta.nextCursor. Adapte o ponto de processamento dos itens para seu destino, usando id como identificador estável.

3. Valide o resultadoCopiar link da seção

Verifique término por hasMore: false, ausência de cursor repetido e manutenção de filtros. Preserve valores como strings. Não registre payloads financeiros para depurar.

Compras compostasCopiar link da seção

Para consultar um equipamento, acrescente assetId com seu UUID. Categoria e centro podem ser combinados na mesma consulta. Mantenha todos os filtros também nas páginas seguintes; a composição não multiplica a compra na paginação.

Use reportAmount para apresentar o principal selecionado e mantenha amount como original auditável. Não some compositionLines novamente sobre reportAmount: a composição completa já explica o lançamento. Para caixa efetivamente pago, consulte os relatórios com os mesmos filtros.

Erros comuns e limitesCopiar link da seção

Cursor expirado exige reiniciar a consulta. Se o processo parar, evite duplicatas por ID ao repetir. A API exclui apagados e não garante snapshot ou feed incremental: entenda as limitações.

Próximos passosCopiar link da seção

Para indicadores, utilize a receita de relatórios; não some indiscriminadamente os lançamentos retornados.