# PrestaShop

:::tip Disponible
Esta integración está activa y lista para usar en todos los planes Pro.
:::

Conecta tu tienda PrestaShop a Frihet. Importa productos y pedidos directamente desde la API Webservice.

## ¿Para qué sirve?

Con PrestaShop integrado:

- **Importar pedidos** — Los pedidos de tu tienda se convierten en facturas en Frihet
- **Importar productos** — Trae tu catálogo de PrestaShop para unificar la gestión
- **Datos sincronizados** — Precios, cantidades, referencias y estados se importan automáticamente

## Requisitos

- **PrestaShop 1.7 o superior** — Con el Servicio Web habilitado
- **Clave API** — Generada desde el panel de administración
- **HTTPS obligatorio** — Tu tienda debe tener certificado SSL
- **Frihet Pro o superior**

## Configurar la conexión

### Paso 1: Genera una clave API en PrestaShop

1. En tu panel de administración de PrestaShop, ve a **Parámetros Avanzados** → **Servicio Web**
2. Haz clic en **Añadir nueva clave**
3. Activa los permisos de lectura (GET) para:
   - `products` — Para importar productos
   - `orders` — Para importar pedidos
   - `customers` — Para datos de cliente
4. Copia la clave generada

### Paso 2: Conecta en Frihet

1. En Frihet, ve a **Ajustes** → **Integraciones**
2. Busca **PrestaShop** y haz clic
3. Introduce la **URL de tu tienda** (ej: `https://mitienda.com`)
4. Pega la **Clave API**
5. Haz clic en **Probar Conexión** para verificar
6. Si es correcto, haz clic en **Guardar**

## Importar datos

### Importar productos

1. Ve a **Ajustes** → **Integraciones** → **PrestaShop** → pestaña **Datos**
2. Haz clic en **Importar productos**
3. Frihet importa todos los productos activos de tu tienda
4. Los productos duplicados (mismo SKU o nombre) se omiten automáticamente

### Importar pedidos

1. En la misma pestaña **Datos**, haz clic en **Importar pedidos**
2. La primera importación trae los pedidos de los últimos 30 días
3. Las siguientes importaciones traen solo los pedidos nuevos desde la última sincronización
4. Cada pedido genera una factura con el formato `PS-{id}`

## Datos importados

### Productos

| Dato PrestaShop | Dato Frihet |
|-----------------|-------------|
| Nombre | Nombre del producto |
| Referencia | SKU |
| Precio (sin impuestos) | Precio unitario |
| Descripción corta | Descripción |
| Activo (sí/no) | Estado activo/inactivo |

### Pedidos

| Dato PrestaShop | Dato Frihet |
|-----------------|-------------|
| ID del pedido | Número de factura (`PS-{id}`) |
| Fecha del pedido | Fecha de emisión |
| Productos del pedido | Líneas de factura |
| Cantidad | Cantidad |
| Precio unitario (sin IVA) | Precio unitario |
| Referencia del pedido | Notas de la factura |

## Ejemplo real

### Pedido en PrestaShop

```
Pedido #4521 - 18 feb 2026
- 3x Camiseta Básica (ref: CAM-001) @ €15 = €45
- 1x Sudadera Premium (ref: SUD-010) @ €45 = €45
Total: €90 + €18,90 IVA (21%) = €108,90
```

### En Frihet tras importar

```
Factura PS-4521
Fecha: 18 feb 2026
- 3x Camiseta Básica @ €15 = €45
- 1x Sudadera Premium @ €45 = €45
Subtotal: €90,00
IVA (21%): €18,90
Total: €108,90
Estado: Pagada
```

## Diferencias con WooCommerce

| Característica | PrestaShop | WooCommerce |
|---------------|------------|-------------|
| Tipo de conexión | Clave API (Webservice) | Consumer Key + Secret |
| Sync en tiempo real | No (importación manual) | Sí (webhooks) |
| Dirección | PrestaShop → Frihet | WooCommerce → Frihet |
| Formato factura | `PS-{id}` | `WC-{number}` |

## Limitaciones

- **Importación manual** — Los pedidos no se sincronizan en tiempo real. Debes hacer clic en "Importar pedidos" periódicamente
- **Solo lectura** — Frihet importa datos de PrestaShop pero no escribe de vuelta
- **Sin datos de dirección en facturas** — Los datos de envío del pedido no se trasladan al cliente (próximamente)

## Troubleshooting

### "Error de conexión al probar"

- Verifica que la URL es correcta y usa `https://`
- Comprueba que el Servicio Web está habilitado en PrestaShop
- Verifica que la clave API tiene permisos de lectura para `products`, `orders` y `customers`
- Si usas un firewall o `.htaccess`, asegúrate de que no bloquea `/api/`

### "No se importan todos los productos"

- Solo se importan productos **activos** (estado = 1)
- Productos con el mismo SKU o nombre ya existentes se omiten (deduplicación)

### "Los pedidos no aparecen"

- La primera importación trae solo los últimos 30 días
- Verifica que los pedidos tienen estado "procesando" o superior
- Haz clic en "Importar pedidos" de nuevo si han llegado nuevos

### "¿Puedo desconectar sin perder datos?"

Sí. Los productos y facturas ya importados quedan en Frihet. Desconectar solo impide nuevas importaciones.

Para desconectar:

1. Ve a **Ajustes** → **Integraciones** → **PrestaShop** → pestaña **Configuración**
2. Haz clic en **Desconectar**
3. Confirma

## Próximos pasos

- [Conecta WooCommerce si también tienes tienda WordPress](./woocommerce)
- [Importa ventas de Gumroad](./gumroad)
- [Automatiza flujos con n8n](./n8n)