Guía

Primeros pasos: conecta Nuira con PrestaShop

Aprende a crear una clave de webservice de solo lectura en tu back office de PrestaShop y conectar tu tienda con Nuira para convertir pedidos, ingresos y costes de producto en recomendaciones de crecimiento priorizadas.

Actualizado: 17 de agosto de 2026

Nuira ayuda a los equipos de ecommerce a decidir qué hacer a continuación combinando los pedidos y los costes de producto de tu tienda con tu inversión publicitaria, y mostrando las acciones con más probabilidad de aumentar el beneficio. Esta guía te explica cómo conectar PrestaShop con Nuira.

PrestaShop es autoalojado, así que conectarlo funciona de forma distinta a una plataforma alojada. No hay que instalar ninguna aplicación: creas una clave de acceso de solo lectura en tu propio back office y la pegas en Nuira. Son unos cinco minutos.

Antes de empezar

Necesitas acceso de administrador al back office de PrestaShop y un espacio de trabajo en Nuira. Si aún no tienes cuenta, regístrate en app.nuira.ai/signup y crea un espacio de trabajo antes de continuar.

Tu tienda debe ser accesible por HTTPS. Nuira se negará a conectarse por HTTP sin cifrar, porque tu clave de acceso viaja en cada petición y quedaría desprotegida.

Estos pasos sirven para PrestaShop 1.7, 8.x y 9.x. La redacción del back office cambia ligeramente entre versiones, pero los menús están en el mismo sitio.

Paso 1: activa el webservice

En tu back office, ve a Parámetros avanzados → Webservice.

Pon Activar el webservice de PrestaShop en Sí y guarda. Viene desactivado por defecto, así que este paso es necesario aunque ya exista alguna clave.

Paso 2: crea una clave

Haz clic en Añadir nueva clave de webservice.

Pulsa Generar para crear una clave de 32 caracteres. Usa el valor generado en lugar de escribir uno propio: PrestaShop espera exactamente 32 caracteres.

Ponle una descripción que reconozcas después, por ejemplo Nuira analítica (solo lectura), y deja el Estado en Activado.

Paso 3: concede permiso de Ver — el paso clave

En la tabla de Permisos, marca Ver para cada uno de estos recursos. Deja Modificar, Añadir y Eliminar sin marcar en todos: Nuira solo lee de tu tienda y nunca escribe en ella.

• orders
• order_details
• order_histories
• order_states
• products
• combinations
• stock_availables
• customers
• currencies
• shops
• configurations

Merece la pena revisar este paso dos veces. La tabla de permisos es por recurso, así que una sola casilla sin marcar permite que casi toda la sincronización funcione mientras una parte falla en silencio. order_details es el más delicado: contiene el coste por línea del que dependen todos los márgenes, y sin él Nuira puede mostrarte ingresos pero no beneficio.

Si se te olvida alguno, Nuira te dirá exactamente qué recurso falta al conectar, para que vuelvas y lo marques.

Guarda y copia la clave.

Paso 4: conecta desde Nuira

En Nuira, haz clic en Integraciones en la barra lateral, busca la tarjeta de PrestaShop y pulsa Conectar. Si no aparece, abre Añadir integración y elígela del catálogo.

Introduce dos datos:

• Dirección de la tienda: la dirección completa, por ejemplo https://tienda.ejemplo.com. Si PrestaShop está instalado en un subdirectorio, inclúyelo: https://ejemplo.com/prestashop.
• Clave de webservice: la clave que copiaste en el paso 3.

Nuira comprueba todos los recursos necesarios antes de guardar nada. Si algo falla, recibirás un mensaje concreto en lugar de un error genérico:

• La clave ha sido rechazada: está mal copiada o su estado no es Activado.
• Ninguna API de PrestaShop respondió en esa dirección: revisa la dirección, incluido el subdirectorio, y que la reescritura de URL esté activada.
• La clave no puede leer <recurso>: falta una casilla Ver del paso 3.
• No hemos podido conectar con tu tienda: puede estar caída, o un cortafuegos o plugin de seguridad puede estar bloqueándonos.

Paso 5: confirma la sincronización

Una vez conectada, tu página de Integraciones muestra PrestaShop con la etiqueta Conectado y la sincronización empieza en segundo plano.

La primera sincronización importa aproximadamente los últimos 90 días de pedidos, con sus líneas y el coste de proveedor registrado en cada una. Nuira espacia estas peticiones a propósito en lugar de pedirlas lo más rápido posible: tu tienda funciona en tu propio servidor, y una importación agresiva ralentizaría tu escaparate para clientes reales. Por eso un catálogo grande puede tardar. Después de la primera vez, Nuira se actualiza cada pocas horas y solo trae los pedidos que hayan cambiado.

Sobre los costes de producto

PrestaShop guarda el precio de proveedor en cada línea de pedido en el momento de la compra. Esto es realmente útil: significa que tus márgenes históricos siguen siendo exactos aunque cambies el coste de un producto, algo que no ocurre en todas las plataformas.

Si nunca has rellenado los precios de proveedor o de coste, Nuira mostrará los ingresos pero indicará el margen como desconocido en lugar de dar por hecho que tus costes son cero. Un coste que falta se ve; un coste tratado como cero mostraría un margen del 100% y falsearía en silencio todas las recomendaciones construidas sobre él. Puedes añadir los costes en PrestaShop cuando quieras y se recogerán a partir de los siguientes pedidos.

Desconectar o revocar el acceso

Para dejar de sincronizar desde Nuira, ve a Integraciones, abre el menú ··· de la tarjeta de PrestaShop y elige Desconectar. Esto elimina la clave que guardamos y detiene las sincronizaciones. Los datos ya importados se conservan, para que tus recomendaciones anteriores no cambien sin avisar.

Como la clave vive en tu propia tienda, también puedes revocar el acceso directamente: en Parámetros avanzados → Webservice, pon el estado de la clave en Desactivado o bórrala. Nuira marcará entonces la conexión como pendiente de revisión en la siguiente sincronización.

¿Necesitas ayuda?

Si tienes cualquier problema al conectar tu tienda, escríbenos a marc@nuira.ai y te ayudamos.