# Lemon Squeezy

:::tip 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](https://www.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](https://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

:::caution 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

| Dato | Dirección | Frecuencia |
|------|-----------|------------|
| Productos | Lemon Squeezy → Frihet | Bajo demanda |
| Pedidos (orders) | Lemon Squeezy → Frihet | Bajo demanda |
| Datos del comprador | Lemon Squeezy → Frihet | Con cada pedido |
| Importe y divisa | Lemon Squeezy → Frihet | Con cada pedido |
| Estado del pedido | Lemon Squeezy → Frihet | Con 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

- [Conecta Gumroad para más ventas digitales](./gumroad)
- [Conecta Stripe para cobros con tarjeta](./stripe)
- [Automatiza importaciones con n8n](./n8n)