Meu Dinheiro · API
Relatórios

Saldo de cada conta numa data

GET
/relatorios/saldos

O saldo de cada conta ao fim de data, como no card Saldos de caixa: saldo inicial e todos os lançamentos até a data, com a fatura do cartão projetada na conta que a paga. projetado inclui o que vence até a data e ainda não foi pago; confirmado, só o realizado.

Exige a permissão de ver Saldos de caixa, Extrato de contas, Lançamentos de caixa ou Fluxo de caixa.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de consulta

data?string

O dia do saldo. Sem o parâmetro, hoje.

Formatodate
status?string

Quais lançamentos entram, separados por vírgula. pendente: vencido e não pago; agendado: a vencer; confirmado: pago ou recebido; conciliado: conferido com o extrato. Sem o parâmetro, todos.

moeda?string

Código ISO 4217. Só entram as contas nessa moeda, e não há conversão. Sem o parâmetro, a moeda padrão do workspace, ou a da conta quando contas filtra uma só.

pendentes_no_presente?boolean

No regime de caixa, o pendente vencido conta como de hoje (e entra no período que contém hoje). Sem o parâmetro, a configuração do workspace.

contas?string

Ids de contas, separados por vírgula.

categorias?string

Ids de categorias, separados por vírgula. A categoria inclui as subcategorias dela.

centros?string

Ids de centros de custo, separados por vírgula.

contatos?string

Ids de contatos, separados por vírgula.

projetos?string

Ids de projetos, separados por vírgula.

tags?string

Ids de tags, separados por vírgula.

formas_pagamento?string

Ids de formas de pagamento, separados por vírgula.

Corpo da resposta

Os saldos.

application/json
  1. response
moeda*string
data_saldo*string
Formatodate
data*array<>
total*
curl -X GET "https://example.com/relatorios/saldos"
{  "moeda": "BRL",  "data_saldo": "2019-08-24",  "data": [    {      "conta": {        "id": 0,        "nome": "string"      },      "projetado": 0,      "confirmado": 0    }  ],  "total": {    "projetado": 0,    "confirmado": 0  }}

Receitas × despesas GET

Receitas, despesas e o resultado do período, com as transferências à parte. É o Resultado do mês da visão geral; com `intervalo`, a evolução dele. Exige a permissão de ver Resultados do mês, Comparação entre períodos ou Lançamentos de caixa.

Fluxo de caixa GET

Saldo inicial, entradas, saídas, resultado e saldo acumulado por período, no total e por conta, como na tela Fluxo de caixa. Entram as contas de caixa (disponíveis, ativas, na moeda pedida; sem cartão nem carteira de investimentos), e a fatura do cartão aparece projetada na conta que a paga. Os valores são os projetados: `status` decide o que entra. Os pendentes vencidos seguem a configuração do workspace (o `pendentes_no_presente` não se aplica aqui, como na tela). Exige a permissão de ver Fluxo de caixa.