Saltar al contenido principal

Uso

Sintaxis​

kobana <producto> <recurso> <metodo> [flags]
  • <producto> — banking, finance, billing o inbox.
  • <recurso> — puede ser anidado: payables, receivables, attachments links.
  • <metodo> — la acción: list, get, create, update, delete, o una acción específica del recurso.

La versión de la API nunca entra en el comando — el CLI resuelve la URL a partir de la spec OpenAPI embebida.

Los parámetros de URL y de query van en --params; el cuerpo de la solicitud va en --json.

Toda la superficie se descubre con --help, en cualquier nivel:

kobana --help                             # productos
kobana finance --help                     # recursos de Finanzas Inteligentes
kobana finance financial-accounts --help  # métodos de un recurso

Recursos de finance​

RecursoDescripción
financial-accountsCuentas financieras
financial-transactionsMovimientos
payablesCuentas por pagar
receivablesCuentas por cobrar
cash-flowFlujo de caja
reconciliationsConciliaciones
categoriesCategorías
classification-centersCentros de clasificación
automatic-rulesReglas automáticas
peoplePersonas
companiesEmpresas
taxesImpuestos
attachmentsAdjuntos
receiptsComprobantes
transfersTransferencias
banksBancos

Cada recurso tiene su propia página, con la tabla completa de comandos y ejemplos — mira el catálogo.

Ejemplos​

# Cuentas por pagar abiertas
kobana finance payables list \
  --params '{"status": "pending"}' \
  --fields "id,description,amount,due_date"

# Totales agregados en vez de la lista entera
kobana finance payables aggregates --params '{"group_by": "category"}'

# Enviar una cuenta al banco para pago
kobana finance payables send-to-bank --dry-run --params '{"id": "PAYABLE_ID"}'

# Flujo de caja del mes
kobana finance cash-flow list \
  --params '{"start_date": "2026-01-01", "end_date": "2026-01-31"}'

# Conciliar un movimiento con un título
kobana finance reconciliations create \
  --json '{"financial_transaction_id": "TRANSACTION_ID", "payable_id": "PAYABLE_ID"}'

# Listar con paginación automática (NDJSON)
kobana finance financial-transactions list --page-all --fields "id,amount,date"

# Salida en tabla
kobana finance financial-accounts list --output-format table

# Guardar la respuesta en un archivo
kobana finance payables get --params '{"id": "PAYABLE_ID"}' --output conta.json

Próximos pasos​