aimeos para TYPO3: E-Commerce & Online-Shop

Quien necesita una tienda dentro de TYPO3 difícilmente puede evitar aimeos

Empresas que ya operan una web TYPO3 y quieren añadir comercio electrónico se enfrentan a una decisión fundamental: sistema de tienda separado (Shopware, Magento, WooCommerce) con interfaz hacia el CMS, o framework nativo de e-commerce dentro de TYPO3. aimeos es la segunda opción y desde hace más de 10 años el framework de tienda más establecido para TYPO3. Más de 200.000 instalaciones a nivel mundial (datos de Packagist, 2026), desarrollo activo y soporte para TYPO3 v12 y v13 respaldan su estabilidad.

La ventaja decisiva: contenido y comercio funcionan en el mismo sistema. Las páginas de producto utilizan elementos de contenido TYPO3, las landing pages pueden integrar componentes de tienda y los editores trabajan en una sola interfaz. Con sistemas separados surgen problemas de sincronización, doble mantenimiento y diseño inconsistente.

Escenarios de uso habituales

Tiendas B2B con lógica de precios compleja. Empresas industriales con precios específicos por cliente, descuentos escalonados, cantidades mínimas y flujos de aprobación. aimeos soporta nativamente precios por grupo de clientes, plugins de precios y motores de reglas. Un distribuidor químico con 8.000 artículos y 400 grupos de clientes se puede modelar sin que cada regla de precios quede codificada a fuego.

Marketplaces y escenarios multi-vendor. aimeos puede funcionar como backend de marketplace donde varios proveedores gestionan sus productos. Cada vendor administra su surtido, la plataforma gestiona checkout, pago y enrutamiento de envíos. El framework soporta configuraciones multi-tienda donde diferentes storefronts acceden al mismo catálogo pero muestran surtidos y precios distintos.

Internacionalización desde el primer día. Empresas con webs en 5 o más idiomas y varias divisas se benefician de que aimeos integra multi-idioma y multi-divisa de forma nativa. Nombres de producto, descripciones y metadatos SEO se gestionan por idioma. Los precios se definen por divisa o se convierten automáticamente.

Arquitectura técnica

aimeos se basa en una arquitectura MVC propia (Manager, Controller, Client) que se integra como extensión TYPO3. El núcleo es agnóstico de framework y también funciona bajo Laravel y Slim. La capa adaptadora TYPO3 garantiza que los plugins de aimeos se incrusten como elementos de contenido TYPO3.

El catálogo de productos usa una estructura de árbol con anidamiento ilimitado. Los atributos (color, tamaño, material) se gestionan como entidades propias y se ofrecen mediante filtros de facetas. La búsqueda se basa por defecto en búsqueda de texto completo SQL, pero puede cambiarse a Elasticsearch o Solr.

Las integraciones de pago funcionan a través de service providers: Stripe, PayPal, Mollie, Amazon Pay, Klarna y otros están disponibles como plugins. Cada proveedor de pago se accede mediante una API unificada. El proceso de checkout se implementa como pipeline de pasos, ampliable con pasos propios (por ejemplo, verificación de edad, aprobación B2B).

El caché opera en varios niveles: TYPO3 Page Cache para páginas estáticas, caché interno de aimeos para consultas de catálogo y opcionalmente Varnish o Cloudflare como reverse proxy. En catálogos con más de 100.000 artículos, la gestión de índices es decisiva: aimeos crea índices de búsqueda y precios que se actualizan incrementalmente con cada actualización de producto.

Problemas frecuentes y soluciones

Caídas de rendimiento con catálogos grandes. Tiendas con más de 50.000 artículos se vuelven lentas cuando los índices no están actualizados o el caché de catálogo se ha desactivado. Solución: ejecutar php typo3/sysext/core/bin/typo3 aimeos:jobs como cronjob (cada 5 minutos para actualizaciones de índices, cada hora para tareas de limpieza). Vaciar manualmente el caché de administración de aimeos tras importaciones masivas.

Abandonos en el checkout por errores de pago. Causa frecuente: API keys caducadas o URLs de webhook incorrectas tras un cambio de dominio. Cada proveedor de pago necesita una URL de notificación correcta por la que llegan confirmaciones de pago asíncronas. Solución: revisar las URLs de webhook en el panel del proveedor de pago tras cada migración, realizar pedidos de prueba en modo sandbox.

Conflictos con el caché de TYPO3. Las páginas aimeos con carrito o login no deben almacenarse en el Page Cache de TYPO3. Solución: marcar las páginas relevantes como USER_INT o usar aimeos en modo SPA (basado en AJAX). Desde aimeos 2024.x el modo SPA es la recomendación estándar.

Migración y compatibilidad de versiones

aimeos es compatible con TYPO3 v12 LTS completamente y con TYPO3 v13 desde aimeos 2024.x. Para TYPO3 v11 hay releases de mantenimiento, pero sin nuevas funcionalidades.

La migración desde otros sistemas de tienda es un escenario realista. Desde Shopware, WooCommerce o tt_products se pueden transferir productos, categorías, cuentas de cliente e historial de pedidos a aimeos. Gosign utiliza pipelines de importación CSV/XML donde los datos de producto se transforman y mapean a la estructura de aimeos. Según la calidad de los datos, la migración de una tienda con 5.000 productos toma entre 3 y 10 días.

Otro camino de migración afecta a empresas que hasta ahora han mantenido una tienda Shopware o Magento separada en paralelo a su web TYPO3. La unificación en un solo sistema elimina la complejidad de interfaces: sin sincronización por API REST para datos de producto, sin doble gestión de plantillas, sin despliegues separados. La desventaja: aimeos no cubre todas las funcionalidades de un sistema de tienda dedicado (por ejemplo, Shopware Flow Builder, Magento Page Builder). Sin embargo, la evaluación vale la pena para empresas donde contenido y comercio tienen el mismo peso - no solo cuenta la tienda, sino también el magazín, la base de conocimiento y las páginas de servicio.

Gosign asesora caso por caso si aimeos es la elección adecuada o si un sistema de tienda separado con conexión headless a TYPO3 representa la mejor arquitectura. La decisión depende de tres factores: complejidad del catálogo (variantes, configuradores, bundles), volumen de transacciones (por debajo o por encima de 1.000 pedidos al día) e infraestructura TYPO3 existente (extensiones, plantillas, flujos de redacción).

Un setup aimeos con catálogo de productos, carrito, pago con Stripe y PayPal, cálculo de envío y plantillas base se estima en 15 a 25 días de desarrollo. Temas personalizados, lógica de precios compleja o funcionalidades de marketplace incrementan el esfuerzo proporcionalmente. La operación continua requiere actualizaciones regulares (aimeos y plugins de proveedores de pago), así como monitorización del rendimiento del checkout y la tasa de conversión.