Kobana

Tu financiero disponible vía API

10 recursos REST con autenticación JWT, alcances por operación, paginación por cursor e idempotencia en escrituras. Las mismas reglas de negocio que la UI — sin backdoor, sin lógica paralela.

API Pública
Ver documentación de la APIAgendar demostración
API Pública del Financiero Inteligente
10
recursos disponibles
OpenAPI 3
spec disponible
Cursor
paginación
JWT + alcances
autenticación

10 recursos, cobertura completa del back-office

Cuentas Financieras
accounts

Lista y consulta cuentas financieras. Saldo calculado en tiempo real retornado en la respuesta.

Categorías
categories

Lee el plan de cuentas completo (3 niveles). Integra con tu ERP para mantener categorías sincronizadas.

Centros de Costo
cost_centers

Lista centros de costo para populación de formularios en sistemas externos.

Empresas
companies

Lista las empresas del workspace. Útil para integrar informes multi-empresa en dashboards externos.

Personas
people

CRUD completo de proveedores y clientes con validación de CPF/CNPJ.

Impuestos
taxes

Lista y consulta impuestos de retención configurados en el workspace.

Cuentas por Pagar
payables

CRUD completo. Crea, lee, actualiza y lista con filtros por estado, vencimiento, proveedor y categoría.

Cuentas por Cobrar
receivables

CRUD completo. Misma estructura de payables para consistencia de integración.

Transacciones
transactions

Lista y consulta transacciones de cuentas financieras con filtros de fecha y valor.

Adjuntos
attachments

Upload, download y listado de archivos. Download vía streaming seguro con autenticación.

API construida para integración de producción

Autenticación Bearer JWT
Token JWT en el header Authorization: Bearer. Alcances granulares por recurso y operación (finance.payables, finance.payables.write).
  • Alcances independientes por recurso
  • Separación read/write
  • Misma validación de tenant que la UI
Paginación por Cursor
Paginación estable para grandes volúmenes de datos. El cursor garantiza resultados consistentes aunque se creen datos durante la iteración.
  • cursor y per_page en los parámetros
  • next_cursor en la respuesta
  • Sin saltos ni duplicados
Idempotencia en Escrituras
Envía el header Idempotency-Key en operaciones de creación. Re-envíos con la misma clave retornan el resultado original sin crear duplicados.
  • Header Idempotency-Key en las mutaciones
  • Seguro para retry en fallos de red
  • Resultado cacheado por 24h
Multi-tenant Nativo
El JWT determina el workspace. Imposible acceder a datos de otro tenant. Todas las queries están escopadas por el workspace_id del token.
  • Aislamiento total por workspace
  • Sin parámetro de tenant en el path
  • Misma seguridad que la UI
Mismas Reglas de Negocio
La API usa los mismos servicios, validaciones y reglas automáticas de la interfaz. Crear un lanzamiento vía API dispara las mismas reglas de clasificación.
  • Validación de CPF/CNPJ
  • Reglas automáticas disparan
  • Sin lógica paralela ni backdoor
OpenAPI 3 Disponible
Especificación completa en /public/openapi-v1.yaml. Viewer interactivo con Scalar en /docs. Importa directamente en Postman, Insomnia o cualquier cliente REST.
  • Schemas completos por recurso
  • Ejemplos de request/response
  • Testeable directamente en el browser

Integra en minutos

Ejemplo de creación de cuenta por pagar vía API:

curl -X POST https://app.finance.kobana.com.br/api/v1/payables \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "description": "Proveedor ABC - NF 1234",
    "amount": 5000.00,
    "due_date": "2026-07-15",
    "person_id": "per_abc123",
    "category_id": "cat_xyz456",
    "company_id": "cmp_def789"
  }'

Preguntas frecuentes

Integra tu ERP o sistema legado

La API REST permite que tu sistema continúe siendo el sistema de record — y el Financiero Inteligente entra como capa de automatización y pagos.

Ver documentación de la APIVer todas las funcionalidades
Agendar