# GoCardless

:::tip Disponible
Esta integración está activa y lista para usar en Frihet.
:::

Conecta GoCardless a Frihet para gestionar cobros por domiciliación bancaria SEPA. Consulta mandatos, pagos y clientes directamente desde tu ERP. Ideal para suscripciones y cobros recurrentes con comisiones bajas.

## ¿Para qué sirve?

Con GoCardless integrado:

- **Importar pagos** — Importa cobros de GoCardless como facturas en Frihet con un clic
- **Deduplicación automática** — Los pagos ya importados no se duplican (prefijo `GC-`)
- **Ver pagos** — Consulta todos tus cobros por domiciliación desde Frihet
- **Gestionar clientes** — Accede a la información de clientes con mandatos activos
- **Consultar mandatos** — Ve el estado de cada mandato SEPA (activo, pendiente, cancelado)
- **Reconciliar cobros** — Asocia pagos de GoCardless con facturas en Frihet
- **Modo sandbox** — Prueba la integración con datos ficticios

## Requisitos

- **Cuenta GoCardless activa** — [gocardless.com](https://gocardless.com)
- **Access Token de la API** — Se genera desde el dashboard
- **Frihet Pro o superior**

## Conectar GoCardless con Frihet

### Paso 1: Obtener tu Access Token

1. Ve a [manage.gocardless.com](https://manage.gocardless.com) (o [manage-sandbox.gocardless.com](https://manage-sandbox.gocardless.com) para pruebas)
2. Inicia sesión en tu cuenta
3. Ve a **Developers** en el menú lateral
4. Haz clic en **Create** → **Access Token**
5. Selecciona el scope **Read-only** (suficiente para consultar datos) o **Read-write** si necesitas gestionar cobros
6. Ponle un nombre (ej: "Frihet ERP")
7. Copia el token generado

:::caution Guarda el token
El Access Token solo se muestra una vez al crearlo. Cópialo antes de cerrar la ventana.
:::

### Paso 2: Configurar en Frihet

1. Ve a **Ajustes** → **Integraciones**
2. Busca **GoCardless**
3. Haz clic en **Conectar**
4. Pega tu **Access Token**
5. Selecciona el entorno:
   - **Live** — Para datos reales
   - **Sandbox** — Para pruebas
6. Haz clic en **Verificar conexión**

### Paso 3: Verificar conexión

Si la conexión es correcta, Frihet mostrará:

- Nombre de tu organización en GoCardless
- Número de mandatos activos
- Número de clientes registrados

## Cómo funciona

Frihet se conecta a la **API v2 de GoCardless** (versión 2015-07-06) usando Bearer authentication:

1. Proporcionas tu Access Token
2. Frihet envía el token en la cabecera `Authorization: Bearer <token>` de cada petición
3. Los datos de pagos, clientes y mandatos se consultan bajo demanda
4. El token se almacena cifrado (AES-256-GCM) en Frihet
5. Toda la comunicación se realiza sobre HTTPS

## Datos sincronizados

| Dato | Dirección | Frecuencia |
|------|-----------|------------|
| Pagos (cobros) | GoCardless → Frihet | Bajo demanda |
| Clientes | GoCardless → Frihet | Bajo demanda |
| Mandatos SEPA | GoCardless → Frihet | Bajo demanda |
| Estado de pagos | GoCardless → Frihet | Bajo demanda |

## Casos de uso

### Asesoría con cuotas mensuales

Cobras una cuota mensual a tus clientes por domiciliación bancaria. Desde Frihet puedes ver qué pagos se han cobrado correctamente, cuáles están pendientes y cuáles han fallado, sin salir de tu ERP.

### SaaS con suscripciones SEPA

Tus clientes europeos prefieren pagar por domiciliación en lugar de tarjeta. GoCardless gestiona los cobros recurrentes y Frihet te muestra el estado de cada pago junto a las facturas emitidas.

### Verificar mandatos antes de facturar

Antes de emitir una factura recurrente, consulta desde Frihet si el mandato del cliente sigue activo. Evita facturar a clientes cuyo mandato haya expirado o sido cancelado.

## Importar pagos a Frihet

Puedes importar los pagos de GoCardless como facturas en Frihet:

1. Ve a **Ajustes** → **Integraciones** → **GoCardless**
2. En la pestaña **Datos**, haz clic en **Importar pagos**
3. Frihet descargará todos los pagos y creará facturas por cada uno
4. Los pagos ya importados previamente se saltan automáticamente (deduplicación por `GC-{id}`)
5. Al terminar, verás el número exacto de pagos importados

Los pagos importados incluyen: importe, divisa, fecha, referencia y estado.

## Modo Sandbox

GoCardless ofrece un entorno sandbox completamente separado:

1. Regístrate en [manage-sandbox.gocardless.com](https://manage-sandbox.gocardless.com)
2. Crea un Access Token en el entorno sandbox
3. Configura Frihet en modo "Sandbox"
4. Crea mandatos y pagos de prueba desde el dashboard sandbox
5. Verifica que los datos aparecen correctamente en Frihet

## Estados de pago en GoCardless

| Estado GoCardless | Significado |
|-------------------|-------------|
| `pending_submission` | Pago creado, pendiente de enviar al banco |
| `submitted` | Enviado al banco, en proceso |
| `confirmed` | Cobro realizado con éxito |
| `paid_out` | Fondos transferidos a tu cuenta |
| `failed` | El cobro falló (fondos insuficientes, mandato cancelado, etc.) |
| `cancelled` | Cancelado antes de procesarse |

## Solución de problemas

### "Error de autenticación"

- Verifica que el Access Token es correcto y no ha expirado
- Asegúrate de usar un token **Live** en modo Live y **Sandbox** en modo Sandbox
- Si regeneraste el token en GoCardless, actualízalo en Frihet

### "No veo mis pagos"

- Comprueba que tienes pagos registrados en tu cuenta GoCardless
- Verifica que el token tiene permisos de lectura
- En sandbox, crea pagos de prueba primero

### "Error de versión de API"

- Frihet usa la versión de API 2015-07-06 de GoCardless, que es estable y compatible
- Si GoCardless notifica cambios de API, actualizaremos la integración

### "Quiero desconectar"

1. Ve a **Ajustes** → **Integraciones** → **GoCardless**
2. Haz clic en **Desconectar**
3. Opcionalmente, revoca el Access Token desde el dashboard de GoCardless

## Próximos pasos

- [Conecta Stripe para cobros con tarjeta](./stripe)
- [Conecta PayPal para cobros internacionales](./paypal)
- [Configura Plaid para conexión bancaria directa](./plaid)