Categorias

O plano de contas: a árvore de receitas e despesas pela qual todo lançamento é classificado.

Comando	HTTP	Descrição
categories list	GET /v1/categories	Listar categorias
categories create	POST /v1/categories	Criar categoria
categories get	GET /v1/categories/{id}	Obter categoria por ID
categories update	PATCH /v1/categories/{id}	Atualizar categoria
categories delete	DELETE /v1/categories/{id}	Excluir categoria

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 categorias
kobana finance categories list --fields "id,company_id,name,parent_id,level"

# Obter categoria por ID
kobana finance categories get --params '{"id": "CATEGORIE_ID"}'

# Criar categoria
kobana finance categories create \
  --json '{"company_id": "COMPANY_ID", "name": "NAME", "type": "debit"}'

# Atualizar categoria
kobana finance categories update \
  --params '{"id": "CATEGORIE_ID"}' \
  --json '{"name": "NAME", "type": "debit"}'

# Excluir categoria
kobana finance categories delete --params '{"id": "CATEGORIE_ID"}' --dry-run

Próximos passos

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