DocumentaçãoCommerceGuia do Catalog Service

Introdução ao Catalog Service

Última atualização: 8 de maio de 2026

Criado para:

  • Admin
  • Developer

Depois que o Catalog Service for habilitado, você poderá acessar o serviço e usá-lo para recuperar dados de catálogo, como informações de produto e categoria, da sua instância do Adobe Commerce. O serviço está disponível como uma API do GraphQL que pode ser acessada pelo administrador do Commerce ou por qualquer aplicativo de front-end que ofereça suporte a consultas do GraphQL.

NOTE
Para soluções da Commerce que usam o Adobe Commerce Optimizer ou o conector do Adobe Commerce Optimizer, use a API do GraphQL de serviços de merchandising em vez da API do GraphQL de serviços de catálogo.

Acessar o serviço

O Catalog Service está disponível como uma API do GraphQL que você pode acessar do Administrador do Commerce ou de qualquer aplicativo de front-end que ofereça suporte a consultas do GraphQL. O serviço está disponível em ambientes SaaS e PaaS.

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Ambiente
Endpoint
Testando
https://catalog-service-sandbox.adobe.io/graphql
Produção
https://catalog-service.adobe.io/graphql

[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."}

Ambiente
Endpoint
Testes
https://na1-sandbox.api.commerce.adobe.com/{{tenant-id}}/graphql
Produção (ainda não disponível)
https://na1.api.commerce.adobe.com/{{tenant-id}}/graphql

Estrutura de URL para pontos de extremidade SaaS

https://<region>-<environment>.api.commerce.adobe.com/<tenantId>/graphql
  • <region> é a região da nuvem em que sua instância está implantada.
  • <environment> é o tipo de ambiente, como sandbox. Se o ambiente for de produção, esse valor será omitido.
  • <tenantId> é o identificador exclusivo da instância específica da sua organização na Adobe Experience Cloud.

Para obter detalhes sobre como usar a API do GraphQL do Serviço de Catálogo, consulte o Guia do Catalog Service for Adobe Commerce na documentação do Adobe Commerce Developer.

Integrar a uma loja headless ou a serviços de terceiros

Para integrar com uma loja headless, você deve atualizar a configuração da loja para habilitar a comunicação entre a loja e a Catalog Service para recuperar dados de produto e categoria.

Se você estiver usando a loja do Adobe Commerce no Edge Delivery Services, adicione o ponto de extremidade do Serviço de catálogo à configuração da loja. Para obter detalhes, consulte a documentação do Edge Delivery Services.

Para outras integrações, consulte a documentação de configuração do projeto para obter detalhes sobre como configurar integrações entre o serviço e as fontes de dados de back-end.

Configuração do firewall

Para permitir Catalog Service por meio de um firewall, adicione commerce.adobe.io ao incluo na lista de permissões.

Serviço de catálogo e API Mesh

A API Mesh para Adobe Developer App Builder permite que os desenvolvedores integrem APIs privadas ou de terceiros e outras interfaces com produtos da Adobe usando o Adobe IO.

Consulte o tópico Catalog Service e Malha de API para obter detalhes sobre instalação e configuração.

Monitorar e solucionar problemas de exportação de dados

O administrador do Commerce fornece ferramentas para monitorar e solucionar problemas na exportação de dados do Commerce para os serviços conectados:

  • Painel de Gerenciamento de Dados — Monitore a sincronização de dados entre o Catalog Service e sua instância do Adobe Commerce. O painel mostra o status geral de sincronização e lista todos os produtos sincronizados.

  • Página Status da Sincronização do Feed de Dados — Rastreie o status da exportação de todos os feeds de dados para garantir a consistência dos dados. Essa página alerta sobre problemas que ocorrem durante o processo de exportação para que você possa resolvê-los rapidamente. Um status “Sucesso” indica que os dados foram exportados e estarão disponíveis nos serviços conectados da Commerce quando o processo de sincronização de dados for concluído.

NOTE
Se a página Status da sincronização do feed de dados não estiver disponível no Commerce Admin for Commerce em implantações na nuvem ou locais, siga as instruções de instalação da extensão para habilitá-la.
recommendation-more-help
commerce-help-catalog-service