# Shopify

:::tip Disponible en la Shopify App Store
Frihet tiene ficha pública en la Shopify App Store desde el **24 de julio de 2026**: **[apps.shopify.com/frihet-erp](https://apps.shopify.com/frihet-erp)**.
:::

Conecta tu tienda Shopify a Frihet. Los pedidos se importan automáticamente y generan facturas.

## Dos formas de conectar

|                   | Desde la Shopify App Store                              | Desde Frihet                             |
| ----------------- | ------------------------------------------------------- | ---------------------------------------- |
| **Empiezas en**   | La ficha pública de Frihet en Shopify                   | Ajustes → Integraciones dentro de Frihet |
| **Cuenta Frihet** | La creas durante la instalación                         | Ya la tienes                             |
| **Coste**         | Sin coste. La facturación de la app la gestiona Shopify | Incluida en tu plan                      |

Ambas llegan al mismo sitio: tus pedidos de Shopify entrando en Frihet como facturas.

## ¿Para qué sirve?

Con Shopify integrado:

- **Importar pedidos** — Importa pedidos de Shopify como facturas en Frihet (prefijo `SHOP-`)
- **Importar productos** — Trae tu catálogo de Shopify a Frihet
- **Deduplicación automática** — Los pedidos ya importados no se duplican
- **Datos de cliente** — Email, dirección y teléfono se sincronizan automáticamente
- **Pagos automáticos** — Si Shopify procesó el pago, Frihet marca la factura como pagada

## Requisitos

- **Tienda Shopify activa** — Con productos listados
- **Acceso de administrador** — Para autorizar la app

## Instalar desde la Shopify App Store

Si todavía no usas Frihet, este es el camino más corto.

1. Abre la ficha: **[apps.shopify.com/frihet-erp](https://apps.shopify.com/frihet-erp)**
2. Haz clic en **Install**
3. Shopify te muestra los permisos que pide Frihet (todos de **solo lectura**: pedidos, clientes, productos, inventario) y confirmas la instalación
4. Vuelves a Frihet para **iniciar sesión o crear tu cuenta**
5. La tienda queda vinculada a tu espacio de trabajo

:::info Facturación de la app
Si instalas Frihet desde la Shopify App Store, los cargos de la app se gestionan **a través de Shopify**, no desde Frihet. En Ajustes → Plan verás un panel específico para este caso y no se te ofrecerán planes de pago dentro de Frihet.
:::

## Conectar Shopify desde Frihet

Si ya tienes cuenta de Frihet, puedes empezar desde dentro de la aplicación.

### Paso 1: Abre Frihet

1. Ve a **Ajustes** → **Integraciones**
2. Busca **Shopify**
3. Haz clic en **Conectar**

### Paso 2: Autoriza en Shopify

1. Introduce el **nombre de tu tienda** (ej: `mitienda` o `mitienda.myshopify.com`)
2. Haz clic en **Conectar a Shopify**
3. Serás redirigido a la página de autorización de Shopify
4. Inicia sesión con tu cuenta Shopify si no lo has hecho
5. Verás los permisos que necesita Frihet, todos de **solo lectura**:
   - Leer pedidos
   - Leer clientes
   - Leer productos
   - Leer inventario
6. Haz clic en **Instalar app**
7. Volverás automáticamente a Frihet con la conexión activada

### Paso 3: Configura sincronización

En Frihet, después de autorizar:

1. Elige qué sincronizar:
   - ✅ **Pedidos nuevos** — Automático
   - ✅ **Crear facturas automáticas** — Automático
   - ⚪ **Sincronizar clientes** — Opcional
   - ⚪ **Sincronizar productos** — Opcional
   - ⚪ **Actualizar inventario** — Opcional

2. Guarda cambios

## Primera sincronización

La primera vez:

1. Frihet importa tus **últimos 100 pedidos** (los más recientes)
2. Crea clientes (si no existen)
3. Crea facturas para cada pedido
4. **Esto tarda 2-5 minutos** dependiendo de cantidad

Vuelve a **Facturación** → **Facturas** en 5 minutos y verás tus pedidos de Shopify como facturas.

## Cómo funciona el sync

### Nuevo pedido en Shopify

```
1. Cliente compra en tu tienda Shopify
   ↓
2. Shopify procesa el pedido
   ↓
3. Frihet detecta el nuevo pedido (cada 15 minutos)
   ↓
4. Sincroniza a Frihet automáticamente:
   - Cliente (si es nuevo, lo crea)
   - Productos
   - Factura con estado "Pagada" (si pagó en Shopify)
   ↓
5. Aparece en tu listado de Frihet
```

### Datos sincronizados

| Dato           | De Shopify a Frihet               |
| -------------- | --------------------------------- |
| ID pedido      | Número de factura                 |
| Productos      | Líneas de factura                 |
| Precio Shopify | Precio unitario                   |
| Cantidad       | Cantidad                          |
| Cliente        | Nombre, email, dirección de envío |
| Fecha pedido   | Fecha de factura                  |
| Pago           | Método (tarjeta, PayPal, etc.)    |
| Envío          | Se incluye como línea si aplica   |
| Impuestos      | Se calcula según jurisdicción     |

## Estados de pedido

### Shopify → Frihet

| Estado Shopify | Estado Frihet            |
| -------------- | ------------------------ |
| Pendiente      | Pendiente                |
| Confirmado     | Pendiente                |
| Completado     | Pagada ✅                |
| Cancelado      | Cancelada                |
| Devuelto       | Parcialmente reembolsado |

## Ejemplo real

### Cliente compra en tu tienda Shopify

```
Pedido #1009 en Shopify
Cliente: María García
Email: maria@example.com
Dirección: Calle Principal 42, Madrid 28001

Productos:
- 1x Camiseta azul S = €25,00
- 2x Gafas de sol = €40,00 c/u = €80,00

Subtotal: €105,00
Envío: €5,95
Impuestos: €23,19 (21%)
Total pagado: €134,14

Método pago: Tarjeta de crédito
```

### En Frihet automáticamente

```
Factura #1009
Fecha: 10 feb 2025
Cliente: María García

Líneas:
- 1x Camiseta azul S = €25,00
- 2x Gafas de sol = €80,00
- Envío = €5,95

Subtotal: €110,95
IVA (21%): €23,29 (si está configurado en Frihet)
Total: €134,24

Estado: Pagada ✅ (Shopify procesó pago)
```

**Creado automáticamente. Sin hacer nada.**

## Configuraciones avanzadas

### Mapeo de productos

Por defecto, Frihet importa productos como **descripción de línea**. Puedes:

1. Ir a **Ajustes** → **Shopify**
2. Activar **"Sincronizar catálogo de productos"**
3. Frihet crea productos en tu catálogo
4. Futuros pedidos usan esos productos (con actualización de precio)

Útil si quieres reutilizar productos en presupuestos.

### Incluir/excluir órdenes específicas

Puedes decirle a Frihet:

- **"No sincronices pedidos cancelados"** — Excluye automáticamente
- **"Solo sincroniza después del 1 enero"** — Solo pedidos recientes
- **"Excluye cliente específico"** — No crees factura para ese cliente

Configura en **Ajustes** → **Integraciones** → **Shopify** → **Filtros avanzados**

### Impuestos y comisiones

Shopify puede incluir:

- **Taxes (impuestos)** — Se sincronizan como línea separada
- **Tarifas de app** — Puedes excluirlas de la factura
- **Descuentos** — Se restan en línea aparte

En Frihet puedes ajustar qué incluir en la factura final.

## Sincronización de clientes

Si activas **"Sincronizar clientes"**:

- Cada cliente nuevo en Shopify se importa a Frihet
- Email, teléfono, dirección se sincronizan
- Si el cliente ya existe, se actualiza su info

Útil para tener una **vista unificada** de tus clientes.

## Página de productos

Con **"Sincronizar productos"** activo:

1. Frihet importa tu catálogo de Shopify
2. Ves todos los productos con:
   - Nombre
   - Precio
   - SKU
   - Descripción

3. Puedes usarlos en nuevas facturas manuales (no solo pedidos)

Si cambias precio en Shopify, se actualiza automáticamente.

## Prueba la integración

### Test pedido

1. Ve a tu tienda Shopify
2. Haz un pedido de prueba (como cliente)
3. En Frihet, espera **hasta 15 minutos**
4. Ve a **Facturación** → **Facturas**
5. Deberías ver la factura creada

Si no aparece:

- Verifica que Shopify está conectado ✅
- El pedido en Shopify debe tener estado "Completado"
- Recarga Frihet (F5)
- Revisa **Ajustes** → **Integraciones** → **Logs** de Shopify

## Reembolsos y cancelaciones

### Cliente cancela pedido en Shopify

1. Cambias estado a "Cancelado" en Shopify
2. Frihet lo detecta en próxima sincronización
3. La factura se marca como "Cancelada"

### Procesas reembolso en Shopify

Si reembolsas parcialmente:

1. Shopify registra el reembolso
2. Frihet lo detecta
3. Puedes crear **nota de crédito** automáticamente en Frihet
4. O crear manualmente si lo prefieres

## Limitaciones

- **Shopify → Frihet (sincronización en una sola dirección)**
  - Frihet solo pide permisos de **lectura** sobre tu tienda: no puede crear, modificar ni cancelar nada en Shopify
  - Los cambios en Frihet no se sincronizan a Shopify
  - Si editas una factura en Frihet, Shopify no se actualiza
  - Frihet no interviene en el checkout de Shopify

- **No sincroniza borradores de pedido** — Solo pedidos completados

- **Sin acceso a facturas Shopify** — Si Shopify generó factura, Frihet no puede verla

- **Inventario** — Solo lectura, no actualización automática

## Troubleshooting

### "No veo mis pedidos de Shopify"

- Espera hasta 15 minutos para primera sincronización
- Los pedidos deben estar en estado "Completado" o "Procesando"
- Recarga Frihet (F5 o Cmd+Shift+R)
- Verifica que Shopify está conectado en Ajustes

### "Duplicadas facturas"

- Puede pasar si sincronizaste dos veces
- Elimina duplicadas desde **Facturación** (selecciona varias y "Eliminar")
- Luego desconecta y reconecta

### "¿Desconectar borra mis facturas?"

No. Las facturas ya creadas en Frihet quedan. Desconectar solo:

- Detiene nuevas sincronizaciones
- Nuevos pedidos de Shopify no se sincronizan

Para desconectar:

1. **Ajustes** → **Integraciones** → **Shopify**
2. **Desconectar**
3. Confirma

### "¿Puedo conectar múltiples tiendas Shopify?"

Actualmente, Frihet soporta **una tienda Shopify** por cuenta. Si tienes múltiples:

- Opción 1: Crea cuentas Frihet separadas (una por tienda)
- Opción 2: Contacta soporte para consultar opciones avanzadas

## Próximos pasos

- [Instalar Frihet desde la Shopify App Store](https://apps.shopify.com/frihet-erp)
- [Automatiza flujos con n8n](./n8n)
- [Conecta también WooCommerce](./woocommerce)
- [Sincroniza pagos con Stripe](./stripe)
- [Ver todas las integraciones de Frihet](https://www.frihet.io/es/integrations)

---

**Anterior:** [WooCommerce](./woocommerce)