Lista o fluxo de caixa
GET/accounts/cash-flow
Retorna o fluxo de caixa da empresa em dois modos, controlados pelo parâmetro Type:
- Resumo (default, sem
Type): consolidado mês a mês (ou dia a dia, comGroupBy=day) do previstoTotalValuee do realizadoValuePaid, agrupado por plano de contas. Cada item inclui a árvore completa do plano de contas emCategoryTree. Considera o ano inteiro definido emYear(ou o ano corrente quando omitido) e ignora contas com status Não lançado. - Detalhe (
Type=Detail): lista os títulos individuais (AccountsPayableReceivable) que compõem uma célula do resumo. UseIDTypeAccountPayableReceivablepara restringir ao plano de contas selecionado eDate(primeiro dia do mêsYYYY-MM-DD) combinado comDateTypepara restringir ao mês —DateType=DateDuefiltra pelo vencimento (coluna Previsto); qualquer outro valor (a UI enviaDatePayment) filtra pela data de pagamento lançado (coluna Realizado).
Valores são assinados pelo tipo de lançamento: contas a pagar (IDTypeAccount=1) entram negativas; contas a receber (IDTypeAccount=0) entram positivas.
Request
Responses
- 200
- 400
- 500
Fluxo de caixa retornado. O formato depende de Type: array de itens consolidados (modo Resumo) ou array de títulos individuais (modo Detalhe). Quando não há registros no Resumo, retorna [].
Validação falhou (prefixo [BadRequest]). Mensagem possível: Erro na configuração da empresa — emitida quando a empresa autenticada não tem identificador válido para a conta resolvida.
Erro interno (prefixo Error:).