Empresas

As empresas do grupo. Toda conta, título e lançamento pertence a uma delas, e quase todo filtro aceita company_id.

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

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 empresas
kobana finance companies list --fields "id,name,cnpj,type,active"

# Obter empresa por ID
kobana finance companies get --params '{"id": "COMPANIE_ID"}'

# Criar empresa
kobana finance companies create \
  --json '{"name": "ACME Comércio Ltda", "cnpj": "12345678000190"}'

# Atualizar empresa
kobana finance companies update \
  --params '{"id": "COMPANIE_ID"}' \
  --json '{"name": "NAME", "active": true, "trade_name": "TRADE_NAME"}'

# Excluir empresa
kobana finance companies delete --params '{"id": "COMPANIE_ID"}' --dry-run

Próximos passos

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