# WooCommerce

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

Conecta tu tienda WooCommerce a Frihet. Los pedidos se sincronizan automáticamente y generan facturas.

## ¿Para qué sirve?

Con WooCommerce integrado:

- **Sync de pedidos** — Nuevos pedidos aparecen en Frihet automáticamente
- **Facturas automáticas** — Se crean sin que hagas nada
- **Datos de cliente** — Nombre, email, dirección del pedido se importan
- **Control de inventario** — Productos sincronizados entre ambas plataformas (opcional)

## Requisitos

- **WordPress con WooCommerce instalado** — Tu tienda online
- **Acceso a WordPress** — Usuario admin o con permisos de plugins
- **Frihet Pro o superior**

## Instalar plugin de conexión

### Paso 1: Descarga el plugin

1. En WordPress, ve a **Plugins** → **Añadir nuevo**
2. Busca **"Frihet WooCommerce"**
3. Haz clic en **Instalar**
4. Luego **Activar**

O descárgalo manualmente desde: `frihet.io/plugins/woocommerce`

### Paso 2: Autoriza la conexión

1. En WordPress, ve a **Ajustes** → **Frihet WooCommerce**
2. Haz clic en **"Conectar con Frihet"**
3. Serás redirigido a Frihet
4. Autoriza el acceso
5. Redirige automáticamente a WordPress

### Paso 3: Configura qué sincronizar

En **Ajustes** → **Frihet WooCommerce**, elige:

- ✅ **Sincronizar pedidos** — Recomendado
- ✅ **Crear facturas automáticas** — Recomendado
- ⚪ **Sincronizar clientes** — Opcional
- ⚪ **Sincronizar inventario** — Solo si lo necesitas

Guarda cambios.

## Cómo funciona el sync

### Nuevo pedido en WooCommerce

```
1. Cliente compra en tu tienda
   ↓
2. WooCommerce recibe el pedido
   ↓
3. Plugin detecta cambio
   ↓
4. Envía datos a Frihet (en tiempo real)
   ↓
5. Frihet crea automáticamente:
   - Cliente (si es nuevo)
   - Factura con los productos del pedido
   ↓
6. La factura aparece en tu listado de Frihet
```

### Datos sincronizados

| Dato | De WooCommerce a Frihet |
|------|-------------------------|
| Número de pedido | Número de factura |
| Productos | Líneas de factura |
| Cantidad | Cantidad |
| Precio | Precio unitario |
| Cliente | Nombre, email, dirección |
| Fecha pedido | Fecha de factura |
| Estado del pedido | Estado de pago |
| IVA (si está configurado) | IVA desglosado |

## Estados de pedido y factura

### WooCommerce → Frihet

| Estado WooCommerce | Estado Frihet |
|-------------------|---------------|
| Pendiente de pago | Pendiente |
| Procesando | Pendiente |
| Completado | Pagada ✅ |
| Cancelado | Cancelada |
| Reembolso | Reembolso parcial |

Si el cliente marca el pedido como "Completado", la factura se marca como pagada automáticamente.

## Ejemplo real

### Cliente compra en tu tienda

Pedido en WooCommerce:
```
Pedido #1234 - 10 feb 2025
- 2x Producto A @ €50 = €100
- 1x Producto B @ €30 = €30
Total: €130 + €27,30 IVA (21%) = €157,30

Cliente: Juan García
Email: juan@example.com
```

### En Frihet automáticamente

Factura creada:
```
Factura #1234
Fecha: 10 feb 2025
Cliente: Juan García
- 2x Producto A @ €50 = €100
- 1x Producto B @ €30 = €30
Subtotal: €130,00
IVA (21%): €27,30
Total: €157,30
Estado: Pagada ✅
```

La factura aparece en tu listado. **Sin hacer nada.**

## Configuraciones avanzadas

### Mapeo de categorías de producto

Si quieres que los productos de WooCommerce se creen como productos en Frihet:

1. Ve a **Ajustes** → **Frihet WooCommerce**
2. Activa **"Sincronizar productos"**
3. Elige si sincronizar inventario (stock)

Esto es útil si quieres reutilizar esos productos en presupuestos futuros.

### Formato de factura personalizado

Por defecto, Frihet usa su formato. Puedes personalizar:

1. En **Frihet**, ve a **Ajustes** → **Facturación**
2. Modifica el template de factura
3. Los nuevos pedidos de WooCommerce usan ese template

### Correo al cliente

Cuando se crea una factura desde WooCommerce:

- ✅ WooCommerce envía email de confirmación del pedido
- ✅ Frihet puede enviar email de factura (si lo activas)

Ambos emails irán al cliente. Puedes desactivar uno en Ajustes para evitar duplicados.

## Prueba la integración

### Test pedido

1. Ve a tu tienda WooCommerce
2. Haz un pedido de prueba (como cliente)
3. En Frihet, ve a **Facturación** → **Facturas**
4. Deberías ver la factura creada automáticamente en los últimos 30 segundos

Si no aparece:

- Espera 1 minuto (a veces tarda)
- Verifica que WooCommerce → Frihet muestra "Conectado"
- Revisa logs de error en **Ajustes** → **Integraciones** → **Logs**

## Reembolsos y cancelaciones

### Cliente cancela pedido en WooCommerce

1. El estado cambia a "Cancelado"
2. Frihet detecta el cambio
3. La factura se marca como "Cancelada"

### Cliente solicita reembolso

Si procesas un reembolso en WooCommerce:

1. Se registra en el pedido
2. Frihet crea automáticamente una **nota de crédito** (si lo activas en Ajustes)
3. O puedes crear manualmente la nota de crédito en Frihet

## Limitaciones

Frihet → WooCommerce:

- **No sincroniza facturas de Frihet a WooCommerce** — Solo WooCommerce → Frihet
- **Ediciones en Frihet no afectan WooCommerce** — Si cambias el precio de una factura en Frihet, WooCommerce no se actualiza
- **Productos nuevos en Frihet no van a WooCommerce** — Solo se sincronizan existentes

## Troubleshooting

### "No veo las facturas de WooCommerce en Frihet"

- Verifica que la integración está conectada ✅
- El pedido debe estar en estado "Procesando" o superior
- Espera 1-2 minutos después de crear el pedido
- Recarga Frihet (F5)

### "¿Por qué se duplican emails?"

- WooCommerce envía email de pedido
- Frihet también puede enviar email de factura
- Solución: Desactiva emails de Frihet para pedidos de WooCommerce en **Ajustes** → **Email**

### "El cliente no coincide entre WooCommerce y Frihet"

- WooCommerce creó un cliente nuevo en Frihet
- Si el cliente ya existía, podrían haber quedado duplicados
- Solución: Fusiona clientes manualmente en Frihet

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

Sí. Las facturas ya creadas quedan en Frihet. La desconexión solo:

- Detiene nuevos syncs
- Los pedidos nuevos en WooCommerce no se sincronizan más

Para desconectar:

1. Ve a **Ajustes** → **Integraciones**
2. Busca **WooCommerce**
3. Haz clic en **Desconectar**
4. Confirma

:::tip Webhooks para e-commerce
Frihet emite [webhooks](/desarrolladores/webhooks) en eventos como `invoice.created` y `invoice.paid`. Usalo para sincronizar tu tienda WooCommerce con sistemas externos o disparar automatizaciones cuando se generan facturas desde pedidos.
:::

## Proximos pasos

- [Conecta Shopify si tienes tienda alli tambien](./shopify)
- [Automatiza flujos con n8n](./n8n)

---

**Anterior:** [Stripe Connect](./stripe-connect)