Integrar o Sales Layer com o WooCommerce é ligar um PIM, onde o catálogo é tratado e validado, a uma loja WordPress através de um plugin que importa produtos, categorias e variantes. O Sales Layer disponibiliza o conector como plugin de código aberto, que se instala no WooCommerce e fica a ler as alterações feitas no PIM.
Para a empresa, isto quer dizer um só sítio onde se escreve cada ficha de produto. Quando o catálogo cresce, deixar de repetir descrições e imagens na loja poupa tempo e reduz erros. Na Avafa fazemos estas ligações dentro da nossa área de integração de PIM com ecommerce, e este guia reúne o que decidir antes de começar.
Vai ver o que o conector exige, como se configura, como se comporta na primeira sincronização e que limitações tem, sobretudo em lojas com vários idiomas.
Quando faz sentido ligar o Sales Layer ao WooCommerce?
Faz sentido quando o catálogo tem muitos atributos, variantes ou canais, e a edição manual no WordPress já provoca inconsistências. Não faz sentido, por agora, com poucos produtos que quase não mudam.
Alguns sinais de que o PIM compensa:
- as fichas são copiadas de folhas de cálculo para o WooCommerce;
- a mesma informação tem de ser mantida em mais do que uma loja ou marketplace;
- as variantes são criadas à mão e saem diferentes de produto para produto;
- a equipa perde tempo a corrigir nomes, referências e imagens.
Se o dado de origem está no ERP, a ligação com o ERP deve ser pensada em conjunto. Veja, por exemplo, como tratamos a ligação do Odoo ao WooCommerce.
O que é preciso antes de instalar o conector?
É preciso um WordPress com o WooCommerce instalado, o plugin do Sales Layer e as tarefas agendadas (cron) do WooCommerce a funcionar. Segundo a documentação do Sales Layer, os cron jobs têm de estar operacionais antes da primeira sincronização.
Em instalações Multisite, a documentação pede que as tarefas sejam acionadas a partir do site principal, para evitar processamento duplicado.
Outro ponto de ordem: o canal tem de existir primeiro no Sales Layer. Só depois se adiciona o conector na loja, e a opção Sales Layer tem de aparecer no menu do WooCommerce antes dessa fase.
Como se cria o canal passo a passo?
O percurso base, segundo a ajuda do Sales Layer, é este:
- Instalar o plugin do Sales Layer no WooCommerce, a partir do repositório indicado na documentação, confirmando que a versão é compatível com a sua loja.
- Confirmar que a opção Sales Layer aparece no menu do WooCommerce.
- No Sales Layer, abrir Canais e escolher o separador do marketplace de canais.
- Localizar o conector do WooCommerce e criar o canal.
- Adicionar o conector na loja, mapear os campos e testar com um grupo pequeno de produtos.
O teste com amostra poupa dissabores: a ajuda do Sales Layer recomenda começar com uma pequena amostra de dados para confirmar que o conector funciona.
O que acontece na primeira sincronização?
O conector não apaga o que já existe na loja. Primeiro tenta associar os itens pelas relações de ID existentes; se não houver, procura por referência ou nome, desde que o item não esteja ligado a outro ID do Sales Layer. O que não for encontrado é criado.
Isto significa que não precisa de apagar produtos antes. Mas significa também que referências repetidas ou nomes duplicados na loja podem gerar associações erradas. Por isso limpe duplicados antes da primeira ligação.
Sobre tempos, a ajuda indica uma ordem de grandeza: numa instalação limpa, cerca de 0,5 a 1,5 segundos por categoria e respetivas variantes, e de 1 a 3 segundos por produto na criação. As atualizações são mais rápidas e saltar o processamento de imagens acelera o processo. São valores indicativos; o tempo real depende dos recursos do servidor e do volume.
Quem manda em cada dado?
A regra da documentação é clara: gerir a informação de produto no Sales Layer e não no WooCommerce, porque as edições feitas diretamente na loja não voltam ao PIM. A exceção é o stock, que convém atualizar no WooCommerce.
Esta divisão é a base do nosso quadro de responsabilidades:
| Dado | Onde se edita | Observação |
|---|---|---|
| — | — | — |
| Nome e descrição | Sales Layer | Não editar na loja |
| Imagens e ficheiros | Sales Layer | Ver regras abaixo |
| Atributos e variantes | Sales Layer | Referência única |
| Stock | WooCommerce | Exceção indicada |
| Preços | Definir à partida | Depende do ERP |
O último ponto é uma decisão de projeto: se os preços vêm do ERP, devem ter um sistema mestre claro antes de ligar o PIM, porque o conector não resolve conflitos entre duas origens.
Como tratar imagens e ficheiros?
As imagens são descarregadas e associadas à imagem principal do produto e à galeria. Os ficheiros, como PDF, ligam-se a atributos, que não têm galeria nem acesso à biblioteca de multimédia; por isso são tratados como texto, ou seja, ficam como ligação. O mesmo acontece com imagens colocadas em atributos.
Na prática, uma ficha técnica em PDF aparece como ligação para o ficheiro e não como anexo na biblioteca do WordPress. Convém saber isto antes de prometer à equipa de marketing um comportamento diferente.
O que fazer com várias línguas e várias lojas?
O WooCommerce não suporta, por defeito, várias línguas nem várias lojas, e o conector não foi pensado para plugins de terceiros nessa área. A ajuda do Sales Layer indica duas opções: um canal por língua ou por instalação, ou uma solução à medida com um parceiro integrador.
Uma instalação com várias línguas partilha a mesma informação de produto em todas elas. E o WPML não é compatível com o conector, segundo a documentação, porque os plugins de tradução trariam manutenção adicional a cada versão do WooCommerce.
Se a sua loja portuguesa vende também noutros mercados, decida isto cedo. Mudar a arquitetura de línguas depois de importar milhares de produtos é caro. A nossa agência de SEO para WordPress acompanha esta decisão do lado da estrutura de URL e da indexação.
Que riscos tem a sincronização?
Os riscos principais, todos referidos na documentação do Sales Layer, são estes:
- Depois de ligado, todas as alterações do Sales Layer fluem para a loja.
- A API envia todas as alterações, mesmo as que ficam fora dos filtros do conector. Se o conector exporta só itens visíveis e se edita um produto oculto ou em rascunho, esse item chega como apagado e fica desativado no WooCommerce.
- Itens apagados no Sales Layer ficam invisíveis na sincronização seguinte.
- Personalizar tabelas por defeito do WooCommerce, como remover colunas, pode quebrar a ligação.
- O erro “O SKU já está em uso” aparece normalmente por conflitos de ID de sincronizações anteriores ou por SKU partilhados entre empresas.
O segundo ponto merece atenção. Quem usa filtros por visibilidade deve rever as regras antes de mexer em produtos em rascunho.
Lista de verificação antes de ligar a produção
- Cópia de segurança (exportação) de todos os produtos atuais.
- Ambiente de ensaio com os mesmos plugins da loja real.
- Cron do WooCommerce a funcionar, e acionado do site principal em Multisite.
- Referências únicas e sem duplicados na loja.
- Decisão tomada sobre línguas: um canal por língua ou solução à medida.
- Quem implementa tem acesso ao servidor de produção e conhece a configuração.
- Filtros do conector revistos para não desativar itens por engano.
A ajuda do Sales Layer indica que o tempo de arranque vai 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. E acrescenta que o Sales Layer não presta serviços de consultoria ou integração; esses fazem-se através de parceiros especializados, sob acordos separados.
Como trabalhamos na Avafa
Começamos pela auditoria do catálogo e do WooCommerce: plugins instalados, estrutura de categorias, variantes e URL. Depois montamos o canal num ambiente de ensaio, importamos uma amostra, validamos e só então passamos à produção. Todo o trabalho enquadra-se na nossa integração de PIM com ecommerce.
Se ainda não escolheu o PIM, compare com a integração do Plytix com o WooCommerce. Se o catálogo nasce no ERP, veja o A3ERP com WooCommerce ou o SAP S/4HANA com WooCommerce. Para outra plataforma, temos o guia de Sales Layer com PrestaShop.
Perguntas frequentes
O conector apaga os produtos que já tenho no WooCommerce?
Não. Os itens existentes não são apagados nem precisam de ser apagados antes. O conector associa-os por ID, referência ou nome.
As alterações feitas no WooCommerce voltam ao Sales Layer?
Não. Por isso a informação de produto deve ser gerida no Sales Layer. A exceção recomendada é o stock.
Posso usar o WPML com o conector?
Segundo a documentação, o WPML não é compatível. Para várias línguas, use um canal por língua ou uma solução à medida com um parceiro.
Porque aparece o erro de SKU já em uso?
Costuma ser um conflito de ID de sincronizações anteriores em que os itens não foram apagados, ou SKU partilhados. Apagar esses SKU no WooCommerce e sincronizar de novo gera novos IDs.
Porque é que o PDF aparece como ligação e não como anexo?
Porque os ficheiros ligam-se a atributos, que não têm acesso à biblioteca de multimédia, e são tratados como texto.
As funcionalidades mudam com o tipo de conta do Sales Layer?
Não. A documentação indica que o conector oferece as mesmas funcionalidades independentemente do tipo de conta.
Quanto tempo demora o projeto?
Depende dos dados, das personalizações e do servidor. Só se estima depois do mapeamento e da lista de verificação preenchidos.