Integrar o Sales Layer com o Magento é instalar o plugin do Sales Layer na loja, criar um canal no PIM e deixar que o plugin importe categorias, produtos e variantes. O catálogo deixa de ser editado no Magento e passa a ser preparado no PIM.
Para a empresa, o valor está na consistência: os mesmos atributos, nomes e imagens em todas as fichas, sem copiar dados à mão. O risco está no arranque: um plugin mal instalado, um cron parado ou atributos que não existem na loja bloqueiam a primeira importação. Na Avafa fazemos estas ligações dentro da nossa área de integração de PIM com ecommerce.
Neste guia vê as duas vias de instalação, o passo a passo do plugin, as regras de modelo de dados e as limitações que convém conhecer antes de começar.
Que plugin usar: Magento ou Adobe Commerce?
Depende da edição da loja. Segundo a documentação do Sales Layer, a edição gratuita do Magento e a edição Enterprise têm cada uma o seu plugin, com ligação de descarga e instruções próprias.
| Edição da loja | Plugin | Instalação |
|---|---|---|
| — | — | — |
| Magento gratuito | Plugin para a edição gratuita | Cópia para app/code |
| Adobe Commerce | Extensão Enterprise | Composer (série 2.7) |
Este artigo foca o plugin do Magento. Se a sua loja é Adobe Commerce, a instalação por Composer, as versões de PHP e a tabela de compatibilidade estão no nosso guia de Sales Layer com Adobe Commerce.
O que é preciso antes de instalar?
É preciso um Magento já instalado, a extensão cURL do PHP e as tarefas agendadas (cron) do Magento configuradas e operacionais. A documentação do Sales Layer é explícita: sem cron a funcionar, a primeira sincronização não deve ser feita.
Se ainda não tem a loja montada, a ajuda remete para o guia de instalação local da Adobe. E se a loja tem personalizações ou plugins de terceiros, a documentação adverte que podem existir limitações de suporte e de requisitos que um implementador terá de resolver para o plugin funcionar como esperado.
Como se instala o plugin passo a passo?
- Descarregar a versão mais recente do plugin, a partir da ligação da documentação para o seu tipo de conta.
- Confirmar que a extensão cURL do PHP está instalada.
- Se existir uma versão anterior, apagar a pasta completa do plugin antes de instalar. A documentação avisa que atualizar por cima pode trazer os mesmos problemas de uma instalação nova.
- Descompactar o módulo e copiar a pasta Saleslayer para app/code, na raiz do Magento.
- Executar, na raiz,
php bin/magento setup:upgrade. - Executar
php bin/magento setup:di:compile. Se aparecer um erro sobre a pasta var/di, apague-a e repita. - Executar
php bin/magento setup:static-content:deploye depoisphp bin/magento cache:clean.
Depois da instalação, o plugin aparece no menu lateral, por baixo da secção Clientes. Faça este processo primeiro num ambiente de ensaio e só depois na loja real.
Como se cria o conector no Sales Layer?
No Sales Layer, abra a secção Canais e escolha o conector do Magento no separador do marketplace de canais. No separador de parâmetros, atribua uma nova chave privada, continue, guarde e conclua.
Guarde o código de ID e as chaves privadas do canal: são necessários para a configuração do lado do Magento. Trate-os como credenciais, com acesso restrito a quem faz a implementação.
Como definir o modelo de dados?
O modelo de dados é o mapa entre os campos do Sales Layer e os atributos do Magento. A regra mais importante da documentação: o conector não cria campos; os atributos personalizados têm de existir no Magento antes de os mapear.
O processo que seguimos tem três fases:
- Listar os atributos do catálogo no PIM e os atributos existentes no Magento.
- Criar no Magento os que faltam, com o tipo certo (texto, lista, número).
- Só então mapear, começando pelos campos pré-definidos e deixando os personalizados para o fim.
Este trabalho de preparação é o que mais pesa no prazo. A ajuda do Sales Layer para outros conectores, como o PrestaShop e o WooCommerce, indica que a preparação dos dados e as personalizações podem fazer variar o arranque de um dia a três meses; é uma ordem de grandeza útil, mas não um prazo para o Magento.
O que o conector suporta e o que não suporta
Segundo a página de funcionalidades suportadas do conector Magento:
- Suporta: enviar o catálogo completo de produtos, categorias e variantes.
- Suporta: uma língua por conector. Para várias línguas, cria-se um conector por língua.
- Não suporta: produtos agrupados em pacote (bundles).
- Não suporta: produtos descarregáveis.
- Não suporta: criar campos a partir do conector.
- Atenção: remover uma coluna ou tabela, manualmente ou através de um plugin externo, pode quebrar a ligação com o Sales Layer.
O último ponto é o mais traiçoeiro em lojas com muitas extensões instaladas. Antes de instalar o plugin, faça o inventário dos módulos que alteram tabelas de produto.
Como testar a importação?
Teste com um grupo pequeno de produtos e com os cenários difíceis: um produto com variantes, outro sem imagens e outro com atributos em falta. Depois compare, campo a campo, a ficha no PIM com a ficha no Magento.
Valide em cada teste:
- se as categorias chegam na árvore certa;
- se as variantes ficam ligadas ao produto pai;
- se os atributos têm o valor esperado e o tipo certo;
- se as imagens aparecem pela ordem pretendida;
- se o URL do produto mantém a estrutura atual da loja.
O último ponto interessa ao SEO. Uma importação que altere os URL sem plano de redirecionamentos custa tráfego. A nossa agência de SEO para Magento revê esta parte em conjunto com o mapeamento.
Como monitorizar a sincronização?
Verifique regularmente se o cron corre e se as alterações feitas no PIM chegam à loja no tempo esperado. Quando algo falha, comece pelos mesmos três suspeitos: o cron parado, um atributo inexistente ou uma personalização que alterou as tabelas.
Na ajuda do Sales Layer para PrestaShop e WooCommerce, outros dois conectores, a recomendação é gerir a informação de produto no PIM e não na loja, com o stock como exceção, e testar num ambiente que repita os plugins de produção. A página do Magento não repete estes pontos, mas aplicamo-los por prática.
Lista de verificação antes da produção
- Edição do Magento identificada e plugin correto descarregado.
- cURL ativo e cron operacional.
- Versão anterior do plugin removida, se existir.
- Atributos personalizados criados no Magento.
- Número de conectores definido, um por língua.
- Pacotes e produtos descarregáveis planeados fora do conector.
- Teste feito num ambiente de ensaio com amostra pequena.
- Cópia de segurança do catálogo atual.
Como trabalhamos na Avafa
Começamos por inventariar a loja: edição, módulos instalados, atributos e URL. Depois preparamos o modelo de dados, instalamos o plugin num ambiente de ensaio e validamos uma amostra antes de qualquer importação em massa. Tudo isto faz parte da nossa integração de PIM com ecommerce.
Se está a comparar PIM para Magento, veja o Plytix com Magento, o Bluestone PIM com Magento e o Brandfolder com Magento. Para a origem do dado no ERP, temos o guia de Odoo com Magento.
Perguntas frequentes
Preciso de apagar a versão antiga do plugin antes de atualizar?
Sim. A documentação indica apagar a pasta completa da versão anterior, porque atualizar por cima pode trazer os mesmos problemas de uma instalação nova.
Onde aparece o plugin depois de instalado?
No menu lateral do Magento, por baixo da secção Clientes.
O conector cria atributos novos no Magento?
Não. Os campos personalizados têm de existir antes de serem mapeados.
Posso ter a loja em várias línguas?
Sim, com um conector por língua, porque cada conector trabalha uma língua.
O conector envia pacotes ou produtos descarregáveis?
Não. Nenhum dos dois é suportado pelo conector do Magento.
O que fazer se aparecer um erro sobre a pasta var/di?
Segundo a documentação, apague essa pasta e execute de novo o comando de compilação.
Quanto tempo demora o projeto?
Depende dos dados e das personalizações da loja. Só se estima depois de ver o modelo de dados e o ambiente de ensaio.