Gumroad
Esta integración está activa y lista para usar en Frihet.
Conecta tu cuenta de Gumroad a Frihet. Importa productos y ventas de tu tienda digital, genera facturas automáticas y consolida tus ingresos de creador con el resto de tu facturación.
¿Para qué sirve?
Con Gumroad integrado:
- Importar productos — Trae tu catálogo de Gumroad a Frihet
- Importar ventas — Cada venta se convierte en un registro de ingreso
- Facturas automáticas — Genera facturas por cada venta con datos del comprador
- Deduplicación — Las ventas ya importadas no se duplican
- Prefijo GR- — Las ventas importadas se identifican con el prefijo GR- para fácil rastreo
- Estado de reembolsos — Los reembolsos en Gumroad se reflejan automáticamente
Requisitos
- Cuenta Gumroad activa — gumroad.com
- Access Token de la API — Se genera desde la configuración de Gumroad
- Frihet Pro o superior
Conectar Gumroad con Frihet
Paso 1: Obtener tu Access Token
- Ve a app.gumroad.com/settings/advanced
- Inicia sesión en tu cuenta de Gumroad
- En la sección Applications, busca Access Token
- Si no tienes uno, haz clic en Create application:
- Nombre: "Frihet ERP"
- Redirect URI:
https://app.frihet.io(no se usa, pero es obligatorio)
- Copia el Access Token generado
Paso 2: Configurar en Frihet
- Ve a Ajustes → Integraciones
- Busca Gumroad
- Haz clic en Conectar
- Pega tu Access Token
- Haz clic en Verificar conexión
- Si es correcto, verás el nombre de tu perfil de Gumroad
Paso 3: Verificar conexión
- Frihet mostrará un resumen de tu cuenta:
- Número de productos activos
- Ventas recientes
- Haz una importación de prueba para verificar que todo funciona
Cómo funciona
Frihet usa la API de Gumroad con autenticación Bearer:
- Proporcionas tu Access Token
- Frihet envía el token en la cabecera
Authorization: Bearer <token> - Los productos y ventas se importan bajo demanda
- Cada venta importada recibe un identificador con prefijo GR- (ej:
GR-abc123) - La deduplicación se basa en el ID de venta de Gumroad: si una venta ya fue importada, no se duplica
- El token se almacena cifrado (AES-256-GCM) en Frihet
Datos sincronizados
| Dato | Dirección | Frecuencia |
|---|---|---|
| Productos | Gumroad → Frihet | Bajo demanda |
| Ventas | Gumroad → Frihet | Bajo demanda |
| Datos del comprador | Gumroad → Frihet | Con cada venta |
| Estado de reembolso | Gumroad → Frihet | Con cada importación |
| Precio y divisa | Gumroad → Frihet | Con cada venta |
Mapeo de estados
| Estado Gumroad | Estado Frihet |
|---|---|
| Venta completada | Ingreso registrado |
| Reembolso parcial | Ingreso ajustado |
| Reembolso completo | Ingreso anulado / nota de crédito |
Casos de uso
Creador digital con ebooks y cursos
Vendes ebooks, plantillas y cursos en Gumroad. Cada venta se importa a Frihet automáticamente con los datos del comprador, generando un registro de ingreso que puedes facturar y declarar.
Freelancer que vende templates
Además de tus servicios de consultoría, vendes plantillas en Gumroad. Frihet consolida tus ingresos de servicios (facturas manuales) con los de productos digitales (importados de Gumroad) en un solo panel.
Control de reembolsos
Un comprador solicita un reembolso en Gumroad. Al importar de nuevo las ventas, Frihet detecta el cambio de estado y ajusta el registro de ingreso para reflejar el reembolso.
Importar productos
- Ve a Ajustes → Integraciones → Gumroad
- Haz clic en Importar productos
- Frihet traerá todos tus productos activos de Gumroad
- Los productos aparecerán en tu catálogo de Frihet
Datos importados por producto:
- Nombre del producto
- Precio
- Descripción
- Estado (activo/inactivo)
Importar ventas
- Ve a Ajustes → Integraciones → Gumroad
- Haz clic en Importar ventas
- Selecciona el rango de fechas
- Frihet importará las ventas y creará registros de ingreso
Cada venta importada incluye:
- ID de venta con prefijo GR- (ej:
GR-xYz123) - Nombre y email del comprador
- Producto vendido
- Importe y divisa
- Fecha de la venta
- Estado (completada / reembolsada)
Reintentos automaticos
Si una importacion falla por un error temporal (timeout, error del servidor), Frihet reintenta automaticamente hasta 3 veces con esperas exponenciales (1s, 2s, 4s). No necesitas hacer nada — los reintentos son transparentes.
Solución de problemas
"Error de autenticación"
- Verifica que el Access Token es correcto
- Comprueba que tu cuenta de Gumroad está activa
- Si regeneraste el token, actualízalo en Frihet
"No se importan mis ventas"
- Comprueba que tienes ventas en el rango de fechas seleccionado
- Las ventas muy antiguas pueden tardar más en importarse
- Verifica que el Access Token tiene permisos de lectura
"Veo ventas duplicadas"
- No debería ocurrir: Frihet deduplica por ID de venta de Gumroad
- Si ocurre, desconecta y reconecta la integración
- Las ventas ya registradas en Frihet no se verán afectadas
"Un reembolso no se refleja"
- Importa las ventas de nuevo para que Frihet detecte el cambio de estado
- El reembolso debe estar procesado en Gumroad (no solo solicitado)