Saltar al contenido principal

Movimientos

El extracto en sí: cada crédito y débito ocurrido en una cuenta financiera, clasificado por categoría y centro de clasificación. El endpoint aggregates devuelve totales en lugar de la lista completa.

ComandoHTTPDescripción
financial-transactions listGET /v1/financial-transactionsListar movimientos
financial-transactions createPOST /v1/financial-transactionsCrear movimiento
financial-transactions getGET /v1/financial-transactions/{id}Obtener movimiento por ID
financial-transactions updatePATCH /v1/financial-transactions/{id}Actualizar movimiento
financial-transactions deleteDELETE /v1/financial-transactions/{id}Eliminar movimiento
financial-transactions aggregates listGET /v1/financial-transactions/aggregatesSumar totales de movimientos
financial-transactions ids listGET /v1/financial-transactions/idsListar IDs de movimientos

Ejemplos​

--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar movimientos
kobana finance financial-transactions list \
  --fields "id,company_id,financial_account_id,description,bank_description"

# Obtener movimiento por ID
kobana finance financial-transactions get \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}'

# Crear movimiento
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"}'

# Actualizar movimiento
kobana finance financial-transactions update \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}' \
  --json '{"description": "DESCRIPTION", "bank_description": "BANK_DESCRIPTION", "document": "DOCUMENT"}'

# Eliminar movimiento
kobana finance financial-transactions delete \
  --params '{"id": "FINANCIAL_TRANSACTION_ID"}' \
  --dry-run

Próximos pasos​