A diferencia de Shopify o WooCommerce, PrestaShop no tiene una pantalla de autorización. La conexión se hace con una clave de la Webservice API que creas tú en tu back office y pegas en Furgox. No hace falta tocar código ni instalar nada.
Antes de empezar
Necesitas entrar en el back office de tu tienda como administrador.
Ten a mano la dirección de tu tienda. Si PrestaShop está instalado en un subdirectorio, inclúyelo (
mitienda.com/tienda).Tu servidor debe tener activada la reescritura de URL: el webservice de PrestaShop la necesita para responder.
1. Activa el webservice de tu tienda
En el back office, ve a Parámetros Avanzados → Webservice. Abajo, en la configuración, pon Habilitar el webservice de PrestaShop en Sí y guarda. Si ya estaba activado, sigue al paso siguiente.
2. Crea una clave para Furgox
Pulsa Añadir nueva clave de webservice (según la versión y el idioma de tu PrestaShop, el botón puede llamarse algo distinto, por ejemplo «Añadir una nueva clase webservice»). En la ficha:
Pulsa Generar para que PrestaShop cree la clave, y cópiala: la necesitarás en el paso 4.
En Descripción de la clave escribe
Furgox, para reconocerla más adelante.Deja Habilitar clave de servicio web en Sí.
3. Marca los permisos
En la tabla Permisos de esa misma pantalla, marca la fila completa —Ver (GET), Modificar (PUT) y Añadir (POST)— de estos recursos, y guarda:
products, combinations, stock_availables, orders, order_states, order_histories, order_carriers, customers, addresses, countries
Para qué usamos cada grupo:
Productos y stock: leer tu catálogo con sus declinaciones, escribir el SKU de Furgox y actualizar las unidades disponibles.
Pedidos y estados: importar los pedidos pagados y mantener su estado al día.
Clientes y direcciones: saber a dónde enviar cada pedido.
Transportistas del pedido: escribir el número de seguimiento cuando el pedido sale del almacén.
Te recomendamos marcar también estos, aunque no son imprescindibles: states, currencies, product_option_values, configurations. Con ellos leemos la provincia de cada dirección, la moneda de los pedidos, los nombres de las opciones de tus declinaciones (talla, color…) y el nombre y la zona horaria de tu tienda.
Al conectar comprobamos que la clave tiene acceso a cada recurso y te decimos cuáles faltan. Lo que no podemos comprobar en ese momento es si tiene permiso de escritura: si te dejas el PUT o el POST, la conexión funciona pero el fallo aparecerá más tarde, al publicar el stock o al escribir el seguimiento. Marca la fila completa.
4. Pega la clave en Furgox
En tu panel, abre Integraciones, pulsa Conectar tienda, elige PrestaShop y rellena URL de tu tienda y Clave de la Webservice API con la clave que has copiado. Pulsa Conectar con PrestaShop.
La conexión tarda un poco más que en otras plataformas porque en ese momento leemos tu catálogo y tus pedidos. En tiendas grandes puede llevar un minuto: no cierres la pestaña.
5. Listo: la tienda ya está conectada
Qué pasa a partir de ahora
Productos
Importamos tus productos y sus declinaciones con su referencia, su código de barras y su foto. Al incluir un producto en su primera entrada recibe su SKU de Furgox, que escribimos también en tu PrestaShop. Si varias declinaciones comparten la misma referencia, a cada una le damos un código propio para poder distinguirlas en el almacén. Más en Qué hacemos con tu catálogo.
Pedidos
PrestaShop no puede avisarnos por su cuenta de lo que pasa en tu tienda, así que la consultamos cada 15 segundos. Importamos los pedidos pagados. Los que aún no lo están quedan retenidos y entran solos en cuanto tu tienda confirma el pago; los cancelados o con error de pago se descartan.
Si prefieres revisar cada pedido antes de que se prepare, activa Aceptar los pedidos yo mismo en la ficha de la tienda.
Stock
Publicamos en PrestaShop las unidades reales del almacén según entra mercancía y salen pedidos.
Envíos
PrestaShop sí tiene seguimiento nativo: escribimos el número de seguimiento en el transportista del pedido —el mismo que ve tu cliente en su cuenta y en el email— y después movemos el pedido al estado Enviado.
Recibe los pedidos al instante (opcional)
Si quieres que los pedidos aparezcan en el momento, sin esperar a la siguiente consulta, puedes instalar nuestro módulo Furgox Sync:
En Integraciones, dentro de la ficha de tu tienda PrestaShop, pulsa Descargar módulo y copia la Clave del módulo que aparece justo debajo.
En tu back office, ve a Módulos → Gestor de módulos → Subir un módulo y sube el archivo
furgoxsync.zip.Pulsa Configurar y pega la clave del módulo. La dirección del panel ya viene puesta.
Es opcional: sin el módulo todo funciona igual, solo que con unos segundos de espera. Y aunque lo instales, seguimos consultando tu tienda como red de seguridad.
Si algo no sale bien
«La clave no es válida o está desactivada»
Comprueba que la copiaste entera (32 caracteres) y que su estado es Sí en Parámetros Avanzados → Webservice.
«El webservice de tu tienda está desactivado»
Vuelve al paso 1: te falta poner Habilitar el webservice de PrestaShop en Sí.
«No encontramos la API en esa dirección»
Revisa la URL. Si PrestaShop vive en un subdirectorio, inclúyelo. Si tu tienda está en modo mantenimiento, tu IP tiene que estar en la lista de permitidas para que la API responda.
«A la clave le faltan permisos»
Te decimos qué recursos concretos faltan. Vuelve a la clave en tu back office, marca esas filas completas y pulsa Conectar con PrestaShop otra vez.
El stock o el seguimiento no llegan a mi tienda
Casi siempre es que a la clave le falta el permiso de escritura (PUT o POST) en algún recurso. Revisa en tu back office que las filas del paso 3 están completas.
He borrado o regenerado la clave en PrestaShop
Dejamos de sincronizar y, a los pocos minutos de que tu tienda rechace nuestra clave, la ficha pasa sola a Desconectada. Crea una clave nueva y pulsa Reconectar en la ficha, o ve a Conectar tienda → PrestaShop con la misma URL: se actualiza la tienda que ya tenías, sin perder pedidos ni histórico. Lo que hace cada botón de la ficha lo tienes en Sincronizar, desconectar o eliminar una tienda.
¿Te has quedado a medias? Escríbenos desde el chat de tu panel y lo terminamos contigo.