Guias

Consumo

Eventos cobrados no período e o extrato do mês.

Consumo do período

GET /v1/consumo?de=2026-09-01&ate=2026-09-30 → um evento por execução cobrável, com o valor da faixa na hora em que concluiu, os ajustes (estornos), o liquido e o valor_provisorio.

curl 'https://sync.lops.com.br/v1/consumo?de=2026-09-01&ate=2026-09-30' \
  -H "Authorization: Bearer $SYNC_CHAVE"
  • Sem de/ate, vale do dia 1 do mês até hoje.
  • "provisorio": true até o extrato do mês ser aprovado: o extrato recalcula tudo no dia 1 e é ele que vale.
  • Execução refeita ganha um ajuste negativo (quantidade: -1); o evento original nunca muda.

Extrato do mês

GET /v1/extratos/2026-09 → o extrato do mês (linhas, subtotal, complemento_minimo, creditos_usados, ativacao, total), com "provisorio": true até ser aprovado.

HTTP erro Significa
404 sem_extrato O mês ainda não foi calculado
422 mes_invalido Mês fora do formato AAAA-MM