# Qonto

:::tip Disponible
Esta integración está disponible en Frihet. Configúrala en **Settings → Integraciones → Qonto**.
:::

Conecta tu cuenta de Qonto a Frihet para importar automáticamente las transacciones de tu banca empresarial como gastos. Si usas Qonto como tu banco principal, esta integración elimina la necesidad de registrar manualmente cada pago y te da visibilidad completa de tus gastos operativos dentro de Frihet.

## ¿Para qué sirve?

- **Importar transacciones como gastos** — Los pagos y cargos completados en Qonto se importan como gastos en Frihet con todos los detalles
- **Solo débitos** — Se importan únicamente las transacciones de débito (pagos realizados), no los ingresos, para evitar mezclar flujos
- **Deduplicación automática** — Las transacciones ya importadas no se duplican en importaciones posteriores
- **Consolidación de gastos** — Unifica tus gastos de Qonto con el resto de gastos registrados en Frihet para tener una visión financiera completa

## Requisitos

- Cuenta activa en [Qonto](https://qonto.com)
- Plan Frihet Pro o Premium
- Organization slug y Secret key de la API de Qonto

## Cómo conectar

### Paso 1: Obtener tus credenciales de API en Qonto

1. Inicia sesión en [app.qonto.com](https://app.qonto.com)
2. Ve a **Settings** (Configuración) en el menú lateral
3. Selecciona la sección **API** o **Integraciones > API**
4. Aquí encontrarás dos datos que necesitas:
   - **Organization slug** — El identificador único de tu organización (algo como `mi-empresa-abc123`)
   - **Secret key** — La clave secreta de la API
5. Copia ambos valores

### Paso 2: Configurar en Frihet

1. En Frihet, ve a **Settings → Integraciones**
2. Busca **Qonto** y haz clic en el card
3. Introduce tu **Organization slug** en el primer campo
4. Introduce tu **Secret key** en el segundo campo
5. Haz clic en **Probar conexión** para verificar
6. Si la conexión es exitosa, haz clic en **Guardar**

## Cómo funciona

Frihet se conecta a la API de Qonto utilizando tu Organization slug y Secret key para autenticarse. Cuando lanzas una importación, Frihet consulta las transacciones completadas de tipo débito en tu cuenta Qonto y las registra como gastos.

La importación es bajo demanda. Solo se importan transacciones de débito completadas (pagos a proveedores, suscripciones, compras con tarjeta, etc.). Los ingresos y transferencias entrantes no se importan.

### Mapeo de datos

| Dato en Qonto           | Campo en Frihet       |
| ----------------------- | --------------------- |
| Etiqueta / concepto     | Descripción del gasto |
| Importe (débito)        | Importe del gasto     |
| Fecha de la operación   | Fecha del gasto       |
| Divisa                  | Divisa del gasto      |
| Nombre del beneficiario | Notas del gasto       |
| Categoría Qonto         | Categoría sugerida    |

## Casos de uso

### Pyme europea con cuenta Qonto

Usas Qonto como tu banco principal. Cada mes importas todas las transacciones a Frihet para tener un registro completo de gastos sin teclear nada. Combinas estos gastos importados con las facturas emitidas en Frihet para tener una visión completa de tu rentabilidad.

### Equipo con tarjetas corporativas Qonto

Tu equipo tiene tarjetas Qonto para gastos del día a día. En lugar de perseguir a cada persona para que registre sus gastos, importas todas las transacciones de tarjeta a Frihet y las categorizas de una vez.

## Solución de problemas

### Error de conexión

- Verifica que el Organization slug y la Secret key son correctos
- Comprueba que has copiado los valores completos, sin espacios extra
- Si Qonto regeneró tu Secret key, actualízala en Frihet

### No se importan transacciones

- Solo se importan transacciones de tipo débito y en estado completado
- Confirma que tienes transacciones en el período seleccionado
- Las transacciones pendientes o en proceso no aparecen hasta que se completan

### Faltan algunas transacciones

- Verifica el rango de fechas de la importación
- Las transferencias internas entre cuentas Qonto pueden no importarse según la configuración

## Siguientes pasos

- [Conecta Wise para transferencias internacionales](./wise)
- [Conecta Pleo si usas tarjetas corporativas adicionales](./pleo)
- [Aprende a categorizar gastos importados](../gastos/categorias)