Integrar o Sales Layer com o PrestaShop é instalar o módulo do Sales Layer na loja, ligá-lo a um canal do PIM com um ID de conector e uma chave privada, e deixar que as tarefas agendadas (cron) do PrestaShop tragam as alterações do catálogo. O Sales Layer indica que o conector sincroniza as mudanças feitas desde a última atualização.
Para a empresa, o ganho é ter um só local onde o catálogo é escrito, revisto e enviado para a loja. O risco está no que não se vê: cron mal agendado, campos mapeados sem necessidade ou alterações que desativam produtos sem aviso. Na Avafa fazemos estas ligações dentro da nossa área de integração de PIM com ecommerce.
Este guia explica o que o conector sincroniza, como se liga, como agendar a sincronização, que cuidados ter com os dados e como validar a qualidade do catálogo antes de entrar em produção.
O que sincroniza o conector do Sales Layer para PrestaShop?
Segundo a página do conector, sincroniza o catálogo de produtos, títulos em várias línguas, características e variantes, etiquetas, preços, descontos, portes e packs, imagens com atributos ALT, fornecedores e fabricantes, produtos relacionados e redirecionamentos de produtos desativados.
Pode atualizar uma ou várias lojas PrestaShop e trabalha com várias línguas. O Sales Layer acrescenta funções de qualidade: um indicador de qualidade das fichas, ficheiros de diagnóstico para detetar problemas e análise de dados em massa com conversão de ficheiros de vários formatos.
A documentação consultada não indica as versões do PrestaShop suportadas. Pede apenas que confirme que a versão do módulo é compatível com a da sua loja. Confirme isso antes de planear datas.
Quando faz sentido ligar o PIM à loja?
Faz sentido quando o catálogo muda com frequência ou tem muitos atributos, e a edição manual no PrestaShop gera erros. Não faz sentido, por agora, com poucos produtos estáveis e uma só equipa a editá-los.
Sinais de que está na hora:
- as fichas são preparadas em folhas de cálculo e coladas na loja;
- as características e variantes diferem entre produtos parecidos;
- as imagens perdem o texto alternativo ao serem carregadas à mão;
- a mesma informação alimenta mais do que um canal de venda.
Se a origem do dado é o ERP, o desenho deve incluir os dois sistemas. Veja como tratamos a ligação do Odoo ao PrestaShop e a do A3ERP ao PrestaShop.
O que preparar antes de instalar?
É preciso um ambiente PrestaShop pronto, o módulo do Sales Layer e as tarefas cron do PrestaShop configuradas e a funcionar antes da primeira sincronização. A documentação do Sales Layer estabelece estes três requisitos.
A ajuda acrescenta recomendações que seguimos à letra:
- fazer uma exportação de todos os produtos, se a loja já estiver ativa;
- testar num ambiente com os mesmos plugins externos da produção, antes de ligar a loja real;
- ter quem implementa com acesso ao servidor de produção e conhecimento da configuração;
- começar com uma amostra pequena de dados para acelerar os testes.
Quanto a prazos, a mesma página diz que o arranque pode levar de um dia a três meses, consoante a preparação dos dados, as personalizações, o servidor e a experiência de quem implementa. É um intervalo largo e honesto; desconfie de quem lhe promete datas sem ver o catálogo.
Como se liga o conector passo a passo?
- Instalar o módulo do Sales Layer no PrestaShop, seguindo as instruções da documentação.
- No Sales Layer, preparar o canal e copiar as credenciais: o ID do conector e a chave privada.
- No módulo do PrestaShop, criar um novo conector e colar as credenciais.
- Clicar em guardar o conector.
- Verificar se o novo canal aparece na página de canais: se o ID e a chave estiverem certos, aparece.
- Agendar a sincronização através do módulo de tarefas cron do PrestaShop.
Se algum dos dados estiver errado, o canal não aparece. Reveja primeiro as credenciais e só depois procure causas mais complexas.
Com que frequência agendar a sincronização?
A recomendação do Sales Layer é de 5 minutos. Se o cron já estiver ocupado com outras tarefas, qualquer intervalo entre 1 e 30 minutos serve.
| Situação | Intervalo |
|---|---|
| — | — |
| Cron dedicado | 5 minutos |
| Cron partilhado | 1 a 30 minutos |
| Mais de 24 horas | Hora preferida |
Para intervalos superiores a 24 horas, passa a estar disponível uma hora preferida, por exemplo as 3h da manhã. O endereço da tarefa do módulo encontra-se no módulo de tarefas cron do PrestaShop e tem de estar ativo e acessível, com a loja ativa num domínio disponível.
Há um comportamento que tranquiliza: se o servidor estiver sobrecarregado, a sincronização pausa e retoma na execução seguinte do cron, e o site continua a funcionar normalmente. O módulo ajusta também o tempo entre execuções, em função do tempo desde a última.
Que cuidados ter com os dados e as regras?
A regra de ouro, segundo a documentação, é gerir a informação de produto no Sales Layer e não no PrestaShop. A exceção é o stock, que deve ser atualizado diretamente na loja.
Há avisos que merecem atenção:
- Depois de ligado, todas as alterações do Sales Layer são enviadas para a loja.
- A API envia todas as alterações, mesmo as que ficam fora dos filtros do conector. Editar um produto invisível ou em rascunho pode fazê-lo chegar como apagado, e a loja desativa o item.
- Personalizar tabelas por defeito do PrestaShop, por exemplo apagar uma coluna ou tabela, pode quebrar a ligação.
- Desinstalar o módulo remove todas as ligações entre itens do Sales Layer e do PrestaShop. Ao reinstalar, algumas alterações, como passar um produto a rascunho ou invisível, não se refletem.
- Para atualizar versões, atualize o módulo em vez de o desinstalar.
O segundo ponto é o que mais surpreende as equipas. Antes de mexer em produtos ocultos, confirme os filtros do conector.
Que campos mapear e o que desligar?
Mapeie só o que usa. A documentação de funcionalidades não suportadas indica que os campos criados por terceiros não podem ser mapeados e que os campos pré-definidos sem uso devem ser desligados.
Evite também carateres especiais nos campos de referência, nome e nome da imagem. Parecem pormenores, mas são a origem de erros de associação difíceis de explicar a quem edita as fichas.
Uma regra nossa: antes de ligar, imprima a lista de campos mapeados e peça a quem gere o catálogo que confirme, campo a campo, qual é a origem e se alguma edição manual na loja é suposto continuar.
Como validar a qualidade antes de ir para produção?
Use os instrumentos que o próprio Sales Layer oferece: o indicador de qualidade, para ver fichas incompletas, e os ficheiros de diagnóstico, para detetar problemas. Corrija no PIM e volte a sincronizar a amostra.
Depois, compare no PrestaShop:
- se as variantes e características chegaram completas;
- se os preços e descontos coincidem com o PIM;
- se as imagens têm o texto alternativo;
- se os produtos desativados redirecionam para o sítio certo;
- se os URL se mantêm iguais aos atuais.
O ponto 5 liga-se ao SEO. Uma sincronização que mude URL sem redirecionamentos pode custar tráfego, e convém tratá-lo com quem cuida do posicionamento da loja.
Como trabalhamos na Avafa
Começamos por rever o catálogo e o PrestaShop: módulos, personalizações, atributos e URL. Depois configuramos o canal num ambiente de ensaio, ligamos uma amostra e só passamos à produção com os dados validados e o cron estável. O trabalho integra-se na nossa integração de PIM com ecommerce.
Se vai comparar PIM, veja o Plytix com PrestaShop. Para ligar o ERP, temos o Sage 200 com PrestaShop. E se a sua loja é WordPress, o guia de Sales Layer com WooCommerce mostra o equivalente.
Perguntas frequentes
Qual é a frequência de sincronização recomendada?
Cinco minutos. Se o cron já tem outras tarefas, qualquer intervalo entre 1 e 30 minutos serve.
O conector sincroniza o stock?
O stock deve ser atualizado diretamente no PrestaShop, segundo a documentação. O restante catálogo gere-se no Sales Layer.
O que acontece se desinstalar o módulo?
Remove-se todas as ligações entre itens do Sales Layer e do PrestaShop. Para atualizar versões, atualize o módulo em vez de o desinstalar.
Porque é que um produto ficou desativado?
Pode ter sido editado no Sales Layer fora dos filtros do conector, por exemplo um produto invisível ou em rascunho, e ter chegado como apagado.
O conector suporta várias lojas e línguas?
Sim. Pode atualizar uma ou várias lojas e trabalha com várias línguas.
Posso mapear campos criados por um módulo de terceiros?
Não. Segundo a documentação, os campos criados por terceiros não podem ser mapeados.
Quanto tempo demora o projeto?
De um dia a três meses, segundo a ajuda do Sales Layer, consoante os dados, as personalizações e o servidor. Só se estima depois de ver o catálogo.