Módulo Integraciones

Conecte su tienda
PrestaShop a GSE-Web

Su catálogo y su stock disponible salen hacia la tienda. Los pedidos que alcanzan los estados que usted elija llegan a GSE-Web como albaranes de salida confirmados, con el stock reservado.

Inicio / Documentación / Conector PrestaShop

En resumen

El conector PrestaShop une una tienda PrestaShop a un almacén de GSE-Web, mediante el Webservice nativo de la tienda: no hay nada que instalar en PrestaShop. GSE-Web publica el stock en la tienda y la tienda envía sus pedidos. Lo configura un administrador de la organización, en el menú ADMIN › «Integraciones».

  • Lo que sale hacia la tienda: las fichas de los productos simples, de los kits y de los productos con variantes (nombre, referencia, precio sin impuestos, código de barras), si lo pide, y el stock disponible del almacén publicado si marca «Publicar el stock disponible».
  • Lo que llega a GSE-Web: cada pedido que alcanza uno de los estados de pedido que usted elija se convierte en un albarán de salida confirmado, con el stock reservado, si marca «Recibir los pedidos»; el comprador pasa a ser un cliente «Particular». Si lo pide, también se recuperan de la tienda la descripción y las fotos de los productos vinculados.
  • Cuándo: el stock sale hacia la tienda unos segundos después de cada cambio en GSE-Web. PrestaShop no avisa a GSE-Web: los pedidos se leen cada 5 minutos, así que no llegan en tiempo real.
  • Lo que nunca se hace: no se elimina nada en la tienda (un producto retirado de la venta queda desactivado), GSE-Web nunca escribe las líneas de un pedido y nunca emite un reembolso. Solo pone el estado de pedido que usted haya elegido al entregarse o cancelarse un albarán, si lo pide.
  • Desconexión: pausa, desconexión o cierre del módulo en cualquier momento, sin perder nada; al reanudar, se recuperan los pedidos realizados entretanto.
  • El conector es compatible con el Webservice de PrestaShop 8 y 9. PrestaShop es una marca de su editor; GSE-Web no está editado ni aprobado por PrestaShop.
Antes de empezar

Requisitos

Compruebe estos puntos antes de abrir la pantalla del conector: la prueba de conexión los verifica y rechaza con claridad lo que falte.

✓

El Webservice activado y la reescritura de URL

En la administración de PrestaShop: Parámetros avanzados › Webservice, «Activar el servicio web de PrestaShop». El Webservice vive bajo /api/ y exige la reescritura de URL (Apache: mod_rewrite y AllowOverride All).

✓

Una clave del Webservice con los permisos correctos

32 letras y cifras, estado activado. Lectura sobre shops, languages, currencies, countries, configurations, categories, tax_rule_groups, images, orders, order_states, addresses, customers; lectura, creación y modificación sobre products y combinations; lectura y creación sobre product_options y product_option_values; lectura y modificación sobre stock_availables y order_carriers; creación sobre order_histories. La prueba nombra cada permiso que falta.

✓

Una dirección HTTPS pública

La tienda debe ser accesible desde Internet por HTTPS; se admite un subdirectorio (https://www.mi-tienda.es/tienda). Se rechaza una dirección http:// o en una red privada.

✓

Versiones probadas, una sola tienda

El conector está probado en PrestaShop 8.2.8, 9.1.0 y 9.1.2. Las demás versiones se aceptan, pero la pantalla de conexión muestra entonces una advertencia: contáctenos si tiene algún problema. Se rechaza una clave que ve varias tiendas: no se admite la multitienda.

✓

Los módulos habilitados para su organización

«Integraciones» y después «PrestaShop». Su apertura se solicita a KLS-Concept. Sin «Integraciones», la entrada del menú no aparece.

✓

Una cuenta ADMIN con autenticación en dos pasos

La introducción de la clave de la tienda se rechaza mientras la autenticación en dos pasos no esté activada en su cuenta, en «Mi información». Actívela antes de rellenar los campos.

✓

Un almacén real, la misma moneda, un grupo de impuestos

El almacén publicado es un almacén real (un almacén de ejercicio se rechaza). La moneda de la tienda debe ser la de su organización y la gestión de stock debe estar activada en ella. Para que GSE-Web cree fichas, la tienda debe tener un grupo de reglas de impuestos: una tienda nueva no tiene ninguno.

Configuración paso a paso

Seis pasos, en el orden de la pantalla.

1

Abrir la pantalla del conector

Menú ADMIN › «Integraciones». La tarjeta PrestaShop está en la categoría «Comercio electrónico». Haga clic en «Configurar» (el botón pasa a «Gestionar» una vez guardada la tienda).

2

Tarjeta «Tienda»

Rellene «Dirección de la tienda» (HTTPS, por ejemplo https://www.mi-tienda.es), «Clave del Webservice» (creada en Parámetros avanzados › Webservice) y «Almacén publicado» (un almacén real).

La clave es de solo escritura: una vez guardada, no vuelve a mostrarse; la pantalla solo muestra su principio y su final. Una tienda ya activada no cambia de dirección: hay que desconectarla antes.

3

Tarjeta «Ajustes»

Cada ajuste tiene un valor por defecto:

  • «Crear y actualizar las fichas de producto en la tienda»: desmarcado por defecto. Desmarcado, GSE-Web solo vincula los productos ya presentes en la tienda, por su referencia. Marcado, exige un «Grupo de reglas de IVA de las fichas creadas» y una «Categoría por defecto de las fichas creadas» (una ficha existente conserva los suyos).
  • «Publicar el stock disponible»: desmarcado por defecto; márquelo para que GSE-Web escriba el stock en la tienda. Exige que la gestión de stock esté activada en la tienda.
  • «Recibir los pedidos»: desmarcado por defecto; márquelo para importar los pedidos. Marcado, exige «Estados de pedido que crean un albarán» (al menos uno, por ejemplo «Pago aceptado»). Los estados son propios de cada tienda; un estado desconocido nunca se importa.
  • «Estados de pedido que cancelan el albarán»: opcional. Vacío, la tienda no cancela ningún albarán.
  • «Antigüedad máxima de un pedido recuperado (días)»: 30 por defecto, de 1 a 90. Tras una pausa o un cierre, un pedido más antiguo no se importa por sí solo.
  • «Informar a la tienda de las entregas y cancelaciones»: desmarcado por defecto; márquelo para que las entregas y cancelaciones se comuniquen. Marcado, con «Estado aplicado al entregar el albarán» (normalmente «Enviado») y «Estado aplicado al cancelar el albarán» (normalmente «Cancelado»). Sin estado elegido, no se comunica nada.
  • «Recuperar la descripción y las fotos de la tienda»: desmarcado por defecto. La tienda sigue siendo la dueña de estos contenidos; GSE-Web nunca los escribe en la tienda.
  • Ningún régimen de precios que ajustar: GSE-Web publica su precio de venta sin impuestos y la tienda calcula su precio con impuestos con el grupo de reglas elegido.
4

Guardar

Haga clic en «Guardar». «Probar la conexión» y «Activar» actúan sobre la configuración guardada: la pantalla pide guardar antes cualquier cambio.

5

Probar la conexión y elegir en las listas de la tienda

«Probar la conexión» interroga a la tienda: clave aceptada, permisos de la clave (con la lista de los que faltan), moneda igual a la de la organización, gestión de stock, una sola tienda visible. Muestra lo que la tienda ha declarado (versión de PrestaShop, zona horaria, moneda, idiomas) y carga las listas donde elegir: grupos de reglas de impuestos, categorías, estados de pedido. Elija ahí sus estados, guarde y pruebe de nuevo.

6

Activar

«Activar» repite la prueba, exige las elecciones que piden sus ajustes (estados; grupo de impuestos y categoría si crea fichas) y lanza la sincronización. Los pedidos hechos antes de la activación no se importan.

Qué se sincroniza, y quién manda

Cada campo tiene un único dueño. En un pedido de la tienda, GSE-Web solo escribe su estado de entrega o de cancelación, nunca sus líneas.

📦 Manda GSE-Web

  • ✓Nombre del producto (todos los idiomas de la tienda)
  • ✓Referencia (SKU en la tienda)
  • ✓Precio de venta sin impuestos
  • ✓Código de barras
  • ✓Puesta en venta o desactivación
  • ✓Stock, por producto o por combinación

🛒 Manda la tienda

  • ✓Descripción (recuperada en GSE-Web como opción)
  • ✓Fotos (recuperadas en GSE-Web como opción)
  • ✓Categorías, promociones, características
  • ✓Impuestos (grupos de reglas)
  • ✓Pedidos y sus estados
  • ✓Reembolsos

Las reglas

  • Productos simples, kits y productos con variantes. Un producto simple se publica como un producto estándar de PrestaShop. Un kit también, con por stock el número de kits que se pueden montar con los componentes del almacén publicado. Un producto con variantes se publica como un producto con combinaciones: los ejes (talla, color…) pasan a ser grupos de opciones y cada variante es una combinación con su referencia, su stock y una diferencia de precio respecto al precio base.
  • El nombre de GSE-Web manda. Una actualización del nombre lo reescribe en todos los idiomas activos de la tienda: las traducciones hechas en PrestaShop se sobrescriben.
  • Un producto retirado de la venta en GSE-Web queda desactivado en la tienda; nunca se elimina allí. Una variante retirada de la venta pasa a stock 0. Al crearse una ficha, la tienda rechaza los pedidos sin stock; una ficha existente conserva el ajuste del comerciante.
  • Precio de venta sin impuestos, publicado tal cual con 4 decimales. La tienda calcula su precio con impuestos con el grupo de reglas elegido para las fichas creadas: si su tasa difiere del IVA del producto en GSE-Web, el precio con impuestos de la tienda difiere del de GSE-Web.
  • Stock publicado = stock disponible del almacén publicado (físico menos reservado), redondeado a la unidad inferior, nunca negativo. Sale hacia la tienda unos segundos después de cada cambio: entrada, salida, transferencia, inventario, reserva puesta o liberada en un albarán. La pasada completa también lo vuelve a leer cada 5 minutos. Para una variante, el stock se escribe por combinación.
  • Un pedido = un albarán de salida confirmado del almacén publicado, con «Reservar los productos para este albarán.» marcado: se reserva toda la cantidad pedida, incluso por encima del stock (lo que falta se lee «Pendiente de recepción» en el albarán). Se copia la dirección de entrega. Nunca un albarán parcial: si una línea da problemas (producto desconocido, variante desconocida, kit no publicable, comprador sin e-mail, otra moneda), no se crea ningún albarán y un punto pendiente lo explica.
  • Detección por lectura, sin webhook. PrestaShop no avisa a GSE-Web: cada 5 minutos, GSE-Web lee los pedidos nuevos o modificados. Un cambio de estado se ve por tanto en la pasada siguiente, nunca en tiempo real.
  • Un comprador = un cliente «Particular», reconocido por su e-mail de un pedido al siguiente. Un tercero ya presente en GSE-Web no se vincula: se crea un cliente «Particular».
  • Un pedido que pasa a un estado de cancelación que usted haya elegido: el albarán se cancela y sus reservas se liberan, salvo que ya lo haya asumido alguien. En ese caso, un punto pendiente deja la decisión al equipo.
  • Pedido modificado en la tienda tras la importación: la modificación no se traslada al albarán; un punto pendiente le invita a revisarlo. Un pedido de kit se convierte en un albarán de salida sobre sus componentes; un pedido de variante da un albarán sobre la variante.
  • Comunicación de entregas y cancelaciones (ajuste desmarcado por defecto: el ADMIN lo marca): un albarán entregado o cerrado recibe primero su n.º de seguimiento (cuando su envío lo tiene) y después el pedido pasa al estado elegido; GSE-Web no activa el e-mail de la tienda: PrestaShop no avisa al comprador de este cambio. Un albarán cancelado en GSE-Web pone el estado de cancelación elegido, sin reembolso: se hace en PrestaShop. Un pedido que la tienda ya ha enviado o entregado no se deshace: un punto pendiente lo señala. Entregado parcialmente o en preparación: nada hasta que el albarán esté completo.
  • Recuperación de la descripción y las fotos (ajuste desmarcado por defecto): en cada pasada, para cada producto vinculado, la descripción de la tienda se copia como texto sin formato (una descripción vacía nunca borra la de GSE-Web); las fotos se añaden en el orden de la tienda y se quitan cuando desaparecen de la tienda. Como máximo 20 fotos por producto. No se recuperan: categorías, promociones, características, contenido propio de cada variante, ni los nombres, precios y códigos de barras modificados en la tienda.

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, el nombre 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 — stock enviado en cuanto cambia, pedidos leídos cada 5 minutos». El estado sigue los ajustes guardados: sin «Recibir los pedidos», «… pedidos no recibidos»; sin «Publicar el stock disponible», «… stock no publicado».
  • En pausa «En pausa — no se envía ni se importa nada».
  • Detenido — revisar «Detenida por el servidor — revise la clave del Webservice y pruebe».

«Sincronizar ahora»

El stock se envía automáticamente a la tienda, unos segundos después de cada cambio. PrestaShop no avisa a GSE-Web: los pedidos se leen cada 5 minutos. Este botón sirve para lanzar de inmediato la sincronización completa (fichas de producto, lectura de pedidos, entregas). El mensaje dice si la pasada ha terminado, si ha detectado puntos pendientes o por qué no se ha lanzado.

La tarjeta «Qué pasa entre GSE-Web y la tienda»

Bajo los ajustes, una tarjeta indica para cada intercambio en qué sentido va: de GSE-Web hacia la tienda (fichas, stock, variantes, entregas y cancelaciones), de la tienda hacia GSE-Web (pedidos, cancelaciones, descripción y fotos) y lo que nunca pasa (líneas de un pedido, reembolsos, categorías, reglas de impuestos, precios específicos, nombres, precios y códigos de barras modificados en la tienda). Una línea ligada a un ajuste desmarcado aparece con «Desactivado».

El «Registro»

Cada pasada figura con su tipo y su resultado. Tipos: «Fichas de producto», «Stock», «Stock en directo» (envío en cuanto cambia un stock, registrado solo si ha cambiado una cantidad), «Recuperación desde la tienda», «Lectura de pedidos», «Retorno de los albaranes», «Prueba de conexión». Resultados: «Correcto», «Parcial», «Fallido», «En curso», «Interrumpido». Un clic en una pasada abre su detalle, elemento por elemento. Las pasadas que no han cambiado nada pueden ocultarse.

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. No se ofrece para los puntos de comunicación a la tienda (cumplimiento, cancelación en la tienda): la pasada siguiente los reintenta sola.
  • «Ignorar» archiva el punto: un punto ignorado no vuelve a la lista. «Ignorar todo», en la cabecera de la lista, archiva de una vez todos los puntos abiertos, incluidos los que no se muestran, tras una confirmación.

Fichas de producto

Producto …: tipo no admitido — no publicado

Causa
El producto no es de un tipo que el conector sepa publicar.
Qué hacer
Use un producto simple, un kit o un producto con variantes.

Producto …: sin precio de venta — no publicado

Causa
El producto no tiene precio de venta en GSE-Web.
Qué hacer
Indique su precio de venta. El punto desaparece en la pasada siguiente.

Producto …: referencia no vinculada

Causa
La referencia la llevan varios productos de la tienda, empieza por un corchete, corresponde a un producto de otro tipo (pack, virtual, con combinaciones) o ya está vinculada a otro producto de GSE-Web.
Qué hacer
Haga única la referencia en la tienda o en GSE-Web; GSE-Web nunca vincula al azar.

Producto …: rechazado por la tienda

Causa
La tienda ha rechazado la ficha (referencia demasiado larga, nombre vacío, dato no válido).
Qué hacer
Corrija la ficha en GSE-Web: el punto desaparece en la pasada siguiente.

Producto …: no encontrado en la tienda

Causa
La ficha vinculada se eliminó en PrestaShop.
Qué hacer
Vuelva a crearla, o quite el producto del ámbito publicado, y sincronice de nuevo.

Producto …: tipo cambiado — ficha anterior dejada en la tienda

Causa
El producto ha pasado de simple a con variantes (o al revés): se quita el vínculo con la ficha anterior.
Qué hacer
Desactive o elimine la ficha anterior en PrestaShop y después ignore el punto.

Kit …: lista de materiales no publicable

Causa
El kit no tiene componentes, un componente está archivado o su unidad difiere de su unidad base.
Qué hacer
Corrija la composición del kit en GSE-Web.

Producto con variantes …: ninguna variante activa

Causa
El producto no tiene ninguna variante publicable.
Qué hacer
Cree al menos una variante con precio.

Variante …: su producto padre no está publicado

Causa
El padre falta, está archivado, fuera del ámbito, aún sin publicar, o sus ejes no son válidos.
Qué hacer
Publique el producto padre y corrija sus ejes, y sincronice de nuevo.

Producto …: ficha creada, rechazo de pedidos sin stock no aplicado

Causa
La ficha se creó pero PrestaShop no aceptó el ajuste «denegar pedidos sin stock».
Qué hacer
Aplique ese ajuste en PrestaShop si lo desea y después ignore el punto.

Producto …: foto no recuperada

Causa
Una foto de la tienda no se encuentra, tiene un formato no admitido, pesa demasiado (más de 5 MB), la tienda no responde, o el producto tiene más de 20.
Qué hacer
Corrija la foto en la tienda; el resto del producto se recupera igualmente.

Stock

Producto …: stock fraccionario redondeado

Causa
La cantidad disponible no es un entero; PrestaShop solo gestiona cantidades enteras.
Qué hacer
No hace falta ninguna acción; la cantidad se redondea a la unidad inferior.

Producto …: stock rechazado por la tienda

Causa
La tienda ha rechazado la cantidad enviada.
Qué hacer
Revise la ficha en la tienda; el envío se reintenta en la pasada siguiente.

Elecciones guardadas (tienda)

Grupo de reglas de impuestos elegido: ausente de la tienda — no se crea ninguna ficha

Causa
El grupo elegido se eliminó o desactivó en PrestaShop.
Qué hacer
Ponga la conexión en pausa, pruebe, elija otro grupo, guarde y reanude.

Categoría por defecto elegida: ausente de la tienda — no se crea ninguna ficha

Causa
La categoría elegida se eliminó en PrestaShop.
Qué hacer
Ponga la conexión en pausa, pruebe, elija otra categoría, guarde y reanude.

Estado al entregar: no elegido o ausente de la tienda — no se comunica nada

Causa
No hay ningún estado elegido, o el que lo estaba se eliminó de la tienda.
Qué hacer
Elija el estado en «Ajustes» (en pausa), guarde y reanude.

Estado al cancelar: no elegido o ausente de la tienda — no se comunica nada

Causa
No hay ningún estado elegido, o el que lo estaba se eliminó de la tienda.
Qué hacer
Elija el estado en «Ajustes» (en pausa), guarde y reanude.

Pedidos

Pedido …: producto desconocido (referencia …) — no se crea ningún albarán

Causa
Una línea del pedido lleva una referencia ausente de GSE-Web.
Qué hacer
Cree el producto con la misma referencia y después «Reintentar».

Pedido …: variante desconocida — no se crea ningún albarán

Causa
La combinación pedida es desconocida para GSE-Web, o se ha pedido la referencia de un producto con variantes sin combinación.
Qué hacer
Cree la variante en GSE-Web y después «Reintentar».

Pedido …: falta el e-mail del comprador — no se crea ningún albarán

Causa
La tienda no facilita ningún e-mail para este comprador.
Qué hacer
Corrija la ficha de cliente en PrestaShop y después «Reintentar».

Pedido …: el cliente de este comprador está archivado — no se crea ningún albarán

Causa
El cliente «Particular» vinculado a este e-mail se archivó en GSE-Web.
Qué hacer
Desarchive el cliente y después «Reintentar».

Pedido …: moneda distinta de la de la organización — no se crea ningún albarán

Causa
La moneda del pedido no es la de la organización; no se hace ninguna conversión.
Qué hacer
Trate este pedido a mano en GSE-Web y después ignore el punto.

Pedido …: demasiado antiguo para la recuperación — no importado

Causa
Es más antiguo que «Antigüedad máxima de un pedido recuperado».
Qué hacer
«Reintentar» lo importa, sea cual sea su antigüedad.

Pedido …: cancelado en la tienda, pero su albarán ya está asumido

Causa
El albarán ya lo ha asumido alguien: GSE-Web no lo cancela en silencio.
Qué hacer
Decida con el equipo de almacén si hay que detener la preparación.

Pedido …: modificado en la tienda tras su importación

Causa
Las líneas del pedido han cambiado desde que se creó el albarán.
Qué hacer
Revise el albarán y corríjalo a mano si hace falta.

Pedido …: importación imposible

Causa
Un error impide crear el albarán.
Qué hacer
Lea la causa en el detalle del punto, corríjala y después «Reintentar».

Pedido …: kit no publicable — no se crea ningún albarán

Causa
El kit pedido no tiene componentes, un componente está archivado o su unidad difiere.
Qué hacer
Corrija la composición del kit y después «Reintentar».

Pedido …: estado de entrega o de cancelación rechazado por la tienda

Causa
La tienda ha rechazado el estado puesto por GSE-Web.
Qué hacer
Revise el pedido en la tienda; la pasada siguiente lo reintenta.

Pedido …: albarán cancelado, pero el pedido ya está enviado o entregado en la tienda — a tratar con el cliente

Causa
El albarán se canceló en GSE-Web, pero la tienda ya había enviado o entregado el pedido: GSE-Web no lo deshace.
Qué hacer
Resuelva la situación con el cliente (reembolso, devolución) directamente en la tienda.

Pedido …: n.º de seguimiento no escrito en la tienda

Causa
El pedido no tiene transportista en PrestaShop, o tiene varios: no se pudo escribir el n.º de seguimiento. El estado, en cambio, sí se pone.
Qué hacer
Introduzca el n.º de seguimiento en PrestaShop si hace falta.

Pausa, reanudación y cambios

El conector se desactiva y se vuelve a activar en cualquier momento. Algunos 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 verificar la tienda (clave, permisos, moneda, grupo de impuestos, categoría y estados elegidos) y se lanza la recuperación: los pedidos hechos durante la pausa se importan si tienen menos de N días («Antigüedad máxima de un pedido recuperado», 30 por defecto). Los más antiguos pasan a ser puntos pendientes.

Cambiar la clave del Webservice

Con una conexión activa, la dirección de la tienda y la clave están bloqueadas. Siga este orden: «Pausar», modificar, «Guardar», «Probar la conexión», «Reanudar».

Cambiar la dirección de la tienda

«Desconectar» primero: los productos y pedidos ya vinculados designan la tienda anterior. Introduzca después la nueva dirección y su clave.

Reconectar la misma tienda

Los productos, pedidos y clientes ya vinculados se recuperan: no se crea un segundo albarán para un pedido ya importado.

Cambiar el grupo de impuestos, la categoría o los estados

Solo en pausa. Al reanudar, estas elecciones se vuelven a verificar contra la tienda: PrestaShop acepta en silencio un grupo de impuestos o una categoría que no existe, así que el control lo hace GSE-Web. Un grupo de impuestos o una categoría eliminados en la tienda pasan a ser un punto pendiente y no se crea ninguna ficha.

«Desconectar»

La clave se borra y la sincronización se detiene. No se elimina nada en la tienda ni en GSE-Web: los albaranes y clientes ya importados permanecen.

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.

Clave cifrada

La clave del Webservice se cifra en el servidor (AES-256-GCM). Nunca vuelve a mostrarse ni se escribe en los registros.

Autenticación en dos pasos

Es obligatoria para introducir o sustituir las credenciales de una tienda.

Solo tienda HTTPS pública

El conector solo llama a la dirección HTTPS introducida, en un host público cuya dirección se verifica; no se sigue ninguna redirección. Las fotos recuperadas solo se descargan desde una dirección HTTPS pública, sin transmitir nunca la clave.

Nada que abrir del lado de GSE-Web

PrestaShop no envía nada a GSE-Web: es GSE-Web quien interroga a la tienda. No hay que exponer ninguna dirección de GSE-Web a la tienda ni instalar ningún módulo en ella.

Datos del comprador

Sus datos de contacto pasan a su ficha de cliente y la dirección de entrega al albarán. El vínculo con la tienda solo conserva 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.

Detenido — revisar

«Detenida por el servidor — revise la clave del Webservice y pruebe»

Tras cinco rechazos de autenticación seguidos (clave desactivada o eliminada en PrestaShop), el servidor detiene la conexión para no insistir. Revise la clave en Parámetros avanzados › Webservice, introdúzcala de nuevo si hace falta, «Guardar», «Probar la conexión» y «Activar».

Dirección de tienda no válida: se espera una dirección HTTPS (subdirectorio admitido), sin credenciales ni parámetros

Qué hacer
Introduzca la dirección HTTPS de la tienda, por ejemplo https://www.mi-tienda.es, sin credenciales ni parámetros.
[PRESTASHOP_SHOP_URL_INVALID]

La dirección de la tienda designa una red privada: solo se puede conectar una tienda accesible desde Internet

Qué hacer
Use la dirección pública de la tienda.
[PRESTASHOP_SHOP_URL_PRIVATE_HOST]

La tienda rechaza la clave del Webservice

Qué hacer
Compruebe que la clave está copiada entera (32 caracteres) y activa en Parámetros avanzados › Webservice.
[PRESTASHOP_SHOP_AUTH_FAILED]

La clave del Webservice no tiene permiso sobre un recurso necesario

Qué hacer
Pruebe la conexión: la pantalla lista los permisos que faltan a la clave.
[PRESTASHOP_SHOP_ACCESS_DENIED]

La clave del Webservice no tiene todos los permisos necesarios (se nombran los que faltan)

Qué hacer
En Parámetros avanzados › Webservice, marque para esta clave los permisos listados y pruebe de nuevo.
[PRESTASHOP_RIGHTS_MISSING]

El Webservice de la tienda no responde

Qué hacer
Active el Webservice en Parámetros avanzados › Webservice y compruebe que la reescritura de URL funciona.
[PRESTASHOP_WEBSERVICE_UNAVAILABLE]

La moneda de la tienda difiere de la de la organización

Qué hacer
No se hace ninguna conversión: alinee la moneda por defecto de la tienda con la de la organización.
[PRESTASHOP_SHOP_CURRENCY_MISMATCH]

La tienda no gestiona el stock

Qué hacer
Active la gestión de stock en PrestaShop, o desmarque «Publicar el stock disponible».
[PRESTASHOP_STOCK_MANAGEMENT_DISABLED]

Esta clave ve varias tiendas: la multitienda aún no se admite

Qué hacer
Cree una clave limitada a una sola tienda.
[PRESTASHOP_MULTISHOP_UNSUPPORTED]

Elija el grupo de impuestos de las fichas que GSE-Web crea en la tienda

Qué hacer
Elija un grupo de reglas de impuestos tras probar la conexión. Una tienda nueva no tiene ninguno: cree uno en PrestaShop (Internacional › Impuestos › Reglas de impuestos).
[PRESTASHOP_TAX_GROUP_REQUIRED]

Elija la categoría por defecto de las fichas que GSE-Web crea en la tienda

Qué hacer
Pruebe la conexión y elija una categoría de la lista.
[PRESTASHOP_CATEGORY_REQUIRED]

Elija al menos un estado de pedido que cree un albarán de salida

Qué hacer
Elija un estado (por ejemplo «Pago aceptado»), o desmarque «Recibir los pedidos».
[PRESTASHOP_IMPORT_STATES_REQUIRED]

Desconecte primero la tienda actual (sus productos y pedidos están vinculados a ella) antes de introducir otra

Qué hacer
Haga clic en «Desconectar» e introduzca la nueva dirección y su clave.
[PRESTASHOP_SHOP_CHANGE_REQUIRES_DISCONNECT]

La tienda, el grupo de impuestos, la categoría y los estados de pedido se cambian con la conexión en pausa

Qué hacer
«Pausar», modificar, «Guardar», «Probar la conexión», «Reanudar».
[PRESTASHOP_SHOP_SETTINGS_CHANGE_REQUIRES_PAUSE]

Ponga la conexión en pausa antes de cambiar de tienda o de clave del Webservice

Qué hacer
«Pausar», cambiar la clave, «Guardar», «Probar la conexión», «Reanudar».
[PRESTASHOP_CONNECTION_ACTIVE_CHANGE_REFUSED]

Se requiere la clave del Webservice de la tienda

Qué hacer
Introduzca la clave del Webservice.
[PRESTASHOP_CREDENTIALS_REQUIRED]

Active la autenticación en dos pasos en su cuenta antes de introducir la clave del Webservice de una tienda

Qué hacer
Abra «Mi información», active la autenticación en dos pasos y vuelva.
[PRESTASHOP_CONNECTION_TWO_FACTOR_REQUIRED]

Un almacén de ejercicio no puede vincularse a una tienda en línea

Qué hacer
Elija un almacén real como «Almacén publicado».
[PRESTASHOP_WAREHOUSE_EXERCISE_REFUSED]

La tienda no es accesible o no ha respondido a tiempo

Qué hacer
Compruebe que la tienda está en línea; inténtelo de nuevo en unos instantes.
[PRESTASHOP_SHOP_UNREACHABLE]

Respuesta de la tienda ilegible o rechazada

Qué hacer
Inténtelo de nuevo; si el mensaje persiste, contacte con el soporte con el código indicado debajo.
[PRESTASHOP_SHOP_RESPONSE_INVALID]

La tienda limita las llamadas: inténtelo más tarde

Qué hacer
Espere unos minutos; la pasada siguiente reanuda.
[PRESTASHOP_SHOP_RATE_LIMITED]

Ya hay una sincronización en curso para esta conexión: vuelva a intentarlo en unos instantes

Qué hacer
Espere a que termine la pasada en curso.
[INTEGRATIONS_CONNECTION_BUSY]

Las credenciales guardadas ya no pueden leerse en este servidor: introdúzcalas de nuevo

Qué hacer
Introduzca de nuevo la clave del Webservice, pruebe y active.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]

Preguntas frecuentes

¿Se admiten los productos con variantes?

Sí. Un producto con variantes se publica como un producto con combinaciones, y cada variante como una combinación con su referencia, su stock y una diferencia de precio respecto al precio base. Los ejes pasan a ser grupos de opciones de la tienda.

¿Se pueden conectar varias tiendas?

No. Una organización conecta una tienda, y un almacén de GSE-Web, el «Almacén publicado», abastece esa tienda. La multitienda de PrestaShop no se admite: se rechaza una clave que ve varias tiendas.

¿Se devuelven las entregas a la tienda?

Sí, si «Informar a la tienda de las entregas y cancelaciones» está marcado (por defecto está desmarcado: el ADMIN debe marcarlo) y si ha elegido el estado que poner. Un albarán entregado o cerrado pasa el pedido al estado elegido, con el n.º de seguimiento cuando el envío lo tiene; GSE-Web no activa el e-mail de la tienda, PrestaShop no avisa al comprador de este cambio. Un albarán cancelado pone el estado de cancelación elegido, sin reembolso.

¿Se intercambian las imágenes y la descripción de los productos?

Nunca salen de GSE-Web: las fotos y la descripción se gestionan en PrestaShop. En cambio, si marca «Recuperar la descripción y las fotos de la tienda», GSE-Web las copia en la ficha del producto vinculado en cada pasada.

¿Se recuperan las categorías, promociones y características?

No. Siguen gestionándose en PrestaShop. Las fichas creadas por GSE-Web reciben una única categoría por defecto, que usted elige.

¿Los pedidos llegan en tiempo real?

No. PrestaShop no ofrece un webhook nativo: GSE-Web lee los pedidos nuevos o modificados cada 5 minutos. Un pedido puede aparecer hasta 5 minutos después de pasar al estado elegido. El stock, en cambio, sale de GSE-Web hacia la tienda unos segundos después de cada cambio.

¿Qué pasa 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 queda como en el último envío. Al reanudar, se recuperan los pedidos hechos entretanto, dentro de la antigüedad máxima elegida.

¿Qué versiones de PrestaShop se admiten?

El conector está probado en PrestaShop 8.2.8, 9.1.0 y 9.1.2. Las demás versiones se aceptan, con una advertencia en la pantalla de conexión: contáctenos si tiene algún problema.

¿Se modifica el nombre de mis productos en la tienda?

Cuando la creación y actualización de fichas está activada, sí: el nombre de GSE-Web manda y se reescribe en todos los idiomas activos de la tienda, lo que sobrescribe las traducciones hechas en PrestaShop. Sin esa opción, GSE-Web no toca las fichas.

¿Se reconoce a un comprador que ya está entre mis terceros?

No. El conector crea un cliente «Particular» por comprador y lo reconoce por su e-mail en los pedidos siguientes.

¿Se importan los pedidos hechos antes de la activación?

No. Solo se importan los pedidos leídos después de la activación.

¿Cómo obtengo el conector?

Los módulos «Integraciones» y «PrestaShop» los abre KLS-Concept organización por organización. Escríbanos desde la página de Contacto indicando la versión de su PrestaShop.

Conecte su tienda PrestaShop

Solicite la apertura del conector para su organización, o plantéenos sus preguntas sobre su caso.