Integrar o Pimcore com o Magento é manter o catálogo num único repositório, o Pimcore, e fazer do Magento apenas o sítio onde esse catálogo é vendido. Os produtos, atributos, imagens e traduções são criados e aprovados no Pimcore e seguem para a loja por API. O Magento deixa de ser o lugar onde se corrige informação de produto.
O benefício para a empresa é a coerência. Quando o mesmo produto aparece em várias lojas, num marketplace e num catálogo impresso, é o repositório único que impede versões diferentes da mesma ficha. O custo é a disciplina: se alguém continuar a editar produtos diretamente no Magento, a próxima sincronização desfaz o trabalho. Este desenho faz parte de uma integração de PIM com ecommerce bem governada.
Neste artigo vê o que significa na prática ter um repositório único, como se liga o Pimcore ao Magento, como estruturar atributos e vistas de loja, os riscos mais frequentes e uma lista de verificação para arrancar com segurança.
O que significa ter o Pimcore como repositório único
Significa que cada dado de produto tem um dono, e esse dono é o Pimcore. O Magento recebe, mostra e vende; não corrige, não enriquece e não cria produtos por fora do fluxo.
- as descrições, os atributos técnicos e as traduções são editados só no Pimcore
- as imagens e os documentos vivem no Pimcore e a loja recebe as referências
- a aprovação do conteúdo acontece antes da publicação, não depois
- o Magento guarda o que é seu: carrinho, clientes, encomendas e regras de preço da loja
Esta divisão exige uma decisão da direção, não só da equipa técnica. Sem ela, o projeto acaba com dois catálogos que se contradizem. Se precisa de perceber como os restantes PIM resolvem o mesmo problema, compare com Akeneo e Magento ou com Salsify e Magento.
Como se liga o Pimcore ao Magento
A ligação faz-se por API, com o Datahub do Pimcore como origem. Segundo a documentação oficial, o Datahub inclui por defeito uma API GraphQL com um esquema gerado para cada endpoint, e permite limitar os dados expostos por área de trabalho. As consultas leem dados e as mutações alteram-nos no Pimcore.
Para trazer dados de fornecedores para dentro do Pimcore, a mesma documentação descreve o módulo de importação de dados. Lê CSV, JSON, XML e XLSX a partir de fontes como SFTP ou HTTP, escreve em objetos do Pimcore com um mapeamento configurável, ignora registos sem alterações e pode limpar objetos que já não existem na origem.
Do lado do Magento, a documentação da Adobe para programadores descreve a API REST de produtos e os endpoints em massa, que colocam cada produto numa fila de mensagens. Como o resultado só se conhece depois do processamento, o conector deve consultar o estado do lote. O funcionamento detalhado está explicado em Pimcore com Adobe Commerce. Confirme sempre a versão e o tipo de instalação do Magento, porque os endpoints disponíveis dependem deles.
Atributos, conjuntos e vistas de loja
O ponto mais delicado é a correspondência entre atributos. O Pimcore trabalha com classes e campos; o Magento trabalha com atributos e conjuntos de atributos. Cada campo do Pimcore que vai para a loja precisa de um atributo equivalente, com o mesmo tipo de dados.
| Pimcore | Magento | Cuidado |
|---|---|---|
| Classe de produto | Conjunto de atributos | Um conjunto por família |
| Campo de texto | Atributo de texto | Limite de tamanho |
| Lista de opções | Atributo de seleção | Valores iguais nos dois |
| Variantes | Configurável e simples | Enviar a família completa |
| Idioma | Vista de loja | Código de loja correto |
Segundo a documentação da Adobe, uma atualização sem código de loja altera apenas os valores da vista por defeito, enquanto o código especial all aplica o valor a todas as vistas. Um conector que ignore esta regra deixa os idiomas dessincronizados: o texto novo aparece numa vista e o antigo nas restantes.
As listas de opções merecem atenção própria. Se o Pimcore tem a cor Azul-marinho e o Magento tem Azul marinho, o conector cria opções duplicadas ou falha. Convém alinhar os valores antes da primeira carga e manter uma tabela de correspondência.
Que dados vão em cada sentido
| Dado | Sistema mestre | Sentido |
|---|---|---|
| Descrições e traduções | Pimcore | Pimcore para loja |
| Atributos técnicos | Pimcore | Pimcore para loja |
| Imagens | Pimcore | Pimcore para loja |
| Preço de tabela | ERP | ERP para loja |
| Stock | ERP | ERP para loja |
| Encomendas | Magento | Loja para ERP |
Para o lado do ERP, veja como se organiza a mesma divisão em SAP S/4HANA com Magento ou em Odoo com Magento.
Passos para montar o repositório único
- Inventariar todos os sítios onde hoje se edita informação de produto.
- Escolher o Pimcore como mestre e comunicar a regra a todas as equipas.
- Modelar as classes do Pimcore a partir dos conjuntos de atributos do Magento.
- Importar os dados de fornecedores para o Pimcore e limpar duplicados.
- Fechar o mapeamento de atributos, listas de opções e vistas de loja.
- Fazer uma carga de ensaio e comparar uma amostra de produtos nos dois sistemas.
- Bloquear a edição de produtos no Magento para os utilizadores de conteúdo.
- Passar à sincronização incremental com alertas de erro.
O passo de bloquear a edição no Magento costuma ser o mais esquecido. Sem ele, o repositório único existe só no papel, e a primeira sincronização completa pode apagar correções feitas à mão.
Riscos mais comuns
| Risco | Sinal | Prevenção |
|---|---|---|
| Edição paralela na loja | Alterações que desaparecem | Retirar permissões de edição |
| Opções duplicadas | Cores ou tamanhos repetidos | Tabela de correspondência |
| Idiomas desalinhados | Textos mistos por vista | Código de loja no mapeamento |
| Variantes incompletas | Produto sem opções | Enviar a família completa |
| Exposição excessiva | Campos internos na loja | Área de trabalho limitada |
Há ainda o risco de SEO. Se o conector reescrever títulos, descrições ou endereços de produtos já indexados, a loja pode perder posições sem aviso. Antes da primeira carga, decida quem controla esses campos e proteja os que já estão otimizados.
Lista de verificação antes de arrancar
- existe uma decisão escrita de que o Pimcore é o mestre do catálogo
- a edição de produtos no Magento está bloqueada para a equipa de conteúdo
- o mapeamento de atributos, opções e vistas de loja está fechado
- o conector consulta o estado dos lotes enviados
- a versão e o tipo de instalação do Magento estão confirmados
- os endereços e títulos otimizados existentes estão protegidos
- há um ambiente de ensaio com cópia do catálogo real
- alguém é responsável por rever os erros de sincronização
Se faltar mais de uma destas condições, o projeto ainda precisa de preparação. Arrancar sem elas costuma gerar retrabalho na loja, e é aí que o repositório único perde credibilidade junto da equipa.
Como medir se o repositório único está a funcionar
Há três sinais simples. O primeiro é o número de correções manuais feitas na loja depois de uma sincronização, que deve tender para zero. O segundo é o tempo entre aprovar um produto no Pimcore e vê-lo na loja. O terceiro é a lista de erros de sincronização por semana, que deve ser curta e ter responsável.
Estes indicadores não exigem ferramentas novas. Basta que o conector registe o que enviou, o que falhou e porquê, e que alguém reveja esse registo com uma periodicidade fixa. Sem esta rotina, os erros acumulam-se em silêncio e só aparecem quando um cliente encontra um produto sem foto ou com o texto errado.
Como trabalhamos na Avafa
Começamos pela regra de quem manda em cada dado e só depois pelo conector. Fechamos o mapeamento com as equipas de catálogo e de loja, testamos com uma amostra real e só então avançamos para a carga completa. Conheça a nossa agência especializada em integrações de catálogos e o trabalho de SEO para Magento que acompanha o catálogo depois da ligação.
Perguntas frequentes
Posso manter produtos criados só no Magento?
Pode, mas deve tratá-los como exceção documentada. Produtos fora do Pimcore ficam sem enriquecimento, sem aprovação e sem tradução centralizada.
O que acontece às alterações feitas à mão na loja?
Se o campo for gerido pelo Pimcore, a próxima sincronização substitui-o. Por isso a edição direta deve estar bloqueada para esses campos.
Preciso de importar dados de fornecedores para o Pimcore?
Só se esses dados não existirem já no Pimcore. O módulo de importação lê CSV, JSON, XML e XLSX e evita reprocessar registos que não mudaram.
Como se evitam opções duplicadas nos atributos?
Alinhando os valores das listas nos dois sistemas antes da primeira carga e mantendo uma tabela de correspondência que o conector consulta.
Esta integração serve para uma loja pequena?
Raramente compensa. Com poucos produtos e um só canal, a edição na própria loja é mais simples e mais barata de manter.