# Conectar tienda WooCommerce
## ¿Para qué sirve la integración?
Para sincronizar bidireccionalmente tu **tienda online en WooCommerce** con el sistema:
- ✅ Productos: del sistema → WooCommerce (catálogo único)
- ✅ Stock: en tiempo real (vendés en local y se descuenta el online)
- ✅ Precios: cambios sincronizados
- ✅ Pedidos: de WooCommerce → sistema como ventas
- ✅ Categorías y marcas
Resultado: una sola fuente de verdad para stock y precios entre local físico y tienda online.
## Pre-requisitos
1. **Tienda WooCommerce** funcionando (WordPress + plugin WooCommerce)
2. **Acceso admin** a WordPress
3. **HTTPS habilitado** en la tienda (obligatorio para la API)
4. **Plugin REST API** activo en WooCommerce (viene por defecto)
## Paso 1: Generar credenciales API en WooCommerce
En tu WordPress:
1. WooCommerce → **Configuración → Avanzado → REST API**
2. **Agregar clave** (Add key)
3. Descripción: "gestionUltimate"
4. Usuario: el admin
5. Permisos: **Lectura/Escritura**
6. Guardar
7. **Copiar Consumer Key y Consumer Secret** (se muestra solo una vez)
## Paso 2: Configurar conexión en el sistema
Menú lateral → **WooCommerce → Configuración → Conexión**
| Campo | Valor |
|-------|-------|
| **Habilitar WooCommerce** | ✅ |
| **URL de la tienda** | `https://mitienda.com` |
| **Consumer Key** | (del paso anterior) |
| **Consumer Secret** | (del paso anterior) |
Botón **Probar conexión**:
- ✅ Si todo OK, muestra la cantidad de productos, categorías y pedidos detectados
- ❌ Si falla: verificar URL (con https), HTTPS válido, y permisos de la API key
## Paso 3: Configurar opciones de sync
| Opción | Recomendado |
|--------|-------------|
| **Sincronización automática de stock** | ✅ Cada 5-15 min |
| **Sincronización automática de pedidos** | ✅ Cada 5 min |
| **Sincronización de productos** | Manual (cuando agregás nuevos) |
| **Sincronización de precios** | Manual o cuando hay cambio |
| **Sucursal de origen del stock** | Elegí cuál local "alimenta" la tienda online |
## Paso 4: Mapeo inicial
Si tu tienda ya tiene productos cargados, hacé el **matching inicial**:
**WooCommerce → Productos → Mapeo inicial**
El sistema sugiere matches por SKU o nombre. Confirmá cada uno o dejalo que cree productos nuevos en el sistema desde la tienda.
Después del mapeo, la sincronización es bidireccional automática.
## Cron
Para que la sincronización corra cada X minutos sin intervención:
```bash
*/5 * * * * cd /var/www/posultimate && php artisan woocommerce:sync
```
(en cPanel: **Cron Jobs → Agregar cron**)