GoCardless
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
- Access Token de la API — Se genera desde el dashboard
- Frihet Pro o superior
Conectar GoCardless con Frihet
Paso 1: Obtener tu Access Token
- Ve a manage.gocardless.com (o manage-sandbox.gocardless.com para pruebas)
- Inicia sesión en tu cuenta
- Ve a Developers en el menú lateral
- Haz clic en Create → Access Token
- Selecciona el scope Read-only (suficiente para consultar datos) o Read-write si necesitas gestionar cobros
- Ponle un nombre (ej: "Frihet ERP")
- Copia el token generado
El Access Token solo se muestra una vez al crearlo. Cópialo antes de cerrar la ventana.
Paso 2: Configurar en Frihet
- Ve a Ajustes → Integraciones
- Busca GoCardless
- Haz clic en Conectar
- Pega tu Access Token
- Selecciona el entorno:
- Live — Para datos reales
- Sandbox — Para pruebas
- 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:
- Proporcionas tu Access Token
- Frihet envía el token en la cabecera
Authorization: Bearer <token>de cada petición - Los datos de pagos, clientes y mandatos se consultan bajo demanda
- El token se almacena cifrado (AES-256-GCM) en Frihet
- 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:
- Ve a Ajustes → Integraciones → GoCardless
- En la pestaña Datos, haz clic en Importar pagos
- Frihet descargará todos los pagos y creará facturas por cada uno
- Los pagos ya importados previamente se saltan automáticamente (deduplicación por
GC-{id}) - 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:
- Regístrate en manage-sandbox.gocardless.com
- Crea un Access Token en el entorno sandbox
- Configura Frihet en modo "Sandbox"
- Crea mandatos y pagos de prueba desde el dashboard sandbox
- 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"
- Ve a Ajustes → Integraciones → GoCardless
- Haz clic en Desconectar
- Opcionalmente, revoca el Access Token desde el dashboard de GoCardless