Integración con WooCommerce

Conectar WooCommerce

Antes de comenzar

• Su tienda debe servirse por HTTPS.
• Debe iniciar sesión en WordPress como administrador o gestor de la tienda.

Conectar su tienda

1. Vaya a Integraciones y haga clic en WooCommerce
2. Ingrese la dirección de su tienda, por ejemplo sutienda.com. Si WooCommerce está en una carpeta, inclúyala (sutienda.com/tienda)
3. Haga clic en Conectar con WooCommerce. Será redirigido a su panel de WordPress (inicie sesión si se lo pide)
4. WooCommerce le pide autorizar a Shopimize. Haga clic en Aprobar
5. Regresará a Shopimize y la importación comenzará automáticamente

La autorización crea una clave API llamada "Shopimize" que puede revocar en cualquier momento en WooCommerce → Ajustes → Avanzado → API REST. La pantalla de autorización indica acceso de Lectura/Escritura: Shopimize solo lee sus pedidos, reembolsos, productos y ajustes. La escritura se usa para una sola cosa: añadir webhooks llamados "Shopimize" (WooCommerce → Ajustes → Avanzado → Webhooks) para que los pedidos nuevos, reembolsos y cambios de productos lleguen a Shopimize en pocos minutos.

Qué se importa

• Sus pedidos más recientes de inmediato y después todo el historial en segundo plano
• Reembolsos (incluidos los parciales por producto), cancelaciones y cambios de estado
• Productos y variaciones, con sus costes si WooCommerce los tiene: el campo integrado de coste de productos (WooCommerce 10.3+) o el plugin Cost of Goods. Cada pedido usa el coste que WooCommerce registró al realizarse; los costes leídos de WooCommerce llevan una etiqueta WooCommerce en Costes → Costes de productos, donde también puede introducir o corregir costes
• Comisiones de pago registradas por WooPayments, el plugin de Stripe para WooCommerce y PayPal Payments. Si un pago de Stripe no tiene comisión en el pedido y su cuenta de Stripe está conectada a Shopimize, la comisión real se lee de Stripe. Si no, se aplican sus reglas de comisiones o una estimación con la tarifa estándar de su moneda
• La atribución de pedidos (campaña UTM, sitio de referencia, página de entrada) de la atribución integrada de WooCommerce. Los clics de anuncios sin etiquetas UTM se reconocen por su identificador de clic (Google, Microsoft Ads, TikTok, Facebook/Instagram)

Pedidos en otras monedas

Si su tienda vende en varias monedas (multimoneda de WooPayments, Aelia Currency Switcher, FOX/WOOCS u otro plugin), cada pedido se convierte a la moneda de su tienda para que los totales y la rentabilidad cuadren. Shopimize usa el tipo de cambio que el plugin registró en el pedido o, si no lo hay, el tipo de referencia del Banco Central Europeo de la fecha del pedido. La moneda en la que pagó el cliente y el tipo aplicado se guardan con el pedido.

Rapidez de las actualizaciones

Los cambios llegan a Shopimize por los webhooks en pocos minutos. WooCommerce envía los webhooks desde su cola de acciones programadas, que en sitios con poco tráfico solo se ejecuta cuando alguien visita la web, por lo que un envío puede tardar algo más. Shopimize también comprueba los cambios cada hora por seguridad, y cada 15 minutos si no se pudieron añadir los webhooks.

Los pedidos fallidos, pendientes de pago, borradores o enviados a la papelera nunca cuentan como ventas.

Conectar con claves API

Algunos hostings bloquean la petición que WooCommerce envía a Shopimize tras la autorización. En ese caso:

1. En WordPress, vaya a WooCommerce → Ajustes → Avanzado → API REST y haga clic en Añadir clave
2. Descripción: Shopimize — Usuario: un administrador — Permisos: Lectura/Escritura
3. Haga clic en Generar clave API y copie la clave de cliente y el secreto de cliente
4. En Shopimize, abra Integraciones → WooCommerce, haga clic en Conectar con claves API y péguelas

Problemas comunes

"No hemos podido acceder a tu tienda" — compruebe que la dirección carga por HTTPS sin advertencias del navegador.

"Un plugin de seguridad, cortafuegos o caché ha bloqueado nuestra petición" — plugins como Wordfence, iThemes Security o una regla de Cloudflare pueden bloquear la API REST. Permita las peticiones a /wp-json/wc/ y vuelva a intentarlo.

"La clave es válida pero no puede leer pedidos" — la clave debe tener permiso de Lectura o Lectura/Escritura y pertenecer a un administrador o gestor de la tienda.

"WooCommerce no está activo en este sitio" — WooCommerce debe estar activado y su API REST no debe estar desactivada por otro plugin.

Los cambios tardan hasta 15 minutos en aparecer — no se pudieron añadir los webhooks: la clave API solo tiene permiso de Lectura, o un plugin de seguridad bloquea los webhooks. Vuelva a conectar la tienda con acceso de Lectura/Escritura. Si un webhook de Shopimize aparece como Desactivado en WooCommerce → Ajustes → Avanzado → Webhooks, Shopimize lo reactiva en unas horas.

Si ninguna de estas soluciones funciona, contacte el soporte en hello@shopimize.com con la URL de su tienda.