Saltar al contenido principal

Lemon Squeezy

Disponible

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

Conecta tu tienda de Lemon Squeezy a Frihet. Importa productos y pedidos de software digital, registra ingresos automáticamente y mantén toda tu facturación centralizada. Lemon Squeezy actúa como Merchant of Record (gestiona impuestos por ti) y Frihet registra las transacciones para tu contabilidad.

¿Para qué sirve?​

Con Lemon Squeezy integrado:

  • Importar productos — Trae tu catálogo de software y productos digitales a Frihet
  • Importar pedidos — Cada venta se registra como ingreso en tu ERP
  • Deduplicación automática — Los pedidos ya importados no se duplican (prefijo LS-)
  • Multi-tienda — Si tienes varias tiendas, selecciona cuál importar o importa de todas
  • Gestión de impuestos simplificada — Lemon Squeezy maneja los impuestos como MoR; Frihet registra los importes netos
  • Suscripciones — Seguimiento de pagos recurrentes de SaaS

Requisitos​

  • Cuenta Lemon Squeezy activa — lemonsqueezy.com
  • API Key — Se genera desde el dashboard
  • Frihet Pro o superior

Conectar Lemon Squeezy con Frihet​

Paso 1: Obtener tu API Key​

  1. Ve a app.lemonsqueezy.com/settings/api
  2. Inicia sesión en tu cuenta
  3. Haz clic en Create API key (o el botón "+")
  4. Ponle un nombre (ej: "Frihet ERP")
  5. Copia la API Key generada
Guarda la clave

La API Key solo se muestra una vez al crearla. Cópiala antes de cerrar la ventana.

Paso 2: Configurar en Frihet​

  1. Ve a Ajustes → Integraciones
  2. Busca Lemon Squeezy
  3. Haz clic en Conectar
  4. Pega tu API Key
  5. Haz clic en Verificar conexión
  6. Si es correcto, Frihet cargará tus tiendas disponibles
  7. (Opcional) Selecciona una tienda específica del desplegable — si no seleccionas ninguna, se importarán productos y pedidos de todas tus tiendas
  8. Haz clic en Guardar conexión

Paso 3: Verificar conexión​

  1. Frihet mostrará un resumen de tu tienda:
    • Nombre de la tienda
    • Número de productos
    • Pedidos recientes
  2. Realiza una importación de prueba

Cómo funciona​

Frihet usa la API de Lemon Squeezy con formato JSON:API:

  1. Proporcionas tu API Key
  2. Frihet envía la clave en la cabecera Authorization: Bearer <api-key>
  3. Las respuestas siguen el formato JSON:API (con data, attributes, relationships)
  4. Los productos y pedidos se importan bajo demanda
  5. La deduplicación se basa en el ID de pedido de Lemon Squeezy (prefijo LS-{id})
  6. La API Key se almacena cifrada (AES-256-GCM) en Frihet

Datos sincronizados​

DatoDirecciónFrecuencia
ProductosLemon Squeezy → FrihetBajo demanda
Pedidos (orders)Lemon Squeezy → FrihetBajo demanda
Datos del compradorLemon Squeezy → FrihetCon cada pedido
Importe y divisaLemon Squeezy → FrihetCon cada pedido
Estado del pedidoLemon Squeezy → FrihetCon cada importación

Merchant of Record​

Lemon Squeezy actúa como Merchant of Record, lo que significa que:

  • Lemon Squeezy cobra al cliente, gestiona IVA/Sales Tax y emite la factura al comprador
  • Tú recibes el importe neto (después de impuestos y comisiones)
  • Frihet registra el ingreso neto que recibes para tu contabilidad interna

Esto simplifica tu contabilidad: no necesitas calcular impuestos internacionales por cada venta digital.

Casos de uso​

Desarrollador indie con SaaS​

Vendes licencias de tu software a través de Lemon Squeezy. Cada pago se importa a Frihet como ingreso, tanto los pagos únicos como las renovaciones de suscripción.

Creador de plugins o themes​

Vendes plugins de WordPress, themes de Shopify o extensiones. Frihet consolida estos ingresos con el resto de tu facturación (servicios de consultoría, otros clientes).

Seguimiento de suscripciones​

Tienes un producto SaaS con plan mensual y anual. Desde Frihet puedes ver el desglose de ingresos recurrentes importados de Lemon Squeezy junto con el resto de tu negocio.

Importar productos​

  1. Ve a Ajustes → Integraciones → Lemon Squeezy
  2. Haz clic en Importar productos
  3. Frihet traerá los productos de tu tienda

Datos importados por producto:

  • Nombre
  • Precio
  • Tipo (pago único, suscripción)
  • Estado (publicado, borrador)

Importar pedidos​

  1. Ve a Ajustes → Integraciones → Lemon Squeezy
  2. Haz clic en Importar pedidos
  3. Selecciona el rango de fechas
  4. Frihet creará registros de ingreso por cada pedido

Cada pedido importado incluye:

  • ID del pedido
  • Nombre y email del comprador
  • Producto adquirido
  • Importe total y neto
  • Divisa
  • Fecha del pedido
  • Estado (completado, reembolsado, pendiente)

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 la API Key es correcta y no ha sido revocada
  • Comprueba que tu cuenta de Lemon Squeezy está activa
  • Si creaste una nueva API Key, actualízala en Frihet

"No se importan pedidos"​

  • Comprueba que tienes pedidos en el rango de fechas seleccionado
  • Verifica que la API Key no está restringida a ciertos scopes
  • Si tu tienda es nueva, asegúrate de que hay al menos un pedido completado

"Los importes no coinciden con lo que veo en Lemon Squeezy"​

  • Frihet importa el importe que tú recibes (neto de impuestos y comisiones de Lemon Squeezy)
  • El importe bruto que ve el comprador incluye impuestos gestionados por el MoR
  • Consulta el desglose en tu dashboard de Lemon Squeezy para confirmar

"Quiero desconectar"​

  1. Ve a Ajustes → Integraciones → Lemon Squeezy
  2. Haz clic en Desconectar
  3. Opcionalmente, revoca la API Key desde tu dashboard de Lemon Squeezy

Próximos pasos​