Integrar o Sales Layer com o Salesforce Commerce Cloud é usar o Sales Layer como PIM, onde o catálogo é preparado e aprovado, e o Salesforce Commerce Cloud como a loja que o publica. Na página de conectores do fornecedor, este par não consta como ligação pronta, pelo que a escolha entre ficheiros de importação e API é a primeira decisão do projeto.
Para a empresa, o interesse está em separar o trabalho de catálogo do trabalho de loja. A equipa de produto enriquece fichas num sítio e a plataforma de comércio recebe-as já prontas. Esta decisão faz parte de uma estratégia de integração de PIM com ecommerce e pesa mais em catálogos extensos, com várias lojas ou idiomas.
Neste artigo vê o que a documentação oficial diz sobre as duas plataformas, as duas formas de ligar os sistemas, que dados seguem em cada sentido, os riscos mais frequentes e uma lista de verificação para validar antes de arrancar.
Existe um conector pronto entre o Sales Layer e o Salesforce Commerce Cloud
Na lista de conectores de comércio eletrónico publicada pelo Sales Layer constam o WooCommerce, o PrestaShop, o BigCommerce, o Shopify, o Shopify Plus e o Magento. O Salesforce Commerce Cloud não consta dessa lista. Na mesma página, o fornecedor indica ligações personalizadas por API: um conector de importação, um conector à medida e um conector de aplicações.
Isto significa que o par se resolve, em regra, com trabalho à medida. Convém confirmar diretamente com o fornecedor qual das opções se adapta ao seu projeto, porque a disponibilidade de conectores pode mudar. Compare com os PIM que têm ligação mais direta, como Sales Layer com WooCommerce ou Sales Layer com PrestaShop.
As duas formas de ligar ao Salesforce Commerce Cloud
Há duas vias principais: importar ficheiros de catálogo ou chamar APIs. A primeira é mais simples e adequada a atualizações em lote; a segunda dá mais controlo e serve melhor alterações frequentes.
Na via de ficheiros, a documentação da Salesforce explica que o catálogo se importa e exporta em bloco, em XML validado pelo esquema oficial do catálogo ou em CSV. A importação por CSV só é suportada no modo de fusão. Pode fazer-se no Business Manager, em Merchant Tools, Products and Catalogs, Import and Export.
A mesma documentação descreve os modos de importação. A fusão cria o que falta e atualiza o que existe, deixando intactos os atributos que não vêm no ficheiro. A substituição também remove dados obsoletos. A atualização aplica ficheiros de diferenças a um catálogo já existente. A eliminação é definida por objeto e prevalece sobre o modo escolhido.
Um detalhe importante: a importação faz duas passagens, a primeira para criar, atualizar e eliminar objetos, a segunda para estabelecer relações. A Salesforce recomenda incluir todas as entidades de um catálogo no mesmo ficheiro XML, para que uma importação interrompida não deixe objetos órfãos.
Na via de APIs, a documentação da Salesforce indica que a API Open Commerce, conhecida por OCAPI, está agora descontinuada. Para novos projetos e grandes refações, recomenda a API de comércio B2C, conhecida por SCAPI, como API REST por defeito. Se o seu projeto já usa OCAPI, planeie a migração em vez de investir em código novo sobre ela.
Quanto a permissões, a documentação indica que cada cliente precisa de um identificador e que, por defeito, não tem nenhuma permissão. Pedidos sem as permissões adequadas recebem erro 401. As definições configuram-se no Business Manager e podem demorar até três minutos a produzir efeito.
Que dados vão em cada sentido
| Dado | Sistema mestre | Sentido |
|---|---|---|
| Atributos e descrições | Sales Layer | PIM para loja |
| Imagens e ativos | Sales Layer | PIM para loja |
| Categorias do catálogo | Sales Layer | PIM para loja |
| Preços por lista | Salesforce ou ERP | Origem para loja |
| Stock | ERP | ERP para loja |
| Encomendas | Salesforce | Loja para ERP |
Se o ERP é parte do projeto, veja como se organiza o outro lado em SAP S/4HANA com Salesforce Commerce Cloud ou em Microsoft Dynamics 365 com Salesforce Commerce Cloud.
Categorias, variantes e ativos no mapeamento
O mapeamento de categorias é onde mais projetos tropeçam. A árvore de categorias do PIM raramente coincide com a do catálogo de navegação da loja, por isso convém decidir se a loja herda a estrutura do PIM ou se mantém a sua e apenas associa os produtos. Em qualquer dos casos, as categorias têm de existir antes dos produtos que lhes pertencem.
As variantes pedem a mesma disciplina. Cada produto com combinações de tamanho ou cor deve chegar à loja com a sua estrutura completa, e as imagens devem seguir com referências estáveis, para que uma nova carga não as duplique. Registe estas regras no documento de mapeamento, porque são as primeiras que se esquecem quando a equipa muda.
Passos para integrar o Sales Layer com o Salesforce Commerce Cloud
- Decidir entre ficheiros de catálogo e API, com base na frequência das alterações.
- Confirmar com o fornecedor a opção de conector do Sales Layer para este destino.
- Fechar o mapeamento entre campos do PIM e atributos do catálogo da loja.
- Definir o modo de importação: fusão, substituição, atualização ou eliminação.
- Configurar clientes e permissões no Business Manager, se houver API.
- Testar numa instância de ensaio com uma amostra que inclua variantes e imagens.
- Fazer a carga completa e rever as diferenças um a um.
- Passar à sincronização incremental com registo de erros.
A escolha do modo de importação é uma das decisões que mais custa corrigir. A substituição remove dados que não vêm no ficheiro, e se o ficheiro estiver incompleto, a loja perde produtos que ainda deviam estar lá.
Riscos mais comuns
| Risco | Sinal | Prevenção |
|---|---|---|
| Modo de substituição indevido | Produtos que desaparecem | Usar fusão na fase inicial |
| Ficheiro incompleto | Relações em falta | Catálogo completo num XML |
| Permissões em falta | Erro 401 nos pedidos | Configurar clientes primeiro |
| Código sobre OCAPI | Dependência descontinuada | Planear a migração |
| Dados duplicados | Dois mestres de preço | Um sistema mestre por dado |
O risco de SEO também merece atenção. Se a carga alterar títulos, descrições ou endereços de produtos já indexados, a loja pode perder posições sem aviso. Decida antes quais campos o PIM controla e proteja os que já estão otimizados.
Lista de verificação antes de arrancar
- a via de integração está decidida e confirmada com o fornecedor do PIM
- o modo de importação foi escolhido e testado numa instância de ensaio
- o catálogo completo segue no mesmo ficheiro quando se usa XML
- os clientes e permissões da API estão configurados com o mínimo necessário
- o plano não depende de OCAPI para código novo
- o mapeamento cobre variantes, categorias e imagens
- os endereços e títulos otimizados existentes estão protegidos
- há um responsável por rever os erros de cada carga
Se não consegue responder afirmativamente a mais de duas destas perguntas, falta preparação. É preferível resolvê-las antes da primeira carga, porque corrigir um catálogo já publicado é bem mais caro.
Como trabalhamos na Avafa
Começamos por decidir a via de ligação e o modo de importação, e só depois mapeamos os campos. Testamos sempre em ambiente de ensaio com uma amostra real e documentamos o que cada carga faz. Conheça a nossa agência especializada em integrações de catálogos e o trabalho de SEO para Salesforce Commerce Cloud que acompanha o catálogo depois da ligação.
Perguntas frequentes
O Sales Layer tem um conector oficial para o Salesforce Commerce Cloud?
Na página de conectores consultada não consta. O fornecedor indica ligações personalizadas por API, pelo que convém confirmar com ele a opção adequada ao projeto.
Devo usar ficheiros ou API?
Para atualizações em lote pouco frequentes, os ficheiros são mais simples. Para alterações frequentes e controlo fino, a API é mais adequada.
A API OCAPI ainda se pode usar?
A documentação da Salesforce indica que está descontinuada e recomenda a SCAPI para novos projetos. Quem já a usa deve planear a migração.
Que modo de importação devo escolher?
Na fase inicial, a fusão é o mais seguro, porque não remove dados em falta. A substituição só deve ser usada com o ficheiro completo validado.
Posso importar o catálogo em CSV?
Pode, mas a documentação indica que o CSV só é suportado no modo de fusão. Para os restantes modos é necessário usar XML.