Integración con Magento

Esta guía explica cómo crear manualmente una integración de Magento para Semantico.

Usa este flujo cuando quieras que Magento se conecte a Semantico creando una nueva integración en el panel de administración de Magento (Magento Admin) e introduciendo tú mismo las URLs de callback e identidad que te facilitemos.

Requisitos previos

Antes de empezar, ten a mano estos valores:

• Callback URL
• Identity Link URL

Semantico debe proporcionarte esas dos URLs.

Crear la integración en Magento Admin

1. Inicia sesión en Magento Admin.
2. Ve a System > Extensions > Integrations.
3. Haz clic en Add New Integration.
4. Introduce un nombre, por ejemplo Semantico.
5. Si quieres, rellena los demás campos de contacto, como el email, aunque lo importante es la configuración de la API.
6. En Callback URL, pega la URL de callback de Semantico.
7. En Identity Link URL, pega la URL del enlace de identidad de Semantico.
8. Haz clic en Save (Guardar).

Añadir los permisos de API necesarios

Después de guardar la integración:

1. Abre la pestaña API de la integración.
2. Concede estos permisos:
   • Catalog
   • Stores > Attributes > Product
   • Stores > Attributes > Attribute Set
3. Vuelve a guardar la integración.

Estas son las etiquetas de Magento Admin que debes buscar al seleccionar los permisos.

Activar la integración

1. Vuelve a System > Extensions > Integrations.
2. Busca la integración Semantico.
3. Haz clic en Activate (Activar).
4. Aprueba el acceso solicitado.

A continuación, Magento enviará las credenciales de la integración mediante el flujo de callback definido por las URLs anteriores.

Para qué necesita Semantico estos permisos

El acceso necesario es:

• Catalog: acceso a las entidades del catálogo, como productos y categorías
• Stores > Attributes > Product: acceso a los atributos de producto
• Stores > Attributes > Attribute Set: acceso a los conjuntos de atributos

Verificación

Tras la activación, comprueba que:

1. La integración aparece como activa en System > Extensions > Integrations.
2. Semantico confirma la conexión con Magento por su parte.

Notas

• Las URLs exactas de callback e identidad dependen de cada entorno y debe proporcionarlas Semantico.
• Las etiquetas de permisos anteriores coinciden con las de Magento Admin, que derivan de los recursos ACL de Magento:
  • Magento_Catalog::catalog
  • Magento_Catalog::attributes_attributes
  • Magento_Catalog::sets