DocumentaciónCommerceCatalog Service

[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Incorporación e instalación

Última actualización: 21 de abril de 2026

Creado para:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}
NOTE
Para las soluciones de Commerce que usan Adobe Commerce Optimizer o Adobe Commerce Optimizer Connector, use la API de GraphQL de servicios de comercialización en lugar de la API de GraphQL de servicios de catálogo.

Instale el servicio de catálogo para solicitar y recibir datos de producto de una instancia de Commerce mediante la API de GraphQL del servicio de catálogo. El Servicio de catálogo se entrega como un compositor de PHP metapackage desde el repositorio repo.magento.com.

NOTE
Si la instancia de Commerce utiliza Live Search o Product Recommendations, el servicio de catálogo se instala o actualiza automáticamente al incorporar o actualizar esos servicios. Para obtener más información, consulte las instrucciones de instalación de Live Search y Product Recommendations.
Si utiliza Adobe Commerce as a Cloud Service, la versión más reciente del metapaquete está disponible en su entorno. Para empezar a usar los servicios, consulte Introducción al servicio de catálogo.
Para implementaciones de tiendas Commerce mediante Adobe Commerce Optimizer, consulte la Guía para desarrolladores de servicios de comercialización.

Requisitos del sistema

Requisitos de software

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2, 8.3, 8.4
  • Compositor: 2.x

Plataformas compatibles

  • Adobe Commerce en infraestructura en la nube: 2.4.4+
  • Adobe Commerce local: 2.4.4+

Extremos

Catalog Service tiene dos extremos disponibles para la incorporación:

  • Zona protegida (https://catalog-service-sandbox.adobe.io/graphql): se usa para pruebas y validación antes de activarse
  • Producción (https://catalog-service.adobe.io/graphql): se usa para el tráfico en directo de comerciantes y sitios web de Commerce.

Todas las instancias de prueba de Commerce utilizan el extremo de zona protegida.

Realice todas las pruebas de carga en el extremo de la zona protegida. Antes de comenzar la prueba de carga, envíe un ticket de asistencia para que el equipo de servicios pueda anticipar el tráfico adicional del servidor.

Instalación y configuración

Para comenzar con Catalog Service para Adobe Commerce, se requieren los siguientes pasos:

  • Instalar la extensión del Servicio de catálogo (magento/catalog-service)
  • Configuración del servicio y la exportación de datos
  • Acceso al servicio

Requisito previo

style
shade-box

Instale la última versión de la extensión de servicios de catálogo (magento/catalog-service) en una instancia de Adobe Commerce que ejecute Adobe Commerce versión 2.4.4 o posterior. El servicio de catálogo se entrega como un metapaquete de composición desde el repositorio repo.magento.com.

Infraestructura en la nube

Utilice este método para instalar Catalog Service para una instancia de Commerce Cloud.

  1. En la estación de trabajo local, cambie al directorio del proyecto para su proyecto de Adobe Commerce en la nube.

    note
    NOTE
    Para obtener información sobre cómo administrar los entornos de proyecto de Commerce localmente, consulte Administración de ramas con la CLI en la Guía del usuario de Adobe Commerce on Cloud Infrastructure.

  2. Consulte la rama de entorno para actualizar con la CLI de Adobe Commerce Cloud.

    code language-shell 
    magento-cloud environment:checkout <environment-id>

  3. Añada el módulo Servicio de catálogo.

    code language-bash 
    composer require magento/catalog-service --no-update

  4. Actualizar dependencias del paquete.

    code language-bash 
    composer update "magento/catalog-service"

  5. Agregue, confirme e inserte los cambios de código para los archivos composer.json y composer.lock en el entorno de nube.

    code language-shell 
    git add -A
git commit -m "Add catalog service module"
git push origin <branch-name>

    Si se insertan las actualizaciones en el entorno de la nube, se inicia el proceso de implementación de la nube de Commerce para aplicar los cambios. Compruebe el estado de implementación desde el registro de implementación.

Local

Utilice este método para instalar Catalog Service para una instancia local.

  1. Use Compositor para agregar el módulo Servicio de catálogo a su proyecto:

    code language-bash 
    composer require magento/catalog-service --no-update

  2. Actualice las dependencias e instale la extensión:

    code language-bash 
    composer update  "magento/catalog-service"

  3. Actualizar Adobe Commerce:

    code language-bash 
    bin/magento setup:upgrade

  4. Borre la caché:

    code language-bash 
    bin/magento cache:clean
    note tip
    TIP
    En algunos casos, especialmente al implementar en producción, puede que desee evitar borrar el código compilado, ya que puede tardar algún tiempo. Asegúrese de realizar una copia de seguridad del sistema antes de realizar cualquier cambio.

Configuración del servicio y la exportación de datos

Después de instalar Catalog Service, complete las siguientes tareas para integrar el servicio Catálogo con su instancia de Adobe Commerce. Esta integración permite la sincronización de datos y la comunicación entre la instancia de Commerce, el servicio de catálogo y otros servicios de soporte. La sincronización de datos está controlada por la extensión de exportación de datos SaaS.

  1. Configure Commerce Services Connector especificando las claves de API y seleccionando un espacio de datos SaaS.

    La configuración del Conector de servicios de Commerce es un proceso único necesario para utilizar servicios de Adobe Commerce como el Servicio de catálogo, Live Search y Recomendaciones de productos. Si ya ha configurado el conector para otro servicio, omita este paso.

  2. Realice una sincronización de datos inicial desde el panel de administración de datos.

    La sincronización inicial puede tardar entre unos minutos y horas según el tamaño del catálogo. Puede monitorizar el estado de sincronización desde el panel de control de Data Management. Después de la sincronización inicial, el catálogo exporta datos de productos de forma continua para mantener los servicios actualizados.

    note
    NOTE
    También puede iniciar la sincronización inicial desde la línea de comandos utilizando la CLI de Commerce. Consulte Sincronización inicial en la Guía de exportación de datos SaaS.

Para asegurarse de que la exportación del catálogo se ejecuta correctamente:

  • Confirme que los trabajos cron se están ejecutando.
  • Compruebe que los indexadores se estén ejecutando desde Admin o mediante el comando bin/magento indexer:info de la CLI de Commerce.
  • Compruebe que los indizadores Catalog Attributes Feed, Product Feed, Product Overrides Feed y Product Variant Feed estén establecidos en Update by Schedule.

Monitorización y solución de problemas de sincronización de datos

Para comprobar que la sincronización de datos funciona, confirme que los datos exportados correctamente desde Adobe Commerce y que se entregaron correctamente al servicio conectado de Commerce. Utilice los paneles de la implementación para comprobar ambos pasos.

Comience con la exportación y confirme la entrega.

  1. Compruebe el estado de sincronización en el Administrador de Commerce.

    Vaya a System > Data Transfer > Data Feed Sync Status.

    Página de estado de sincronización de fuente de datos con informes de estado de elemento de fuente {width="800" modal="regular"}

    Cuando se está ejecutando la sincronización, los datos de la fuente muestran los registros enviados correctamente. Seleccione una fuente para ver los detalles o solucionar problemas de sincronización.

  2. Confirme que los datos se han enviado a los servicios conectados de Commerce.

    Desde Commerce Admin, vaya a System > Data Transfer > Data Management Dashboard.

    Panel de administración de datos que muestra datos de catálogo sincronizados en servicios de Commerce conectados {width="700" modal="regular"}

    Compruebe que aparecen los productos, precios y atributos esperados.

TIP
Si tiene algún problema adicional con la sincronización de datos, consulte Revisar registros y solucionar problemas.

Use la CLI de Commerce para resincronizar fuentes manualmente cuando sea necesario. Para ver las opciones de resincronización y los pasos adicionales de solución de problemas, consulte Administrar sincronización en la Guía de exportación de datos SaaS.

NOTE
Si la página Estado de sincronización de fuentes de datos no está disponible en Commerce Admin para Commerce en la nube o en implementaciones locales, siga las instrucciones de instalación de extensión para habilitarla.
recommendation-more-help
commerce-help-catalog-service