Integración WooCommerce

La integración WooCommerce le permite conectar su tienda en línea WooCommerce a Gem Logic. Una vez conectada, puede enviar productos desde Gem Logic a su tienda WooCommerce y extraer pedidos desde WooCommerce a Gem Logic. Esto mantiene su catálogo de productos y gestión de pedidos sincronizados entre ambas plataformas.

Configuración

Generar claves API en WooCommerce

Antes de conectar WooCommerce a Gem Logic, debe generar claves API en su tienda WooCommerce.

  1. Inicie sesión en su panel de administración de WordPress.

  2. Navegue a WooCommerce ‣ Ajustes ‣ Avanzado ‣ API REST.

  3. Haga clic en Añadir clave.

  4. Complete los detalles:

    • Description: introduzca un nombre para identificar esta clave (por ejemplo Integración Gem Logic).

    • Usuario: seleccione el usuario de WordPress que se utilizará para la conexión API.

    • Permisos: seleccione Lectura/Escritura. Esto es necesario para que Gem Logic pueda tanto leer los pedidos como crear/actualizar productos en su tienda.

  5. Haga clic en Generar clave API.

  6. Copie la Clave de consumidor y el Secreto de consumidor. Solo se mostrarán una vez, por lo que asegúrese de guardarlos en un lugar seguro.

Importante

El secreto de consumidor solo se muestra una vez. Si lo pierde, deberá revocar la clave y generar una nueva.

Conectar WooCommerce a Gem Logic

  1. En Gem Logic, vaya a Configuración ‣ Canales de venta.

  2. Abra el canal de ventas que desea conectar a WooCommerce, o cree uno nuevo.

  3. Active la casilla WooCommerce.

  4. Complete los siguientes campos:

    • URL: la URL completa de su tienda WooCommerce (por ejemplo https://www.sutienda.com). No incluya una barra diagonal final.

    • Clave WooCommerce: pegue la Clave de consumidor que generó anteriormente.

    • Secreto WooCommerce: pegue el Secreto de consumidor que generó anteriormente.

  5. Si utiliza el plugin Perfect WooCommerce Brands en su tienda WooCommerce, active la casilla WooCommerce brands plugin. Esto permite que Gem Logic sincronice las marcas de productos con WooCommerce.

  6. Guarde el canal de ventas.

Truco

Asegúrese de que su tienda WooCommerce utilice HTTPS. Las credenciales de la API están cifradas y se almacenan de forma segura en Gem Logic.

Asignar productos al canal de ventas

Para que los productos se envíen a WooCommerce, deben estar asignados al canal de ventas de WooCommerce.

  1. Vaya a Productos.

  2. Abra un producto y vaya a su sección canales de venta.

  3. Agregue el canal de ventas de WooCommerce al producto.

  4. Asegúrese de que el producto tenga una regla de precio configurada para ese canal de ventas, de modo que tenga un precio al enviarse a WooCommerce.

Envío de productos

Puede enviar productos desde Gem Logic a su tienda WooCommerce. Esto crea o actualiza productos en WooCommerce según los datos en Gem Logic.

Enviar un solo producto

Para enviar un solo producto, abra el producto en Gem Logic y utilice la acción de envío desde la sección de canales de venta del producto. El producto se creará en WooCommerce si aún no existe, o se actualizará si ya tiene un identificador de WooCommerce.

Enviar todos los productos

Para enviar todos los productos asignados a un canal de ventas de WooCommerce de una sola vez:

  1. Vaya a Configuración ‣ Canales de venta.

  2. Abra el canal de ventas de WooCommerce.

  3. Haga clic en Enviar todos los productos a WooCommerce.

Esto se ejecuta como una tarea en segundo plano. Puede consultar el progreso en la página historial de envío.

Qué se envía

Cuando se envía un producto a WooCommerce, se sincronizan los siguientes datos:

  • SKU (utilizado para emparejar productos entre ambos sistemas)

  • Nombre y descripción (según el idioma del canal de ventas)

  • Precio normal y precio de oferta (desde la regla de precios para ese canal de ventas)

  • Imágenes (solo se vuelven a cargar si hay cambios)

  • Categorías y colecciones (creadas en WooCommerce si no existen)

  • Atributos (creados como atributos globales de WooCommerce)

  • Tags

  • Cantidad en stock

  • Marcas (si el plugin de marcas de WooCommerce está habilitado)

  • Tipo de producto: simple o variable (con variantes)

Productos variables y variantes

Si un producto en Gem Logic está marcado como producto padre, se envía como producto variable a WooCommerce. Todos sus productos hijos (variantes) se envían como variaciones de producto. Cada variante incluye su propio precio, SKU, imagen y valores de atributos (p. ej. talla, color).

Desactivación de productos

Puede desactivar un producto en WooCommerce desde Gem Logic. Esto establece el estado del producto como borrador en WooCommerce, haciéndolo invisible en la tienda sin eliminarlo.

Historial de envío

Cada operación de envío se registra. Puede consultar el historial de envío desde la página de detalles del canal de ventas. Cada registro del historial muestra:

  • Hora de inicio y finalización

  • Estado (iniciado, completado, fallido o éxito parcial)

  • Total de productos, conteos de éxitos y fallos

  • Tasa de éxito y duración

  • Resultados detallados por producto (haga clic en Ver detalles para ver qué productos tuvieron éxito o fallaron)

Importación de productos

Puede importar productos desde su tienda WooCommerce a Gem Logic. Esto es útil para la importación inicial cuando conecta su tienda por primera vez.

  1. Vaya a Configuración ‣ Canales de venta.

  2. Abra el canal de ventas de WooCommerce.

  3. Haga clic en Importar productos desde WooCommerce.

Esto se ejecuta como una tarea en segundo plano e importa los siguientes datos para cada producto:

  • SKU, nombre y descripción

  • Precio normal y precio de oferta

  • Categorías y marcas

  • Imágenes (descargadas y almacenadas en Gem Logic)

  • Tags

  • Cantidades en stock

  • Atributos y metales

  • Variantes de producto (para productos variables)

Nota

Los productos que ya existen en Gem Logic (identificados por ID de WooCommerce o SKU) se omiten durante la importación. Solo se crean productos nuevos.

Extracción de pedidos

Puede extraer los pedidos completados desde WooCommerce hacia Gem Logic.

Extraer pedidos manualmente

  1. Vaya a Configuración ‣ Canales de venta.

  2. Abra el canal de ventas de WooCommerce.

  3. Haga clic en Extraer pedidos desde WooCommerce.

Esto se ejecuta como una tarea en segundo plano. Será redirigido a la página historial de extracción donde puede supervisar el progreso en tiempo real.

Extracción automática de pedidos

Los pedidos también pueden extraerse automáticamente según una programación mediante el sistema de tareas en segundo plano. Esto garantiza que los nuevos pedidos completados se importen regularmente sin intervención manual.

Qué se importa

Cuando se extraen pedidos desde WooCommerce, se importan los siguientes datos:

  • Clave de pedido (utilizada como identificador único del pedido)

  • Información de contacto del cliente (nombre, dirección, correo electrónico, teléfono) — se crea o actualiza un contacto en el CRM

  • Fecha de pedido y divisa

  • Líneas de pedido: cada línea incluye el producto (identificado por ID de WooCommerce o SKU), cantidad, precios (sin IVA e IVA incluido) y tasa de IVA

  • Deducción de stock: el stock se deduce automáticamente para cada línea de pedido

Nota

Solo se importan los pedidos con estado completado. Los pedidos con otros estados (por ejemplo, en proceso, en espera, pendiente) se omiten.

Nota

Los pedidos que ya han sido importados (identificados por clave de pedido) se omiten para evitar duplicados.

Historial de extracción

Cada operación de extracción se registra. Puede consultar el historial de extracción desde la página de detalle del canal de ventas. Cada registro muestra:

  • Hora de inicio y finalización

  • Estado (iniciado, completado, fallido o éxito parcial)

  • Total de pedidos procesados, nuevos pedidos creados, omitidos y recuentos de fallos

  • Duración y mensajes de error