skills/granatum-financeiro/references/fluxo-caixa.md

# Fluxo de caixa

Relatório de caixa. Regime **sempre `caixa`**: conta o que efetivamente entrou e
saiu, pela data de pagamento.

## Parâmetros

`obter_fluxo_caixa` com:

- `periodicidade` - `mensal` por padrão. Usar `trimestral`, `semestral` ou
  `anual` quando o usuário pedir essa granularidade explicitamente.
- `quantidade_periodos` - 6 por padrão. A série histórica é o que dá sentido ao
  número do mês; não pedir um período só.
- `periodo_referencia` - último período da janela. Omitir usa o último período
  completo. Formato conforme a periodicidade (ver a skill principal).
- `limite_categorias` - 10 por padrão.

Aplicar `conta_ids`, `categoria_ids` ou `centro_custo_lucro_ids` apenas quando o
usuário restringir. Ao aplicar um filtro, declarar isso na resposta.

## Apresentação

1. **Período de referência**: recebido, pago, líquido. Saldo inicial e final.
2. **Tendência**: como o líquido e o saldo acumulado se comportaram nos períodos
   da série. Uma sequência de meses negativos importa mais que o valor de um mês.
3. **Principais categorias**: o que mais pesou nas entradas e nas saídas.
4. **Comparação** com o período anterior, em valor e percentual.

Considerar um gráfico de linha do saldo acumulado quando houver 4 ou mais
períodos - a trajetória comunica melhor que a tabela.

## Regras

- Declarar que o regime é caixa e o que isso significa: só o que foi pago ou
  recebido de fato. Boleto emitido e não pago não aparece aqui.
- Se o usuário perguntar por que o fluxo de caixa não bate com a DRE, a resposta
  está na diferença de regime - explicar e oferecer os dois lado a lado.
- Drill-down usa `obter_lancamentos` com `regime: caixa` e os `categoria_ids` da
  linha investigada.
- Resultado zerado: aplicar o diagnóstico da skill principal antes de reportar
  ausência de dados.