Integración PrestaShop – Akeneo: guía para conectar tu tienda online con el PIM

Resumen

Integrar PrestaShop con Akeneo consiste en que las fichas de producto que el equipo prepara en el PIM (textos, atributos, imágenes, traducciones y categorías) se publiquen en la tienda sin copiarlas a mano, con sus combinaciones bien montadas y en todos los idiomas. Antes de elegir cómo hacerlo, hay que decidir cómo encaja el modelo de Akeneo con el de PrestaShop, qué datos gestiona cada sistema y de dónde salen el precio y el stock.

Hay cinco caminos: módulos y conectores de terceros, desarrollo a medida contra las dos API, plataformas iPaaS, intercambio de ficheros o un hub de integración. Cuál conviene depende del tamaño del catálogo, de los idiomas y tiendas que gestionas y de si hay un ERP que aporta precio y stock.

Qué tener en cuenta antes de plantearte la integración

Qué sistema manda en cada dato

Lo habitual es este reparto:

• Akeneo manda en los textos, los atributos, las imágenes, las traducciones, la clasificación y la decisión de qué se publica.
• PrestaShop manda en la navegación y el aspecto de la tienda, las reglas de precio y de carrito, los transportistas y el pedido.
• Tu ERP, si lo tienes, manda en el precio base y el stock.

Si alguien edita una descripción en el back office de PrestaShop, la siguiente sincronización la pisará. Déjalo claro al equipo: los datos de producto se cambian en Akeneo.

Tu versión de PrestaShop y sus módulos

Revisa la versión de PrestaShop (1.7, 8 o 9), si usas multitienda y qué módulos tocan productos: filtros por características, SEO, packs o personalización. La integración tiene que respetar lo que esos módulos esperan encontrar, y cada actualización de PrestaShop obliga a comprobarlo.

Qué edición de Akeneo usas

Akeneo tiene una edición Community, de código abierto y que instalas tú, y ediciones de pago en la nube con más funciones (gestión de activos, flujos de aprobación, permisos, apps). Todas ofrecen API REST; la edición decide dónde viven las imágenes y qué conectores del App Store de Akeneo puedes usar.

El modelo de Akeneo frente al de PrestaShop

Akeneo trabaja con familias de atributos y modelos de producto con hasta dos niveles de variantes. PrestaShop distingue entre características (datos informativos, como el material) y atributos de combinación (los que generan variantes, como talla o color). Antes de conectar, decide qué atributos de Akeneo son características y cuáles generan combinaciones.

De dónde salen el precio y el stock

Akeneo no está pensado para el precio de venta ni para el stock. Si tienes un ERP, lo lógico es que esos datos vayan del ERP a PrestaShop directamente; si no, se gestionan en la propia tienda. Lo importante es que un producto no se publique sin precio ni se venda sin stock.

Volumen, idiomas y tiendas

¿Cuántos productos y combinaciones tienes? ¿En cuántos idiomas y tiendas? Un catálogo de miles de referencias en cuatro idiomas genera muchas llamadas a la API de PrestaShop, y un hosting justo sufre con las sincronizaciones masivas.

Qué significa integrar PrestaShop con Akeneo: definición operativa

En la práctica, una integración PrestaShop–Akeneo es un conjunto de flujos de datos de producto, cada uno con su origen, su destino, su momento y sus reglas.

De Akeneo a PrestaShop

• Productos y combinaciones: cada modelo de producto se convierte en un producto con sus combinaciones y referencias.
• Contenido: nombre, descripciones, características, datos SEO y URL amigable, en cada idioma.
• Imágenes: asignadas al producto y a cada combinación.
• Categorías: el árbol del canal de Akeneo, convertido en categorías de la tienda.

De PrestaShop a Akeneo

• Identificadores: el ID de producto y de combinación en PrestaShop, para que las siguientes sincronizaciones actualicen en lugar de duplicar.
• Estado de publicación: si el producto está activo en la tienda, útil para el equipo de producto.

Flujos que no pasan por el PIM

• Precio y stock: del ERP a PrestaShop, o gestionados en la tienda si no hay ERP.
• Pedidos: de PrestaShop al ERP; el PIM no interviene.

Cada flujo se dispara por un evento (un producto completo en Akeneo, un cambio de stock) o se programa cada cierto tiempo. Lo importante es que haya un registro de qué se ha sincronizado, qué ha fallado y por qué.

Particularidades de la integración PrestaShop – Akeneo

Modelos de producto y combinaciones

Akeneo permite hasta dos niveles de variantes (por ejemplo, color y después talla). PrestaShop genera combinaciones planas a partir de sus atributos. La integración tiene que aplanar los dos niveles, crear los grupos de atributos y sus valores en PrestaShop y asignar a cada combinación su referencia y sus imágenes.

Atributos, características y filtros

Los atributos de Akeneo que no generan variantes suelen convertirse en características de PrestaShop, que son las que usan los filtros de la tienda. Los valores tienen que normalizarse (una lista cerrada de opciones, no texto libre), o los filtros acabarán con opciones duplicadas.

Categorías

Akeneo tiene un árbol de categorías por canal; PrestaShop, un árbol por tienda con una categoría por defecto para cada producto. Decide si el árbol de la tienda se gestiona en Akeneo o en PrestaShop, y cuál es la categoría principal de cada producto, que afecta a la URL y a las migas de pan.

Idiomas y SEO

Cada idioma de Akeneo tiene que corresponder a un idioma activo de PrestaShop. La URL amigable, el meta título y la meta descripción pueden gestionarse en Akeneo como atributos, pero cambiar una URL publicada sin redirección cuesta posicionamiento. Define qué campos SEO manda el PIM y cuáles se quedan en la tienda.

Imágenes

PrestaShop genera sus propios tamaños de imagen al subirlas, así que cada envío masivo de imágenes consume recursos del servidor. La integración solo debería reenviar las imágenes que han cambiado y respetar el orden y la imagen de portada que se decidieron en Akeneo.

Completitud y publicación

Akeneo calcula qué porcentaje de atributos obligatorios tiene cada producto por canal e idioma. Usa esa completitud como regla: un producto solo se activa en PrestaShop cuando está completo para el canal de la tienda, y tiene precio y stock.

Multitienda

Si usas la multitienda de PrestaShop, cada tienda puede tener su catálogo, sus idiomas y sus textos. Lo más limpio es un canal de Akeneo por tienda, con sus categorías y sus reglas de completitud.

Límites técnicos de cada lado

• Akeneo ofrece una API REST con límites de uso y procesos de exportación por lotes. Las cargas masivas tienen que repartirse en el tiempo.
• PrestaShop ofrece su webservice clásico y, desde la versión 9, una nueva Admin API. Crear productos con combinaciones e imágenes exige muchas llamadas, y el rendimiento depende mucho del hosting.

Métodos para integrar PrestaShop con Akeneo

Módulos y conectores de terceros

En el App Store de Akeneo y en PrestaShop Addons hay conectores entre los dos, desarrollados por partners.

• A favor: cubren el flujo estándar de productos, combinaciones, categorías e imágenes.
• En contra: calidad y soporte desiguales, dependes de que se actualicen con cada versión de PrestaShop y de Akeneo, y el precio y el stock quedan fuera.
• Encaja si: tu catálogo es estándar y no hay un ERP de por medio.

Desarrollo a medida

Tu agencia o un programador conecta la API de Akeneo con la de PrestaShop, o escribe un módulo propio.

• A favor: se ajusta exactamente a tu catálogo y a tu tienda.
• En contra: dependes de quien lo escribió, y cada actualización de PrestaShop o de Akeneo obliga a revisarlo.
• Encaja si: tienes un equipo técnico que lo mantenga.

Plataformas iPaaS

Plataformas de integración con conectores para Akeneo y para PrestaShop.

• A favor: flujos configurables y conectores listos.
• En contra: montar combinaciones e imágenes suele requerir bastante lógica, y el coste crece con el volumen.
• Encaja si: ya usas una y alguien de tu equipo la domina.

Intercambio de ficheros

Exportar productos de Akeneo en CSV e importarlos con el importador de PrestaShop.

• A favor: sin coste de integración.
• En contra: manual, delicado con combinaciones, idiomas e imágenes, y sin control de errores.
• Encaja si: es la carga inicial o un catálogo pequeño.

Hub de integración

Una plataforma central a la que se conectan Akeneo, PrestaShop, el ERP y el resto de canales, con flujos configurados para tu catálogo.

• A favor: la ficha sale del PIM y el precio y el stock del ERP, coordinados, con un mismo registro de errores y sin módulos que actualizar en la tienda.
• En contra: necesita una fase de definición inicial y es más proyecto que “instalar y listo”.
• Encaja si: hay un ERP de por medio, varias tiendas o idiomas, o más canales aparte de PrestaShop.

Cómo elegir

Hazte cuatro preguntas:

1. ¿Cuántos productos, combinaciones e idiomas tengo?
2. ¿Uso multitienda?
3. ¿Hay un ERP que aporta precio y stock?
4. ¿Akeneo alimenta solo PrestaShop o también otros canales?

Si el catálogo es estándar, solo hay una tienda y no hay ERP, un conector de terceros puede bastar. Si hay ERP, varias tiendas o más canales, un hub que coordine PIM, ERP y tienda tiene más sentido.

Integrar otros sistemas en el stack

PrestaShop y Akeneo rara vez van solos:

• ERP: precio, stock, pedidos y facturas. Tienes las guías de PrestaShop con Sage 200, Sage 50, a3ERP y Holded, y la de Sage 200 y Akeneo.
• Marketplaces: Amazon y otros, que también se alimentan del PIM.
• Transporte: mira la guía de PrestaShop y Correos Express.

Si cada sistema se conecta por su cuenta con PrestaShop, la ficha llega por un lado, el precio y el stock por otro y los pedidos salen por un tercero, cada uno con su propio punto de fallo. Con un hub central, cada sistema se conecta una vez y el hub reparte cada dato desde su origen.

Integración PrestaShop – Akeneo con Stoam Connect

Stoam Connect es el hub de integración de Stoam. Conecta Akeneo con PrestaShop y con el resto de sistemas de tu negocio mediante flujos diseñados para tu catálogo, no para un catálogo medio.

• PIM, ERP y tienda coordinados. La ficha sale de Akeneo, el precio y el stock del ERP y los pedidos vuelven al ERP.
• Sin módulos que mantener en la tienda. La conexión vive en el hub, no dentro de PrestaShop.
• Un proyecto con definición previa. Antes de ejecutar, revisamos contigo familias, combinaciones, idiomas y reglas de publicación.
• Licencia fija. No hay coste por volumen ni por operación.
• Infraestructura segura. El hub se aloja en un entorno con certificación ISO 27001 y ENS.

Preguntas frecuentes