Conecte su tienda WooCommerce
a GSE-Web
Su catálogo y su stock disponible van a la tienda. Los pedidos pagados llegan a GSE-Web como albaranes de salida confirmados, con stock reservado.
En resumen
El conector WooCommerce une una tienda WooCommerce a un almacén de GSE-Web. GSE-Web publica el stock, la tienda envía sus pedidos. Lo configura un administrador de la organización, en el menú ADMIN › «Integraciones».
- Lo que va a la tienda: las fichas de los productos simples (nombre, referencia, precio, código de barras), si lo solicita, y el stock disponible del almacén publicado.
- Lo que llega a GSE-Web: cada pedido seleccionado se convierte en un albarán de salida confirmado, con stock reservado; el comprador pasa a ser un cliente «Particular».
- Cuándo: un pedido llega al instante por webhook; cada 5 minutos se ejecuta una pasada completa que recupera lo que hubiera faltado.
- Lo que nunca se hace: no se elimina nada en la tienda, y GSE-Web nunca escribe en los pedidos de la tienda.
- Desconexión: pausa, desconexión o cierre del módulo en cualquier momento, sin perder nada; al reanudar, se recuperan los pedidos realizados entretanto.
Requisitos
Compruebe estos puntos antes de abrir la pantalla del conector: la prueba de conexión los verifica y dice con claridad lo que no encaja.
WooCommerce 7.0 o posterior
La tienda debe servirse en HTTPS. El código de barras (GTIN) de los productos se publica a partir de WooCommerce 9.2.
Una clave de API REST de lectura y escritura
En WooCommerce: Ajustes › Avanzado › API REST › Añadir clave, permisos «Lectura/Escritura». Anote la clave y el secreto: WooCommerce no vuelve a mostrar el secreto.
Los módulos habilitados para su organización
«Integraciones» y luego «WooCommerce». Su apertura se solicita a KLS-Concept. Sin «Integraciones», la entrada del menú no aparece; sin «WooCommerce», su tarjeta indica «No disponible para su organización».
Una cuenta ADMIN con autenticación en dos pasos
La introducción de las credenciales de la tienda se rechaza mientras la autenticación en dos pasos no esté activada en su cuenta, en «Mi información».
Un almacén real
Su stock disponible se publica en la tienda y los pedidos se convierten allí en albaranes de salida. Un almacén de ejercicio se rechaza.
La misma moneda
La moneda de la tienda debe ser la de su organización.
El mismo régimen de precios
La opción «Precios publicados» (sin impuestos o con impuestos incluidos) debe coincidir con el ajuste «Precios introducidos con impuestos» de la tienda.
Configuración paso a paso
Seis pasos, en el orden de la pantalla.
Abrir la pantalla del conector
Menú ADMIN › «Integraciones». La tarjeta WooCommerce está en la categoría «Comercio electrónico». Haga clic en «Configurar» (el botón pasa a «Gestionar» una vez guardada la tienda).
Tarjeta «Tienda»
Rellene «Dirección de la tienda» (dirección completa, que empieza por https://), «Clave de cliente (consumer key)» y «Secreto de cliente (consumer secret)», y luego elija el «Almacén publicado».
La clave y el secreto son de solo escritura: una vez guardados, no vuelven a mostrarse. La pantalla muestra solo algunos caracteres de la clave para reconocerla. Para conservarla, deje vacíos los dos campos; para sustituirla, introduzca una nueva clave y su secreto.
Tarjeta «Ajustes»
Cada ajuste tiene un valor por defecto:
- «Precios publicados»: «Sin impuestos» por defecto, o «Impuestos incluidos».
- «Crear y actualizar las fichas de producto en la tienda»: desmarcado por defecto. Desmarcado, GSE-Web no crea ninguna ficha: solo vincula los productos ya presentes en la tienda con la misma referencia (SKU).
- «Publicar el stock disponible»: marcado por defecto.
- «Recibir los pedidos»: marcado por defecto.
- «Estados de pedido importados»: «Procesando» por defecto. Puede añadir «Pendiente de pago», «En espera» y «Completado».
- «Antigüedad máxima de un pedido recuperado (días)»: 30 por defecto, de 1 a 90.
Guardar
Haga clic en «Guardar». «Probar la conexión» y «Activar» actúan sobre la configuración guardada: mientras un cambio no esté guardado, la pantalla lo recuerda y esos dos botones esperan.
Probar la conexión
«Probar la conexión» consulta la tienda y comprueba cuatro puntos: la versión de WooCommerce, los permisos de escritura de la clave, la moneda y el régimen de precios. Un rechazo se muestra con claridad, con lo que falla (vea la resolución de problemas más abajo).
Activar
«Activar» repite la prueba y luego crea cuatro webhooks «GSE-Web» en WooCommerce. El estado pasa a «Activa — sincronización cada 5 minutos». Los pedidos recibidos antes de la activación no se importan.
Qué se sincroniza, y quién manda
Cada campo tiene un único dueño. GSE-Web nunca escribe un pedido de la tienda: no hay bucle posible.
📦 Manda GSE-Web
- ✓Nombre del producto
- ✓Referencia (SKU en la tienda)
- ✓Precio de venta, sin impuestos o con impuestos según el ajuste
- ✓Código de barras (GTIN, WooCommerce 9.2 o posterior)
- ✓Publicado o borrador
- ✓Stock
🛒 Manda la tienda
- ✓Descripción
- ✓Imágenes
- ✓Categorías
- ✓Clase de impuesto
- ✓Pedidos
Las reglas
- Solo productos simples. Los productos con variantes y los kits no se publican.
- Un producto retirado de la venta en GSE-Web pasa a borrador en la tienda. Nunca se elimina allí.
- Una ficha modificada en la tienda en un campo sobre el que manda GSE-Web se reescribe en el siguiente cambio del producto en GSE-Web.
- Stock publicado = stock disponible del almacén publicado (físico menos reservado), redondeado a la unidad inferior, nunca negativo. Se vuelve a leer en cada pasada y se envía si ha cambiado.
- Un pedido = un albarán de salida confirmado del almacén publicado, stock reservado, dirección de entrega copiada. Nunca un albarán parcial: si una línea da problemas (producto desconocido, variante, e-mail ausente, otra moneda), no se crea ningún albarán y un punto pendiente lo explica.
- Un comprador = un cliente «Particular», encontrado por su e-mail de un pedido a otro (código que empieza por WEB-). Un tercero ya presente en GSE-Web no se asocia: se crea un cliente «Particular».
- Pedido cancelado en la tienda (cancelado, reembolsado, fallido, enviado a la papelera o eliminado): el albarán se cancela y se liberan sus reservas, salvo que alguien ya lo esté tramitando. En ese caso, un punto pendiente deja la decisión al equipo.
- Pedido modificado en la tienda tras la importación: el cambio no se traslada al albarán; un punto pendiente le invita a revisarlo.
En el día a día
La pantalla del conector se lee de arriba abajo: el estado, la tienda, los ajustes, los botones, y después los puntos pendientes y el registro.
La tarjeta «Estado»
Indica en qué punto está la conexión, la versión de WooCommerce y la moneda de la tienda, la fecha de la última sincronización, el último error y el número de puntos pendientes. En la tarjeta de la página «Integraciones», el estado cabe en una etiqueta.
- Por activar «Configurada, aún no activada».
- Conectado «Activa — sincronización cada 5 minutos».
- En pausa «En pausa — no se envía ni se importa nada».
- Detenido — revisar «Detenida por el servidor — revise la clave y pruebe».
«Sincronizar ahora»
Lanza una pasada sin esperar los 5 minutos: fichas, stock y recuperación de pedidos. El mensaje indica si la pasada ha terminado, si ha detectado puntos pendientes o por qué no se ha lanzado.
El «Registro»
Cada pasada figura con su tipo y su resultado. Tipos: «Fichas de producto», «Stock», «Recuperación de pedidos», «Pedido recibido», «Control de webhooks», «Prueba de conexión». Resultados: «Correcto», «Parcial», «Fallido», «En curso», «Interrumpido».
Los «Puntos pendientes»
Una línea que no pasa nunca bloquea la sincronización: se convierte en un punto pendiente y el resto continúa. Los puntos de fichas y de stock desaparecen solos cuando se corrige su causa. Los puntos de pedidos tienen dos botones.
- «Reintentar» vuelve a leer el pedido en la tienda y reintenta la importación, sea cual sea su antigüedad.
- «Ignorar» archiva el punto: un punto ignorado no vuelve a la lista.
Fichas de producto
- Causa
- Solo los productos simples se publican en la tienda.
- Qué hacer
- Nada que hacer en GSE-Web. Gestione este producto directamente en la tienda.
- Causa
- El producto no tiene precio de venta en GSE-Web.
- Qué hacer
- Introduzca su precio de venta. El punto desaparece en la pasada siguiente.
- Causa
- Los precios se publican con impuestos incluidos y el producto no tiene tipo de IVA.
- Qué hacer
- Introduzca el tipo de IVA del producto.
- Causa
- El producto de la tienda que lleva esta referencia ya está vinculado a otro producto de GSE-Web, o no es un producto simple. Una referencia que contiene una coma tampoco puede buscarse en la tienda.
- Qué hacer
- Asegúrese de que una referencia designe un solo producto, en ambos lados.
- Causa
- WooCommerce ha rechazado la ficha; se muestra su código de rechazo.
- Qué hacer
- Revise el producto en la tienda a partir de ese código.
- Causa
- El producto vinculado ya no existe en la tienda.
- Qué hacer
- Vuelva a crearlo en la tienda con la misma referencia. Si ya no debe figurar en ella, escríbanos.
Stock
- Causa
- El stock disponible tiene decimales; la tienda solo vende unidades enteras.
- Qué hacer
- Solo informativo: la tienda muestra la unidad inferior.
- Causa
- WooCommerce ha rechazado la cantidad; se muestra su código de rechazo.
- Qué hacer
- Revise la ficha del producto en la tienda a partir de ese código.
Pedidos
- Causa
- Una línea del pedido lleva una referencia que no existe en GSE-Web.
- Qué hacer
- Cree el producto con la misma referencia y luego «Reintentar».
- Causa
- El pedido contiene una variante de producto, que el conector aún no gestiona.
- Qué hacer
- Tramite este pedido a mano.
- Causa
- Sin e-mail, el comprador no puede encontrarse ni crearse como cliente.
- Qué hacer
- Añada el e-mail de facturación al pedido en la tienda y luego «Reintentar».
- Causa
- El cliente que corresponde a este comprador ha sido archivado.
- Qué hacer
- No se crea ningún albarán. Tramite este pedido a mano.
- Causa
- El pedido está en una moneda distinta de la de su organización.
- Qué hacer
- Tramite este pedido a mano.
- Causa
- En la recuperación, el pedido supera la «Antigüedad máxima de un pedido recuperado».
- Qué hacer
- «Reintentar» lo importa de todos modos.
- Causa
- El albarán ya está en preparación: GSE-Web no lo cancela por su cuenta.
- Qué hacer
- Decídalo con el equipo. Si el albarán debe cancelarse, libérelo y luego «Reintentar».
- Causa
- El pedido ha cambiado en la tienda después de crearse el albarán; el cambio no se traslada.
- Qué hacer
- Compare el pedido y el albarán, y corrija el albarán si es necesario.
- Causa
- La importación ha fallado; el motivo figura entre paréntesis.
- Qué hacer
- Corrija la causa indicada y luego «Reintentar».
Webhooks
- Causa
- WooCommerce desactiva un webhook tras varios fallos de entrega, o se ha eliminado un webhook «GSE-Web» en la tienda.
- Qué hacer
- Nada que hacer: el control de webhooks, cada 6 horas, los vuelve a crear y recupera los pedidos.
Pausa, reanudación y cambios
El conector se desactiva y se vuelve a activar en cualquier momento. Tres cambios siguen una regla, que la pantalla recuerda y que el servidor hace cumplir.
«Pausar»
Ya no se envía ni se importa nada, y no se pierde nada. El stock mostrado en la tienda sigue siendo el del último envío.
«Reanudar»
Se vuelve a comprobar la tienda (versión, clave, moneda, régimen de precios) y luego empieza la recuperación: los pedidos realizados durante la pausa se importan si tienen menos de N días («Antigüedad máxima de un pedido recuperado», 30 por defecto, de 1 a 90). Los más antiguos pasan a ser puntos pendientes.
Cambiar de clave o de régimen de precios
Con una conexión activa, la dirección, la clave, el secreto y «Precios publicados» están bloqueados. Siga este orden: «Pausar», modificar, «Guardar», «Probar la conexión», «Reanudar».
Cambiar de tienda
Primero «Desconectar»: se retiran los webhooks de la tienda anterior. Después, introduzca la nueva tienda.
Volver a conectar la misma tienda
Los productos, los pedidos y los clientes ya vinculados se recuperan: no se crea un segundo albarán para un pedido ya importado.
Cambiar un ajuste de las fichas
Tras cambiar «Precios publicados» o «Crear y actualizar las fichas de producto en la tienda», la pasada siguiente vuelve a leer todo el catálogo.
«Desconectar»
Se retiran los webhooks de la tienda y se borran las credenciales. No se elimina nada en la tienda ni en GSE-Web: los albaranes y clientes ya importados se mantienen. Si la tienda no responde, la pantalla le pide que elimine usted mismo los webhooks «GSE-Web» en WooCommerce.
Cierre del módulo
Si KLS-Concept cierra el módulo para su organización, todo se detiene sin eliminar nada. Al reabrirlo, la pasada siguiente recupera los pedidos y vuelve a publicar el stock.
Seguridad y datos
Lo que guarda el conector, y cómo.
Credenciales cifradas
La clave y el secreto de la tienda se cifran en el servidor (AES-256-GCM). Nunca vuelven a mostrarse ni se escriben en los registros.
Autenticación en dos pasos
Es obligatoria para introducir o sustituir las credenciales de una tienda.
Solo HTTPS
La dirección de la tienda debe usar HTTPS y ser accesible desde Internet; una dirección de red privada se rechaza.
Webhooks firmados
Cada webhook recibido está firmado por la tienda, y su firma se comprueba antes de cualquier tratamiento. Su contenido no se conserva.
Datos del comprador
Sus datos se copian en su ficha de cliente y la dirección de entrega en el albarán. El vínculo con la tienda solo guarda una huella de su e-mail.
Nada en la exportación
Las credenciales cifradas no figuran en la exportación de portabilidad de la organización.
Resolución de problemas
El mensaje que muestra la pantalla, su causa y lo que hay que hacer. El código entre corchetes ayuda al soporte a localizar el caso. La aplicación muestra estos mensajes en inglés (o en francés); la traducción de esta página ayuda a entenderlos y el código entre corchetes permite identificarlos.
«Detenida por el servidor — revise la clave y pruebe»
Tras cinco rechazos de autenticación seguidos, el servidor detiene la conexión para no insistir. Revise la clave en WooCommerce, introduzca una nueva si es necesario, «Guardar», «Probar la conexión» y luego «Activar».
- Qué hacer
- Introduzca la dirección completa de la tienda, que empieza por https://, sin nada después del nombre del sitio.
[WOOCOMMERCE_SHOP_URL_INVALID]
- Qué hacer
- Use la dirección pública de la tienda.
[WOOCOMMERCE_SHOP_URL_PRIVATE_HOST]
- Qué hacer
- Revise la clave y el secreto en WooCommerce (Ajustes › Avanzado › API REST), o cree una nueva.
[WOOCOMMERCE_SHOP_AUTH_FAILED]
- Qué hacer
- Cree una clave con permisos «Lectura/Escritura» e introdúzcala.
[WOOCOMMERCE_SHOP_READ_ONLY_KEY]
- Qué hacer
- Actualice WooCommerce (7.0 como mínimo) y vuelva a probar.
[WOOCOMMERCE_SHOP_VERSION_UNSUPPORTED]
- Qué hacer
- El conector solo une una tienda en la moneda de su organización.
[WOOCOMMERCE_SHOP_CURRENCY_MISMATCH]
- Qué hacer
- Ajuste «Precios publicados» al ajuste «Precios introducidos con impuestos» de la tienda, guarde y pruebe.
[WOOCOMMERCE_SHOP_PRICE_MODE_MISMATCH]
- Qué hacer
- Compruebe que la tienda responde y vuelva a intentarlo.
[WOOCOMMERCE_SHOP_UNREACHABLE]
- Qué hacer
- Vuelva a intentarlo un poco más tarde.
[WOOCOMMERCE_SHOP_TIMEOUT]
- Qué hacer
- Espere: la pasada siguiente se reanuda sola.
[WOOCOMMERCE_SHOP_RATE_LIMITED]
- Qué hacer
- Compruebe que la dirección lleva a la tienda WooCommerce y que su API REST está activa.
[WOOCOMMERCE_SHOP_RESPONSE_INVALID]
- Qué hacer
- «Pausar», modificar, «Guardar», «Probar la conexión», «Reanudar».
[WOOCOMMERCE_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Qué hacer
- «Desconectar» y luego introduzca la nueva tienda.
[WOOCOMMERCE_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Qué hacer
- Siga este orden; el régimen se comprueba con la tienda en la prueba y al reanudar.
[WOOCOMMERCE_PRICE_MODE_CHANGE_REQUIRES_PAUSE]
- Qué hacer
- Introduzca los dos, o deje los dos vacíos para conservar la clave guardada.
[WOOCOMMERCE_CREDENTIALS_REQUIRED]
- Qué hacer
- Actívela en «Mi información» (la pantalla propone «Abrir «Mi información»») y vuelva a guardar.
[WOOCOMMERCE_CONNECTION_TWO_FACTOR_REQUIRED]
- Qué hacer
- Elija un almacén real como «Almacén publicado».
[WOOCOMMERCE_WAREHOUSE_EXERCISE_REFUSED]
- Qué hacer
- Vuelva a introducir la clave y el secreto, pruebe y luego active.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Qué hacer
- Espere a que termine la pasada en curso.
[INTEGRATIONS_CONNECTION_BUSY]
Preguntas frecuentes
¿Se admiten los productos con variantes?
Todavía no. Solo se publican los productos simples. Un pedido que contiene una variante no se importa: aparece en los puntos pendientes.
¿Se pueden conectar varias tiendas o varios almacenes?
No. Una organización conecta una tienda, y una tienda está vinculada a un solo almacén, el «Almacén publicado».
¿Se devuelven los envíos a la tienda?
No. GSE-Web nunca escribe en los pedidos de la tienda. La comunicación de los envíos está prevista en una próxima versión.
¿Se envían las imágenes de los productos?
No. Las imágenes, como la descripción y las categorías, se siguen gestionando en la tienda.
¿Qué ocurre si pongo en pausa o si se cierra el módulo?
No se envía ni se importa nada, y no se elimina nada. El stock de la tienda sigue siendo el del último envío. Al reanudar, se recuperan los pedidos realizados entretanto si tienen menos de 30 días (ajustable de 1 a 90).
¿Cuánto tarda un pedido en aparecer en GSE-Web?
Al instante, por webhook. Si un webhook se pierde, la pasada siguiente, cada 5 minutos, recupera el pedido.
¿Puede la tienda vender un producto que ya no está en stock?
El stock se vuelve a leer en cada pasada, cada 5 minutos, y se envía si ha cambiado. Entre dos pasadas, la tienda muestra el último stock enviado: una salida registrada en GSE-Web en ese breve intervalo solo se ve allí en la pasada siguiente.
¿Se reconoce a un comprador que ya figura entre mis terceros?
No. El conector crea un cliente «Particular» por comprador y lo encuentra por su e-mail en los pedidos siguientes, pero no lo asocia a un tercero ya registrado en GSE-Web.
¿Se importan los pedidos realizados antes de la activación?
No. Solo se importan los pedidos recibidos después de la activación.
¿Y Shopify, Sage u Odoo?
Figuran en la página «Integraciones», como conectores futuros. No hay fecha anunciada.
¿Cómo obtengo el conector?
KLS-Concept abre los módulos «Integraciones» y «WooCommerce» organización por organización. Escríbanos desde la página de contacto.
Conectar su tienda WooCommerce
Solicite la apertura del conector para su organización, o envíenos sus preguntas sobre su caso.