Lançamentos

O extrato de fato: cada crédito e débito ocorrido em uma conta financeira, classificado por categoria e centro de classificação. O endpoint aggregates devolve totais em vez da lista inteira.

Comando	HTTP	Descrição
financial-transactions list	GET /v1/financial-transactions	Listar transações
financial-transactions create	POST /v1/financial-transactions	Criar transação
financial-transactions get	GET /v1/financial-transactions/{id}	Obter transação por ID
financial-transactions update	PATCH /v1/financial-transactions/{id}	Atualizar transação
financial-transactions delete	DELETE /v1/financial-transactions/{id}	Excluir transação
financial-transactions aggregates list	GET /v1/financial-transactions/aggregates	Somar totais de transações
financial-transactions ids list	GET /v1/financial-transactions/ids	Listar IDs de transações

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 transações
kobana finance financial-transactions list \
  --fields "id,company_id,financial_account_id,description,bank_description"

# Obter transação por ID
kobana finance financial-transactions get \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}'

# Criar transação
kobana finance financial-transactions create \
  --json '{"company_id": "COMPANY_ID", "financial_account_id": "FINANCIAL_ACCOUNT_ID", "description": "DESCRIPTION", "amount": "1500.00", "occurred_at": "2026-01-31T12:00:00Z"}'

# Atualizar transação
kobana finance financial-transactions update \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}' \
  --json '{"description": "DESCRIPTION", "bank_description": "BANK_DESCRIPTION", "document": "DOCUMENT"}'

# Excluir transação
kobana finance financial-transactions delete \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}' \
  --dry-run

Próximos passos

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