Section 23: Conexão de catálogo de entrada (Sincronização da plataforma)

Incoming Catalog Connection (Platform Sync)

A seção Incoming representa a conexão ativa entre sua plataforma de e-commerce e o CatalogPilot.

Este é o principal pipeline de dados que permite ao CatalogPilot observar seu catálogo para que o enriquecimento ocorra com segurança e fora da plataforma.

Este formulário é preenchido durante o onboarding e permanece acessível para referência e atualizações.

O que essa conexão faz

O conector do CatalogPilot:

• Lê com segurança os dados do catálogo da sua plataforma
  (produtos, imagens, descrições, categorias)
  
• Mantém sincronização contínua
  
• Não grava, não modifica e não envia dados de volta para sua plataforma
  
• Não interfere em preços, estoque, checkout ou pedidos
  

O CatalogPilot sempre opera fora do banco de dados da sua plataforma.

Isso é reforçado pelo tooltip inline exibido na interface.

Status e saúde da conexão

No topo do painel, os lojistas podem ver:

• Carimbo de data/hora Last Synced
  
• Indicador Sync Status (verde = saudável)
  
• Alternância Running
  

Isso confirma que o conector está ativo e se comunicando corretamente.

Se a sincronização for pausada ou interrompida, o CatalogPilot exibirá esse estado de forma clara e segura.

Detalhes de conexão explicados

Store Name

O nome legível da sua loja conforme aparece no CatalogPilot.

API Key / API Secret

Credenciais usadas para autenticar o acesso somente leitura.

Os secrets ficam mascarados por padrão e são armazenados com segurança.

Storefront URL

A URL canônica da sua storefront.

Usada para validação, contexto de crawl e alinhamento de entrega.

Cluster

Identifica a infraestrutura regional que processa seu catálogo

(ex.: us1). Isso é gerenciado automaticamente e raramente exige ajustes.

Language Code

Idioma principal usado para enriquecimento.

O CatalogPilot só enriquece idiomas que já existem na sua plataforma.

Currency Code

Usado apenas para normalização e referência.

O CatalogPilot não calcula nem modifica preços.

Referências legais e de conformidade

Para garantir transparência e conformidade, os lojistas devem fornecer:

• URL da Política de Privacidade
  
• URL de Termos e Condições
  

Esses links são usados posteriormente para anexar sinais de procedência e conformidade aos registros enriquecidos de produtos e categorias.

Eles não substituem as políticas da sua plataforma — eles as reforçam.

Salvando alterações

Alterações neste formulário:

• São validadas antes de salvar
  
• Não alteram enriquecimentos passados retroativamente
  
• São aplicadas com segurança a ciclos futuros de sincronização e enriquecimento
  

Na maioria dos casos, os lojistas raramente precisarão editar esta seção após o onboarding.

Filosofia de design

Este painel é intencionalmente simples e conservador.

Ele existe para responder a três perguntas:

• Meu catálogo está conectado?
  
• Ele está sincronizando com segurança?
  
• Posso confiar que nada destrutivo está acontecendo?
  

Se o status estiver verde, a resposta para as três perguntas é sim.