Guía de instalación de M2E Multichannel para Adobe Commerce PaaS

Esta guía explica cómo adquirir, implementar e instalar M2E Multichannel para Adobe Commerce PaaS.

El término «PaaS» hace referencia a Adobe Commerce en infraestructura en la nube y a Adobe Commerce en las instalaciones.

M2E Multichannel se distribuye como una aplicación de Adobe App Builder no descargable. No es necesario descargar el código fuente de la aplicación ni implementarla localmente mediante la CLI de Adobe I/O.

💡 Tutorial en vídeo: Mira el tutorial de instalación de M2E Multichannel para Adobe Commerce PaaS

Requisitos #

Antes de empezar, asegúrate de que dispones de:

• Adobe Commerce 2.4.5 o posterior instalado y en funcionamiento.
• Acceso a Adobe Exchange.
• Acceso a la cuenta de Adobe y a la organización asociadas a tu entorno de Adobe Commerce.
• Acceso de administrador al panel de administración de Adobe Commerce.
• Permiso para adquirir, implementar, asociar e instalar aplicaciones de App Builder.

ℹ️ M2E Multichannel utiliza la autenticación de Adobe IMS para Adobe Commerce PaaS. No es compatible con la autenticación de Commerce Integration (OAuth 1.0a).

Paso 1. Habilitar Adobe IMS #

Es necesario habilitar Adobe IMS para el entorno PaaS Commerce antes de que M2E Multichannel pueda utilizar la autenticación IMS.

Para habilitar Adobe IMS, ejecuta los siguientes comandos desde el directorio raíz de la aplicación Adobe Commerce:

php bin/magento admin:adobe-ims:enable
php bin/magento cache:flush

Cuando se te solicite, introduce tu ID de organización, ID de cliente y secreto de cliente, y confirma que la autenticación de dos factores (2FA) está habilitada para tu organización de Adobe. Adobe Commerce 2.4.5 y versiones posteriores incluyen el metapaquete IMS, pero es necesario configurar la integración antes de utilizarlo.

💡 Sigue la guía de integración de Commerce Admin de Adobe con la configuración de Adobe ID para obtener instrucciones sobre cómo configurar Adobe IMS.

Paso 2. Configurar el SDK de la interfaz de usuario de administración #

M2E Multichannel requiere que App Management y el SDK de la interfaz de usuario de administración estén disponibles en tu entorno de Adobe Commerce.

Adobe Commerce 2.4.8 y versiones posteriores #

El SDK de la interfaz de usuario de administración y la gestión de aplicaciones se incluyen automáticamente. No es necesaria ninguna instalación adicional.

Adobe Commerce 2.4.5–2.4.7 #

Instala el SDK de la interfaz de usuario de administración 3.3 o posterior desde la raíz de la aplicación de Adobe Commerce:

composer require magento/commerce-backend-sdk:^3.0

php bin/magento module:enable \
  Magento_AdminUISDK \
  Magento_AdobeIms \
  Magento_AdminAdobeIms

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

💡 Para obtener más información, consulta la guía de instalación del SDK de la interfaz de usuario de administración de Adobe.

Activar el SDK de la interfaz de usuario de administración #

Una vez que el SDK esté disponible:

1) Ve a Tiendas > Ajustes > Configuración.

2) Abre Adobe Services > Admin UI SDK.

3) Establece Habilitar SDK de la interfaz de usuario de administración en Sí.

4) Guarda la configuración.

Paso 3. Verificar la gestión de aplicaciones #

Una vez configurados IMS y el SDK de la interfaz de usuario de administración, comprueba que Aplicaciones > Gestión de aplicaciones esté disponible en tu panel de administración de Adobe Commerce.

En «Gestión de aplicaciones» podrás asociar e instalar la aplicación M2E Multichannel implementada.

Paso 4. Obtener M2E Multichannel desde Adobe Exchange #

1) Inicia sesión en Adobe Exchange.

2) En Experience Cloud, busca M2E Multichannel for Commerce Cloud.

3) Abre la página de la aplicación y haz clic en Adquirir.

4) Aparecerá un mensaje indicando que la aplicación requiere Adobe App Builder. Haz clic en Sí, continuar para seguir adelante.

5) Una vez adquirida la aplicación, haz clic en Gestionar tu aplicación.

Se te redirigirá a la página de gestión de aplicaciones en Adobe Exchange.

Paso 5. Crear un entorno #

Una vez adquirida y aprobada la aplicación, crea un entorno en el que se vaya a implementar.

1) En la página de gestión de aplicaciones, haz clic en el nombre de la aplicación M2E Multichannel for Commerce Cloud.

2) Haz clic en + Añadir entorno.

3) Introduce un nombre para el entorno, como Pruebas o Producción. Debe tener entre 3 y 10 caracteres.

4) Haz clic en Guardar entorno.

Una vez guardado el entorno, Adobe crea automáticamente el proyecto correspondiente de App Builder en Adobe Developer Console.

Abre el entorno recién creado para continuar.

Paso 6. Configurar e implementar el entorno #

Un entorno recién creado tiene el estado Borrador y debe configurarse e implementarse.

1) Abre Configuración desde el menú del entorno.

2) Selecciona el Perfil de producto que necesites.

3) Haz clic en Implementar.

4) Espera a que finalice la implementación.

La implementación puede tardar unos minutos. Una vez finalizada, el estado del entorno pasa a ser Implementado.

Durante la implementación, los valores de autenticación IMS necesarios se configuran automáticamente:

Variable	Descripción
AIO_COMMERCE_AUTH_IMS_ORG_ID	Tu ID de organización de Adobe.
AIO_COMMERCE_AUTH_IMS_CLIENT_ID	Identifica tus credenciales de OAuth de servidor a servidor.
AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS	El secreto de cliente de la misma credencial OAuth de servidor a servidor.
AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID	La identidad de la máquina para la que se emite el token de acceso.
AIO_COMMERCE_AUTH_IMS_SCOPES	Permisos que el token resultante está autorizado a utilizar.

💡 Para obtener más información sobre las credenciales OAuth de servidor a servidor, consulta la documentación de Adobe sobre autenticación.

Paso 7. Asociar la aplicación a Adobe Commerce #

Asocia la aplicación de App Builder a tu instancia de Adobe Commerce.

1) Inicia sesión en el panel de administración de Adobe Commerce.

2) Ve a Aplicaciones > Gestión de aplicaciones.

3) Haz clic en + Asociar aplicación.

4) Selecciona el Proyecto deseado.

5) Selecciona el Espacio de trabajo correspondiente.

6) Haz clic en Asociar.

Una vez completada la asociación, M2E Multichannel aparecerá en «Gestión de aplicaciones» con el estado Asociado.

Paso 8. Instalar M2E Multichannel #

1) Busca M2E Multichannel para Adobe Commerce Cloud en «Gestión de aplicaciones».

2) Haz clic en Instalar.

3) Confirma la acción haciendo clic de nuevo en Instalar.

4) Se abrirá la ventana de progreso de la instalación. Durante la instalación, Gestión de aplicaciones:

• activa el SDK de la interfaz de usuario de administración y registra la extensión en la interfaz de usuario de administración de Adobe Commerce;
• ejecuta el paso de instalación personalizado «Inicializar cuenta M2E», que envía los datos necesarios para inicializar la cuenta M2E.

5) No es necesario realizar ninguna acción mientras se ejecutan estos pasos. Mantén la página abierta hasta que se complete la instalación.

Una vez finalizada, la aplicación mostrará el estado Instalada en «Gestión de aplicaciones».

M2E Multichannel estará disponible en la sección Apps del panel de administración de Adobe Commerce. Puedes abrir la aplicación y continuar con la configuración inicial descrita en la Guía del usuario de M2E Multichannel.

¿Necesitas ayuda? #

Si tienes alguna duda o necesitas ayuda para instalar M2E Multichannel, ponte en contacto con el equipo de asistencia técnica.