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 aprobadas, 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.
- Sincronización de personas — mantener clientes y proveedores iguales de los dos lados, en ambos sentidos.
- Liquidación automática — confirmado el pago, la cuenta se liquida 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.
- Generación de cobros — emitir un boleto o un Pix desde una cuenta por cobrar, para que el cliente pague.
- Comprobantes de pago — capturar automáticamente el comprobante de cada pago confirmado.
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 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 por sí 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.
Personas
"Enviar personas" sincroniza el registro en ambos sentidos: trae de Kobana a quien solo existe allá y envía desde aquí los clientes y proveedores de la empresa seleccionada que aún no están en Kobana. La tarjeta también lleva el sello "Bidireccional".
También ESCRIBE en Kobana, y por eso pide confirmación: "Crear registros en Kobana modifica el sistema externo."
Nadie se duplica. El cotejo es por CPF/CNPJ — y, para quien ya fue enviado desde aquí antes, por el vínculo guardado en ese envío. Quien ya existe en ambos lados simplemente queda vinculado; los datos que registraste aquí no se sobrescriben.
Una persona sin CPF/CNPJ no se envía. Sin el documento no hay forma de saber si ya está allá, y el envío prefiere dejarla fuera antes que arriesgar un registro repetido. Al final la sincronización indica cuántas quedaron así — completa el documento y vuelve a ejecutar. La importación no tiene ese límite.
Cada ejecución envía hasta 200 personas. Si tu base es mayor, ejecútala de nuevo: lo que ya se envió no se reenvía.
Aprobación de pagos
Cuando la aprobació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 apruebe en Aprobar pagos. Con la aprobació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 aprobado, 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.
Generación de cobros
La integración también funciona en la dirección del dinero que entra: desde una cuenta por cobrar, "Generar cobro" emite un boleto o un Pix para que el cliente pague, y el cobro pagado liquida el título automáticamente.
Cada camino tiene su requisito en la cuenta del gateway — el boleto necesita un convenio, el Pix una cuenta Pix de cobro — y el boleto exige además la dirección completa del cliente. Ver Cobro por boleto y Pix.
Comprobantes
Confirmado un pago enviado al banco, el comprobante se captura automáticamente: queda guardado en la biblioteca de Adjuntos, aparece en la pantalla del título y se lista en Comprobantes. Quien esté marcado en "Configurar envío" recibe un correo; la campana avisa de todas formas.
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, Extracto bancario o Personas) y Resultado — con cuántas fueron creadas, actualizadas, enviadas u omitidas.
En las dos sincronizaciones bidireccionales el resultado separa los dos sentidos: lo que vino de Kobana aparece como creado o actualizado, y lo que fue desde aquí aparece como enviado. Las personas dejadas fuera por no tener CPF/CNPJ se cuentan como omitidas.