Projecoes Financeiras

Crie e gerencie projecoes financeiras mensais com cenarios otimista, realista e pessimista. Gere projecoes automaticamente baseadas no historico.

GET/api/projections

Lista projecoes financeiras por ano.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`year`(query)	`integer`	Nao	Ano das projecoes

bash

curl -s "https://flow.seudominio.com/api/projections?year=2026" \
  -H "Authorization: Bearer $TOKEN" | jq .

200Lista de projecoes

json

{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "month": "Marco",
      "year": 2026,
      "monthNumber": 3,
      "revenue": 35000.00,
      "expense": 12000.00,
      "optimistic": 42000.00,
      "realistic": 35000.00,
      "pessimistic": 28000.00
    },
    {
      "id": "clx...",
      "month": "Abril",
      "year": 2026,
      "monthNumber": 4,
      "revenue": 38000.00,
      "expense": 13000.00,
      "optimistic": 45000.00,
      "realistic": 38000.00,
      "pessimistic": 30000.00
    }
  ]
}

POST/api/projections

Cria ou atualiza uma projecao para um mes especifico.

Body

Nome	Tipo	Obrigatorio	Descricao
`month`	`string`	Sim	Nome do mes
`year`	`integer`	Sim	Ano
`monthNumber`	`integer`	Sim	Numero do mes (1-12)
`revenue`	`number`	Sim	Receita projetada
`expense`	`number`	Sim	Despesa projetada
`optimistic`	`number`	Nao	Cenario otimista
`realistic`	`number`	Nao	Cenario realista
`pessimistic`	`number`	Nao	Cenario pessimista

curl -X POST "https://flow.seudominio.com/api/projections" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "month": "Marco",
    "year": 2026,
    "monthNumber": 3,
    "revenue": 35000.00,
    "expense": 12000.00,
    "optimistic": 42000.00,
    "realistic": 35000.00,
    "pessimistic": 28000.00
  }'

GET/api/projections/{id}

Retorna detalhes de uma projecao.

PUT/api/projections/{id}

Atualiza uma projecao existente.

bash

curl -X PUT "https://flow.seudominio.com/api/projections/clx123" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "revenue": 40000.00, "optimistic": 48000.00 }'

DELETE/api/projections/{id}

Remove uma projecao.

bash

curl -X DELETE "https://flow.seudominio.com/api/projections/clx123" \
  -H "Authorization: Bearer $TOKEN"

Proximos 12 Meses

GET/api/projections/next-12-months

Retorna projecoes para os proximos 12 meses.

curl -s "https://flow.seudominio.com/api/projections/next-12-months" \
  -H "Authorization: Bearer $TOKEN" | jq .

200Projecoes 12 meses

json

{
  "success": true,
  "data": [
    { "month": "Marco", "year": 2026, "monthNumber": 3, "revenue": 35000, "expense": 12000, "optimistic": 42000, "realistic": 35000, "pessimistic": 28000 },
    { "month": "Abril", "year": 2026, "monthNumber": 4, "revenue": 38000, "expense": 13000, "optimistic": 45000, "realistic": 38000, "pessimistic": 30000 },
    "..."
  ]
}

Geracao Automatica

POST/api/projections/generate

Gera projecoes automaticamente baseadas no historico financeiro.

bash

curl -X POST "https://flow.seudominio.com/api/projections/generate" \
  -H "Authorization: Bearer $TOKEN"

200Projecoes geradas

json

{
  "success": true,
  "message": "Projecoes geradas com sucesso para os proximos 12 meses",
  "data": {
    "generated": 12,
    "basedOnMonths": 6
  }
}