Conexiones bancarias

El módulo de banca de Frihet centraliza tus cuentas bancarias, importa tus extractos con detección automática de duplicados y concilia cada movimiento con tus facturas emitidas y gastos registrados mediante coincidencia difusa y reglas bancarias.

Alcance del módulo bancario

Frihet opera mediante importación de extractos bancarios (OFX, QFX, MT940, CAMT.053 y CSV, con detección automática del formato y selector de banco para CSV) y a través de la API REST /v1/banking y el servidor MCP. La conexión directa por PSD2 / Open Banking no está disponible: concilias tu banco importando extractos, sin entregar credenciales bancarias a terceros.

Si además utilizas neobancos o tarjetas corporativas para pagos operativos, puedes importar gastos bajo demanda con las integraciones específicas de Qonto, Wise, Mercury o Pleo.

Requisitos y separación de canales

Antes de cargar tu primer extracto bancario, ten clara la diferencia entre los tres canales y verifica estos requisitos:

Canal	Estado real en Frihet	Cuándo utilizarlo
Importación de archivos de extracto	Disponible en Finanzas → Bancos	Carga de ficheros OFX, QFX, MT940, CAMT.053 o CSV descargados desde tu banca online, con vista previa y detección de duplicados.
API REST (/v1/banking) y Servidor MCP	Disponible con clave API (fri_...)	Ingesta programática de movimientos (POST /v1/banking/transactions), categorización y emparejamiento desde scripts o agentes IA.
Conexión directa PSD2 / Open Banking en continuo	No disponible (PSD2 / Open Banking no está disponible)	Frihet no solicita credenciales bancarias ni sincroniza cuentas en segundo plano mediante agregadores PSD2; toda carga parte de tus extractos o de /v1/banking.

Requisitos previos en tu cuenta:

1. Tener creada al menos una cuenta en Finanzas → Bancos con la divisa exacta del extracto (por ejemplo, EUR).
2. Contar con la factura emitida en estado Enviada o Vencida (por ejemplo, F-2026-0001) si quieres probar el emparejamiento automático de cobros.
3. Disponer del fichero exportado por tu entidad en codificación UTF-8 sin filas de subtotales manuales intercaladas.

Cuentas bancarias

Puedes dar de alta tantas cuentas bancarias como utilices en tu negocio (cuentas corrientes, cuentas en divisas, tarjetas de crédito o cuentas de pasarelas de cobro).

Ve a Finanzas → Bancos para consultar tus cuentas registradas:

Campo	Descripción
Banco / Entidad	Identificación de la entidad financiera
Nombre de cuenta	Nombre o alias asignado (p. ej., Cuenta Principal EUR)
IBAN	Número de cuenta internacional (validado para 89 países)
Divisa	Moneda de la cuenta (EUR, USD, GBP, etc.)
Saldo registrado	Saldo calculado según los extractos y movimientos
Última importación	Fecha en la que se subieron movimientos por última vez

Ejemplo sintético verificable de extracto CSV

Ejemplo ilustrativo de documentación

Los datos de Estudio Norte S.L. (CIF B12345674, correo facturacion@example.com, factura F-2026-0001) y el extracto CSV siguiente constituyen un fixture sintético de documentación: B12345674 solo acredita validez algorítmica de dígito de control (no inexistencia registral ni titularidad en el censo AEAT) y example.com es un dominio reservado por IANA para documentación (RFC 6761), no un buzón controlado de QA. Este ejemplo no ejecuta transferencias reales ni acredita conciliación bancaria en producción: para pruebas operativas utiliza datos reales legítimos de tu empresa o un entorno de QA autorizado.

Si has seguido el recorrido de primera factura con Estudio Norte S.L. (F-2026-0001 por 1.815,00 € con IVA al 21 %, 1.590,00 € si aplicaste 15 % de IRPF o 907,50 € en un cobro parcial del 50 %), puedes guardar este bloque como extracto-octubre-2026.csv para comprobar cómo procesa Frihet cuatro situaciones reales en una misma subida:

Fecha,Concepto,Importe,Divisa,Referencia
2026-10-16,"TRANSF ESTUDIO NORTE SL B12345674 FAC F-2026-0001",1815.00,EUR,SEPA-20261016-001
2026-10-16,"TRANSF ESTUDIO NORTE SL B12345674 FAC F-2026-0001",1815.00,EUR,SEPA-20261016-001
2026-10-18,"COMISION MANTENIMIENTO CUENTA OCT",-12.50,EUR,COM-202610-01
2026-10-20,"TRANSF ESTUDIO NORTE SL ENTREGA 50 PCT F-2026-0002",907.50,EUR,SEPA-20261020-004

Qué hace el importador con cada línea:

1. Línea 1 (+1815.00 EUR, F-2026-0001): entra en estado recognized y propone coincidencia con la factura F-2026-0001 de Estudio Norte S.L. (B12345674). (Si tu factura F-2026-0001 se emitió con retención del 15 % de IRPF por 1.590,00 €, sustituye 1815.00 por 1590.00 en la primera línea).
2. Línea 2 (idéntica a la línea 1): el detector de idempotencia la marca como Duplicada en la previsualización para impedir que el cobro se contabilice dos veces.
3. Línea 3 (-12.50 EUR, comisión bancaria): no tiene factura previa; se clasifica mediante una regla bancaria en estado categorized.
4. Línea 4 (+907.50 EUR, pago parcial del 50 %): permite verificar cómo se registra un cobro parcial dejando el 50 % restante pendiente en antigüedad de deuda.

Importación de extractos bancarios

Frihet importa extractos con detección automática del formato y de movimientos duplicados. Puedes arrastrar el fichero o seleccionarlo desde tu equipo.

Formatos soportados

Formato	Extensión	Identificador de duplicados y límites reales del parser
OFX / QFX	.ofx, .qfx	Open Financial Exchange. Usa el identificador único FITID de cada movimiento para evitar duplicados entre solapamientos.
MT940 (SWIFT)	.sta, .mt940	Estándar corporativo europeo de extracto bancario con bloques :60F: / :61: / :86: y referencias SEPA.
CAMT.053	.xml	Estándar XML ISO 20022 de extracto bancario SEPA (BkToCstmrStmt).
CSV	.csv	Exportación de cualquier banco o neobanco, con detección automática de delimitador (, o ;) o plantilla de banco.

El formato Norma 43 (AEB-43) no se puede importar desde la interfaz de Frihet.

Importar un extracto paso a paso

1. Ve a Finanzas → Bancos → Importar extracto
2. Selecciona la cuenta bancaria destino (o crea una cuenta nueva)
3. Arrastra el fichero exportado desde tu banca online (OFX, QFX, MT940, CAMT.053 o CSV)
4. Frihet detecta el formato automáticamente y muestra una previsualización de las transacciones
5. Si es un CSV, deja la plantilla en Detectar automáticamente o elige la de tu banco
6. Haz clic en Importar transacciones

Frihet detecta los movimientos ya importados en ficheros anteriores y los marca como Duplicada para no contabilizarlos dos veces.

Transacciones

Ver transacciones

Ve a Finanzas → Bancos → Transacciones para ver todos los movimientos importados.

Cada línea muestra:

• Fecha de operación y fecha valor
• Descripción original del extracto bancario
• Importe (positivo = entrada / cobro, negativo = salida / pago)
• Estado en el pipeline de 5 fases: raw → recognized → matched → categorized → excluded
• Categoría contable asignada (por regla bancaria, por historial o manualmente)
• Documento vinculado (factura, gasto o depósito)

Filtros disponibles

Filtro	Opciones
Cuenta	Una o varias cuentas bancarias
Rango de fechas	Personalizado o periodos rápidos
Estado	Conciliada / Pendiente / Excluida
Tipo	Entrada / Salida
Categoría	Cualquier categoría de gasto o ingreso

Reconciliación

La reconciliación empareja tus movimientos bancarios con los documentos emitidos o recibidos en Frihet (facturas cobradas, gastos registrados, depósitos).

Reconciliación difusa automática

Al importar el extracto, Frihet propone emparejamientos automáticos cuando:

• El importe coincide con una factura pendiente (incluso con pequeñas diferencias por comisiones descontadas)
• La fecha del movimiento es cercana a la emisión o al vencimiento de la factura
• El concepto o pagador contiene el nombre del cliente, NIF o número de factura

Cuando Frihet detecta una coincidencia, la transacción muestra las Coincidencias sugeridas.

Confirmar una reconciliación sugerida

1. Abre la transacción con sugerencia y pulsa Revisar (Revisión de conciliación)
2. Revisa la factura o gasto propuesto por Frihet
3. Haz clic en Aplicar

La factura pasa a estado Cobrada (paid) y la transacción queda vinculada.

Reconciliación manual y transacciones sin documento

Si una transacción no corresponde a un documento previo, puedes:

• Vincular factura manualmente
• Crear gasto y conciliar directamente desde la transacción
• Excluir si es un traspaso interno entre cuentas propias

Autocategorización y reglas bancarias

Para los movimientos que no corresponden a una factura concreta (comisiones bancarias, suministros, cuotas, SaaS), usa las reglas bancarias: reglas con condiciones por texto o importe, que creas tú mismo en Ajustes → Reglas bancarias (ver el constructor de reglas). Frihet también sugiere reglas a partir de tu propio historial de gastos.

Ejemplos de clasificación con una regla:

Descripción del extracto	Categoría sugerida
AMAZON MKTPLACE AMZN.DE	Material de oficina
NOMINAS EMPLEADOS FEBRERO	Nóminas
REPSOL SERVICIO TENERIFE	Combustible
GOOGLE CLOUD BILLING	Software y SaaS
TGSS COTIZACION AUTONOMOS	Seguridad Social

Bloqueos frecuentes al importar extractos y cómo recuperarlos

Caso o bloqueo durante la importación	Qué ocurre en Frihet	Cómo resolverlo paso a paso
1. Fichero mal formado, codificación dañada o archivo Norma 43 (.n43 / .csb)	La vista previa rechaza las filas sin fecha/importe válidos o informa de que el formato Norma 43 no se importa desde la interfaz.	Exporta el extracto desde tu banco en CAMT.053 (.xml), OFX, MT940 o CSV codificado en UTF-8 con columnas de fecha (YYYY-MM-DD o DD/MM/YYYY), concepto e importe numérico.
2. Subida repetida del mismo extracto o solapamiento de fechas entre dos descargas	Frihet compara el FITID (en OFX/QFX) o la huella fecha + importe + concepto + referencia y marca las filas repetidas como Duplicada.	Mantén marcadas como Duplicada las filas ya importadas para que no se dupliquen en Finanzas → Bancos → Transacciones.
3. Una sola transferencia bancaria liquida varias facturas de Estudio Norte S.L.	El importe del movimiento (p. ej., 3.630,00 €) supera el saldo de una factura individual (1.815,00 €), por lo que no se aplica un cierre 1:1 directo.	Abre el movimiento y reparte el cobro entre las facturas incluidas siguiendo Cobro de varias facturas con una transferencia.
4. Cobro parcial (907,50 € de 1.815,00 €) o diferencia por comisión bancaria/Stripe	El ingreso bancario es inferior al total facturado porque el cliente pagó el 50 % o la pasarela descontó su comisión antes de liquidar.	En un cobro parcial, vincula los 907,50 € a la factura (queda con saldo pendiente de 907,50 €); si la diferencia es una comisión bancaria o de pasarela, registra el gasto de comisión correspondiente.
5. Movimiento o factura en divisa distinta a la de la cuenta (USD vs EUR)	El importe en extracto está en la moneda de liquidación de la cuenta bancaria, o el movimiento pertenece a una cuenta en otra divisa.	Importa cada extracto en la cuenta bancaria cuya Divisa coincida con el fichero y revisa las diferencias de tipo de cambio en Multi-divisa.

API REST /v1/banking y Servidor MCP

Puedes automatizar la carga y conciliación de movimientos desde tus propios scripts o agentes IA:

• API REST (/v1/banking): consulta cuentas, lista transacciones, registra movimientos manualmente, categoriza y vincula movimientos con facturas.
• Servidor MCP (@frihet/mcp-server): herramientas list_bank_accounts, get_bank_account, list_transactions, categorize_transaction, match_transaction_to_invoice, frihet_bank_rules_list y frihet_bank_rule_create.

Seguridad y privacidad

• Cero credenciales bancarias compartidas: Frihet nunca solicita ni almacena el usuario o contraseña de tu banca online.
• Cifrado en transito: los datos viajan por HTTPS.
• Control total sobre tus datos: solo se procesan los extractos y movimientos que decides importar o registrar vía API.

Siguiente acción

• Completar el recorrido de emparejamiento y verificación en Conciliación bancaria.
• Automatizar comisiones y cargos recurrentes sin factura en Reglas bancarias y Conciliación bancaria automática.
• Comprobar el impacto del cobro conciliado en Centro de informes o abrir Soporte y diagnóstico rápido si un extracto no se reconoce.