Integrar o Plytix com o Magento é levar os dados de produto que a equipa mantém no PIM para o catálogo da loja, sem os voltar a escrever à mão. O Plytix não tem um conector próprio para Magento: segundo a ajuda oficial do Plytix, o caminho documentado é um canal em CSV ou XML, publicado por URL, que o Magento lê através da extensão Wyomind.
Para o negócio, a diferença está na rotina. Sem ligação, cada alteração de descrição, atributo ou imagem passa por folhas de cálculo e por importações manuais, e a loja acaba com fichas desatualizadas. Com um canal bem desenhado, o PIM passa a ser a fonte dos dados de produto e o Magento limita-se a publicá-los.
Este guia explica como a ligação funciona, que passos seguir, o que o Magento faz sem extensão e que cuidados evitam erros. Faz parte do nosso trabalho de integração de catálogos e PIM para lojas com muitas referências.
Como funciona a ligação entre o Plytix e o Magento?
O Plytix gera um ficheiro de produtos a partir de um canal e o Magento importa esse ficheiro. O fluxo é num só sentido: do Plytix para a loja. Não há leitura de volta de preços, stock ou encomendas, que continuam a ser geridos no Magento ou no ERP.
Na ajuda do Plytix, os canais podem produzir CSV, XLSX, XML ou NDJSON. Para o Magento, o guia oficial usa um canal CSV ou XML e a extensão Wyomind Mass Product Import & Update, que lê o ficheiro a partir de um endereço. A mesma ajuda explica que o Magento não suporta, por si só, importações agendadas de dados de produto por URL, e é por isso que a extensão é necessária.
Dentro do Plytix, o canal permite escolher os produtos, mapear atributos para os campos de destino, definir a ordem das colunas e decidir se entram pais, variantes ou ambos. Também é possível agendar o processamento recorrente e enviar cópias do ficheiro para um servidor FTP.
Que passos seguir para importar produtos com o Wyomind?
Os passos seguem a documentação do Plytix para o Wyomind e devem ser testados primeiro com um grupo pequeno de produtos.
- Criar no Plytix um canal CSV ou XML, atribuir os produtos e mapear os atributos para os nomes de campo que o Magento espera.
- Processar o canal para gerar o ficheiro e copiar o endereço do feed.
- No Wyomind, criar um perfil novo e colar o endereço do canal.
- Ativar o perfil, escolher o método que atualiza os produtos existentes e importa os novos, e indicar CSV com vírgula e primeira linha de cabeçalho.
- Definir a localização das imagens como servidor HTTP, para o Magento as ir buscar por endereço.
- Ativar a deteção automática da árvore de categorias, com as categorias separadas por barra e não pelo sinal maior.
- Mapear cada coluna do ficheiro para um atributo do Magento até não sobrar nenhuma.
- Executar o perfil manualmente, confirmar o resultado em Catálogo > Produtos e só depois agendar as execuções.
O guia do Plytix recomenda ainda executar apenas os indexadores necessários no fim da importação. Alguns atributos, como o que indica se o produto tem opções, exigem um valor personalizado, e a própria ajuda admite que o processo pode pedir tentativa e erro, porque os dados de cada catálogo são diferentes.
O que o Magento faz sem extensão?
Sem extensão, o Magento importa produtos por ficheiro CSV carregado na administração. A documentação da Adobe para o Adobe Commerce e o Magento Open Source descreve três comportamentos: adicionar ou atualizar, substituir e eliminar. Em adicionar ou atualizar, todos os campos podem mudar, exceto o SKU.
A importação tem uma etapa de validação: o botão Check Data analisa o ficheiro e só depois se pode importar. Os erros ficam listados, e pode escolher parar ao primeiro erro ou ignorar as linhas com problemas, dentro de um limite configurável (por omissão, 10).
Há três pontos práticos da documentação que convém conhecer. O tamanho máximo do ficheiro depende do php.ini do servidor e, por omissão, é de 2 MB. Ficheiros com marca de ordem de bytes UTF-8 podem falhar. E, em catálogos grandes, a Adobe aconselha a retirar as colunas de categorias e de url_key quando não se alteram, porque incluí-las regenera os reescritos de URL de todos os produtos e alonga a importação.
Que dados exigem mais cuidado?
Os problemas raramente estão no texto. Estão nos campos que ligam o ficheiro à estrutura do Magento.
| Dado | Risco | Cuidado |
|---|---|---|
| SKU | Duplicados ou alterados | Nunca reutilizar nem renomear |
| Categorias | Separador errado | Barra, como pede o Wyomind |
| Imagens | Endereços inacessíveis | Testar o URL antes de importar |
| Variantes | Produto pai em falta | Importar pais e variantes juntos |
| Preço e stock | Fonte duplicada | Manter no Magento ou no ERP |
A regra que mais poupa trabalho é decidir, campo a campo, qual é o sistema mestre. O Plytix manda nos textos, atributos e imagens. Preço e stock ficam no sistema de gestão, e o canal do PIM não os deve sobrescrever.
Convém também separar os atributos por idioma desde o início. Se a loja Magento tem várias vistas de loja, o ficheiro precisa de colunas ou de canais distintos para cada língua, e o mapeamento deve indicar a que vista pertence cada valor. Descobrir isto depois da carga obriga a repetir a importação.
Wyomind, importação nativa ou middleware?
A escolha depende da frequência das alterações e da equipa que mantém a ligação. Esta é a matriz de decisão que usamos como ponto de partida.
| Opção | Automação | Quando faz sentido |
|---|---|---|
| Wyomind com feed | Agendada | Alterações frequentes de catálogo |
| Importação nativa CSV | Manual | Cargas pontuais ou arranque |
| Middleware ou API | Total | Regras próprias e vários destinos |
O Wyomind é a opção documentada pelo Plytix e a mais simples de manter. A importação nativa serve para a carga inicial ou para correções. O middleware justifica-se quando o mesmo catálogo alimenta várias lojas, marketplaces e o ERP, e são precisas regras de transformação que o mapeamento do canal não cobre.
Lista de verificação antes de arrancar
Antes de ligar o primeiro feed, confirme estes pontos.
- Os SKUs do Plytix coincidem com os do Magento.
- Cada atributo do Magento tem um atributo correspondente no Plytix.
- As categorias existem na loja e usam o separador correto.
- As imagens estão num endereço público e estável.
- Há um ambiente de ensaio com uma cópia do catálogo.
- Ficou definido quem corrige os erros do relatório de importação.
- O agendamento evita as horas de maior tráfego.
Como trabalhamos na Avafa
Começamos por mapear os atributos, os SKUs e as categorias, e só depois configuramos o canal e o perfil de importação. Testamos num ambiente de ensaio, revemos o relatório de erros e deixamos documentado quem manda em cada dado. Se a sua loja Magento precisa de um catálogo mais organizado, conheça a nossa agência de SEO para Magento ou fale connosco sobre integração de catálogos.
Guias relacionados do mesmo cluster
Se ainda está a comparar sistemas, estes guias tratam combinações próximas:
- Plytix com Adobe Commerce para marcas médias
- Plytix com PrestaShop para pequenas empresas
- Plytix com BigCommerce
- Akeneo com Magento: fluxos de produção e ensaio
- Bluestone PIM com Magento
- Brandfolder com Magento
Perguntas frequentes
O Plytix tem um conector nativo para Magento?
Não está documentado. A ajuda do Plytix descreve a importação para o Magento através de um feed por URL e da extensão Wyomind, de um fornecedor terceiro.
O Plytix sincroniza stock e preços com o Magento?
O canal envia os atributos que mapear, mas o fluxo é unidirecional e pensado para dados de produto. Stock e preços devem ter um sistema mestre próprio, normalmente o Magento ou o ERP.
A importação pode ser agendada?
Com a extensão Wyomind, sim: a ajuda do Plytix indica que o separador de tarefas agendadas permite escolher dias e horas. Sem extensão, a importação nativa é manual.
Posso importar imagens por endereço?
Sim. A documentação da Adobe aceita caminhos para ficheiros carregados no servidor ou endereços de um servidor externo. No Wyomind, a localização das imagens define-se como servidor HTTP.
Que limite tem o ficheiro de importação nativo?
O limite é definido no php.ini do servidor e a página de importação mostra o valor em vigor. Por omissão, a documentação da Adobe indica 2 MB.