# 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`.

```bash
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` |