WooCommerce Sync

Conecta tu tienda WooCommerce con SimplifyCRM. Sincroniza órdenes, productos y clientes en tiempo real vía webhooks, y al instalar importa automáticamente el año en curso (YTD).

Cómo usarlo

1. En la pestaña WooCommerce, agrega la URL de tu tienda y tus credenciales de API (Consumer Key/Secret).
2. Prueba la conexión. Si es válida, se habilita el asistente de import inicial.
3. En Import, selecciona el rango (por defecto desde el 1 de enero hasta hoy) y qué importar (productos, contactos, órdenes).
4. El import corre en segundo plano. Puedes cerrar la pantalla; recibirás notificación al terminar.
5. Al completarse, los webhooks se registran automáticamente en Woo y la sincronización continua comienza.

Campos importantes

• Store URL — la URL base de tu tienda Woo (ej. https://mitienda.do). Sin /wp-json al final.
• Consumer Key / Secret — se generan en Woo: WooCommerce → Configuración → Avanzado → REST API. Permisos: Lectura/Escritura.
• Rango del import — por defecto YTD. Máximo 12 meses. Para históricos mayores, usa Import CSV en Commerce.
• Crear asientos contables — apagado por defecto al importar histórico (evita ensuciar el Mayor). Enciéndelo solo si quieres que cada orden histórica genere asiento.

Qué reutiliza del CRM

• Órdenes → Commerce → Orders (marcadas con source = woocommerce).
• Productos → Commerce → Products. Si una orden Woo trae un producto sin SKU, se genera uno sintético (woo-{id}).
• Contactos → tus Contactos (rol customer). Dedupe por email.

No se duplican entidades: el addon es puente, no copia paralela.

Permisos

• Ver: commerce:view, contacts:view.
• Conectar tienda / correr import: commerce:edit.
• Recibir webhooks (Edge Function): no requiere sesión; se valida por HMAC.

Preguntas frecuentes

¿Puedo re-correr el import?

Sí. Es idempotente (no duplica). Puedes ampliar el rango hasta 12 meses sin problemas.

¿Qué pasa si el producto en Woo no tiene SKU?

Se crea con SKU sintético woo-{product_id}. Puedes renombrarlo en CRM después; el mapping se mantiene.

¿Qué estados de orden se importan?

Todos: completed, processing, on-hold, pending, cancelled, refunded, failed. Los reportes deben filtrar por status.

¿Soporta múltiples tiendas Woo?

Sí. Cada tienda es una conexión separada con su propio mapping de IDs.