Integración Gateway Bancario (Kobana)
Sistema > Integraciones > Kobana (/settings/integrations/kobana). La integración permite:
- Envío de pagos al banco — despachar cuentas por pagar autorizadas, título a título o en lote.
- Sincronización de cuentas bancarias — entre Kobana y Finanzas Inteligentes.
- Sincronización de extracto bancario — traer las transacciones de las cuentas vinculadas.
- Liquidación automática — confirmado el pago, la cuenta se da de baja y se crea la transacción. Depende de que el título tenga definido el "Pagar desde": sin saber de qué cuenta salió el dinero, el sistema no lo adivina, y la baja te queda a ti para hacerla a mano.
Conectar
La franja superior muestra el Estado — Conectado, No conectado o Error de conexión — y el token.
Sin conexión, el botón es "Conectar": pega el token de API generado en el panel de Kobana. "El token se almacena cifrado." El sistema lo valida e informa cuántas cuentas están visibles.
Ya conectado, el botón pasa a "Gestionar conexión".
"Desconectar" no está en la página. Vive dentro del diálogo "Gestionar conexión con Kobana", junto a "Actualizar". La confirmación tranquiliza: "Solo se elimina la conexión. Las cuentas y datos ya sincronizados permanecen en Finanzas Inteligentes."
Sincronizaciones
Las dos sincronizaciones exigen una empresa específica en el selector del encabezado: "Selecciona una empresa específica en el selector del encabezado, no 'Todas las empresas'. Las cuentas sincronizadas se asignan a la empresa que elijas."
Cuentas bancarias
No existe un listado para vincular cuentas a mano. Hay un botón — "Sincronizar cuentas bancarias" — que hace todo el trabajo y vincula solo.
Esta sincronización es bidireccional y ESCRIBE en Kobana. La tarjeta lleva el sello "Bidireccional", y no es adorno: además de importar las cuentas registradas en Kobana, crea en Kobana las cuentas que solo existen aquí. Por eso hay una confirmación obligatoria, que dice lo que está en juego: "Crear cuentas en Kobana modifica el sistema externo."
Es la única operación de la integración que modifica el sistema externo sin ser un pago. Si solo quieres traer las cuentas de allá, ten en cuenta que el camino de vuelta ocurre junto.
Extracto bancario
"Sincronizar extracto bancario" "importa el extracto bancario de las cuentas vinculadas (en la empresa seleccionada): trae las transacciones de Kobana a Finanzas Inteligentes, sin duplicar las ya importadas."
El botón es uno solo y cubre todas las cuentas vinculadas de la empresa — no hay un botón por cuenta. Las líneas importadas alimentan la Conciliación.
Autorización de pagos
Cuando la autorización está activada (el valor por defecto del espacio de trabajo), un título creado por formulario, CSV o API no queda disponible para el envío hasta que una persona lo autorice en Autorizar pagos. Con la autorización desactivada, el título nace oficial y listo para enviar. Ver Ciclo de vida.
Envío de pagos
Con la integración activa y el título autorizado, usa "Enviar al banco" — acción manual, en la pantalla de detalle. Desde el listado, el camino es "Enviar pagos", que despacha en lote. Ver Envío al banco.
Sincronización automática
Esta sección solo aparece si el servidor tiene configurada una dirección pública de webhook. Sin eso no hay forma de que el gateway avise de nada, y ni ella ni las dos secciones siguientes se dibujan.
Un interruptor: "Mantiene al día el estado de los pagos enviados por sí solo, sin hacer clic en 'Actualizar estado'."
Es opcional, y apagada no te quedas sin información — solo tienes que buscar el estado a mano, con el "Actualizar estado" de cada título.
Notificaciones
Otro interruptor: "Recibe un aviso en la campana cuando cambie el estado de un pago (confirmado, programado, rechazado…)."
Los dos interruptores conversan: sin la sincronización automática activada, "los avisos pueden llegar con retraso" — la campana solo avisa cuando el sistema descubre el cambio.
Entregas del webhook
Tabla de diagnóstico: "Registro de cada evento de cambio de estado que envía el gateway de pagos de Kobana. Si alguno falla, puedes reenviarlo." Tiene "Actualizar" y, por línea, el reenvío.
Es donde mirar cuando un pago parece trabado: si el evento no llegó, el estado de aquí se queda atrás del banco.
Esta tabla solo existe con la sincronización automática activada. Es ella la que hace que el gateway mande los eventos — apagada, no hay entrega que registrar, y la sección desaparece de la página.
Historial
Registro de las sincronizaciones ejecutadas, por Fecha, Tipo (Cuentas o Extracto bancario) y Resultado — con cuántas fueron creadas, actualizadas, enviadas u omitidas.