Contas financeiras

As contas em que o dinheiro entra e sai — conta corrente, caixa, cartão. Todo lançamento, pagamento e recebimento aponta para uma conta financeira, e é o saldo dela que o fluxo de caixa projeta.

Comando	HTTP	Descrição
financial-accounts list	GET /v1/financial-accounts	Listar contas financeiras
financial-accounts create	POST /v1/financial-accounts	Criar conta financeira
financial-accounts get	GET /v1/financial-accounts/{id}	Obter conta financeira por ID
financial-accounts update	PATCH /v1/financial-accounts/{id}	Atualizar conta financeira
financial-accounts delete	DELETE /v1/financial-accounts/{id}	Excluir conta financeira
financial-accounts adjust-balance	POST /v1/financial-accounts/{id}/adjust-balance	Ajustar saldo da conta

Exemplos

--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar contas financeiras
kobana finance financial-accounts list \
  --fields "id,company_id,name,type,bank_id"

# Obter conta financeira por ID
kobana finance financial-accounts get \
  --params '{"id": "FINANCIAL_ACCOUNT_ID"}'

# Criar conta financeira
kobana finance financial-accounts create \
  --json '{"company_id": "COMPANY_ID", "name": "NAME", "type": "checking"}'

# Atualizar conta financeira
kobana finance financial-accounts update \
  --params '{"id": "FINANCIAL_ACCOUNT_ID"}' \
  --json '{"company_id": "COMPANY_ID", "name": "NAME", "type": "checking"}'

# Ajustar saldo da conta
kobana finance financial-accounts adjust-balance \
  --params '{"id": "FINANCIAL_ACCOUNT_ID"}' \
  --json '{"target_balance": "1500.00", "category_id": "CATEGORY_ID"}'

# Excluir conta financeira
kobana finance financial-accounts delete \
  --params '{"id": "FINANCIAL_ACCOUNT_ID"}' \
  --dry-run

Próximos passos

• Lançamentos
• Introspecção de schema — todos os parâmetros que este recurso aceita.