OData · Fato
CashBalancePeriods
Saldos mensais por conta — Saldo de abertura, movimento e saldo final calculados por mês a partir do saldo inicial cadastrado e dos lançamentos bancários.
- Endereço
/odata/v1/CashBalancePeriods- Chave
id- Escopo
finance.read- Campos
- 11
Filtro obrigatório
Toda consulta precisa filtrar por periodStart. Sem isso a resposta é 400 — a tabela é grande demais para ser varrida inteira.
Campos
| Campo | O que é | Tipo | Nulo | Filtrável | Ordenável |
|---|---|---|---|---|---|
idchave | Identificador da linha. | Edm.Stringtexto | — | — | — |
periodStart | Primeiro dia do mês do modelo agregado. Os modelos derivados exigem filtro por este campo. | Edm.Datedata | sim | obrigatório | sim |
account | Conta. | Edm.Stringtexto | sim | sim | sim |
subaccount | Subconta. | Edm.Stringtexto | sim | sim | sim |
openingBalance | Saldo inicial cadastrado da conta. É o ponto de partida do saldo projetado — negativo é saldo legítimo, não erro. | Edm.Doublenúmero | sim | — | — |
periodCredit | Créditos do mês, em valor absoluto. | Edm.Doublenúmero | — | — | — |
periodDebit | Débitos do mês, em valor absoluto. | Edm.Doublenúmero | — | — | — |
netMovement | Créditos menos débitos do mês. | Edm.Doublenúmero | — | — | — |
closingBalance | Saldo ao final do mês. É posição: use o último mês do recorte, não some vários meses. | Edm.Doublenúmero | sim | — | — |
movementCount | Quantidade de lançamentos no mês da conta. | Edm.Int64inteiro | — | — | — |
balanceAvailable | Indica se existe saldo inicial cadastrado para calcular a posição da conta. | Edm.Booleanbooleano | — | — | — |
Exemplos
curl
curl -H "Authorization: Bearer oag_SEU_TOKEN" \
"https://service.agrosti.com.br/odata/v1/CashBalancePeriods?$filter=periodStart ge 2025-01-01"Power Query
let
Fonte = OData.Feed(
"https://service.agrosti.com.br/odata/v1/CashBalancePeriods",
null,
[Headers = [#"Authorization" = "Bearer oag_SEU_TOKEN"], Implementation = "2.0"]
)
in
FonteSintaxe completa em OData.