Integrar o Bluestone PIM com o Salesforce Commerce Cloud (SFCC) significa tornar o PIM a origem do dado de produto e o SFCC o sítio onde esse dado é vendido. Na consulta que fizemos a 31-10-2026, o Extension Hub da Bluestone PIM listava conectores para Adobe Commerce, commercetools, Shopify e BigCommerce, mas nenhum para o Salesforce Commerce Cloud. A integração é possível, mas passa por APIs e middleware, não por um conector pronto.
Para uma empresa com catálogo extenso, a diferença é grande. Um conector pronto reduz prazo e risco; uma integração à medida exige desenho, testes e manutenção. Saber isto antes de orçamentar evita surpresas, e é o tipo de decisão que tratamos na nossa área de integração de PIM com e-commerce.
Este guia resume o que as fontes oficiais da Bluestone PIM e da Salesforce confirmam, apresenta três formas de ligar os dois sistemas, descreve os riscos e termina com uma checklist de trabalho.
O que confirmam as fontes oficiais?
A API pública da Bluestone PIM é só de leitura: segundo a sua documentação, serve grandes volumes de dados a muitos sistemas e não oferece endpoints de manutenção de dados. Permite obter produtos por identificador ou por categoria, pesquisar produtos por vários filtros, listar categorias, atributos e relações, e devolver os dados num contexto, que é normalmente um idioma.
Os produtos só aparecem na API depois de publicados no PIM. A API tem um endpoint de sincronizações, que lista eventos de sync e se pode filtrar por data, e endpoints de diferenças, que mostram o que foi criado, atualizado ou removido num dado sync. A documentação refere também webhooks para avisar quando uma sincronização termina. O formato JSON pode mudar de forma compatível, pelo que a Bluestone recomenda o padrão Tolerant Reader.
Do lado da Salesforce, a Salesforce Commerce API (SCAPI) divide-se em APIs de comprador, para navegação, cesto e checkout, e APIs de administração, para gestão de produtos, encomendas, inventário e clientes. O Composable Storefront, composto pelo PWA Kit e pelo Managed Runtime, assenta na SCAPI. Num storefront SFRA, a loja comunica diretamente com a instância.
A Bluestone PIM afirma, na sua página de APIs, que tem mais de 700 endpoints e uma arquitetura headless. Trata-se de uma declaração do fornecedor; o que interessa ao projeto é que a leitura de produtos, categorias e diferenças esteja documentada.
Como ligar o Bluestone PIM ao SFCC?
Há três abordagens possíveis, e a tabela compara-as de forma resumida.
| Abordagem | Como funciona | Vantagem | Risco |
|---|---|---|---|
| Plataforma de integração (iPaaS) | Fluxos entre as duas APIs | Menos código | Custo recorrente |
| Integração à medida | Código lê diferenças e escreve | Controlo total | Manutenção própria |
| Via ERP ou sistema central | PIM e SFCC ligados ao ERP | Uma só fonte | Atrasos e dependências |
Na primeira abordagem, uma plataforma de integração liga as duas APIs. O Extension Hub da Bluestone PIM lista a Patchworks como plataforma de integração para e-commerce, mas a página não indica se há suporte específico para o SFCC, pelo que isso deve ser confirmado com o fornecedor. Na segunda, um serviço próprio lê os endpoints de sincronizações e de diferenças do PIM e escreve no SFCC pelas APIs de administração. É a opção mais flexível e a que exige mais manutenção.
A terceira faz sentido quando o ERP já alimenta o SFCC e o PIM serve apenas para enriquecer. Nesse caso, o risco é a duplicação: o mesmo atributo pode ser definido no ERP e no PIM, e é preciso decidir qual vence.
O que deve ser mapeado entre o PIM e o SFCC?
Deve mapear-se tudo o que o cliente vê na página de produto, e o que o motor de pesquisa lê. Em regra, são quatro grupos de dados: identificação, conteúdo, estrutura e ativos.
- Identificação: identificador do PIM, SKU e referência do fabricante.
- Conteúdo: nome, descrição e atributos técnicos, por idioma.
- Estrutura: categorias, variantes e relações entre produtos.
- Ativos: imagens e documentos associados a cada produto.
Cada campo precisa de um destino no SFCC, de uma regra de transformação e de um dono. Os campos sem destino devem ficar registados, para que ninguém assuma que foram migrados. As categorias merecem atenção especial, porque a árvore do PIM costuma refletir a organização interna da empresa, enquanto a do SFCC deve refletir a forma como o cliente procura.
Convém também testar o que acontece quando um produto muda de categoria ou perde um atributo. Esses casos raros são os que mais geram erros em produção, e só aparecem se o piloto incluir exceções de propósito.
Que riscos tem esta integração?
- Ausência de conector: sem conector oficial, o prazo e o custo dependem de desenvolvimento ou de middleware.
- Fluxo num só sentido: a API pública do PIM é de leitura, pelo que a escrita no SFCC tem de ser feita por outro componente.
- Modelo de dados: os atributos e categorias do PIM nem sempre correspondem à estrutura de catálogos do SFCC; é preciso um mapa explícito.
- Idiomas: o PIM devolve dados por contexto, e cada idioma tem de ser ligado ao site ou ao mercado correspondente.
- Produto não publicado: um produto que não foi publicado no PIM não chega à API, o que pode parecer um erro do SFCC.
- Mudanças no formato: a documentação avisa que o JSON pode evoluir, e o código deve tolerar campos novos.
Muitas destas falhas são visíveis para o cliente e para o Google. Um atributo em falta ou uma descrição duplicada afeta a página de produto, o que é um assunto da nossa agência de SEO para Salesforce Commerce Cloud.
Checklist Avafa para ligar PIM e SFCC
Estes são os passos que seguimos antes de escrever uma linha de código:
- Confirmar com a Bluestone PIM e com a Salesforce o que há de conector, middleware e suporte para este par.
- Definir o âmbito: só dados de produto, ou também ativos, preços e stock.
- Mapear cada atributo do PIM para um campo do SFCC e marcar o que não tem destino.
- Escolher o identificador comum de produto e validar que é único.
- Decidir a abordagem da tabela anterior e registar o motivo.
- Definir como se distinguem criações, atualizações e remoções, usando as diferenças de sync do PIM.
- Testar com um conjunto pequeno de produtos, incluindo variantes e idiomas.
- Combinar alertas, responsáveis e o que se faz quando uma sincronização falha.
O sexto passo evita o erro mais comum: reenviar o catálogo inteiro a cada sincronização, o que torna o processo lento e difícil de depurar.
Como trabalhamos na Avafa
Na Avafa começamos pelo catálogo, não pela ferramenta. Auditamos atributos, identificadores e regras de publicação, e só depois propomos a abordagem de ligação. Tudo o que a documentação não confirma fica escrito como pergunta ao fornecedor.
Se o seu projeto liga um PIM a uma loja, conheça o nosso serviço de integração de PIM com e-commerce.
Guias relacionados
- Integrar o AEM com Salesforce Commerce Cloud
- Integrar SAP S/4HANA com Salesforce Commerce Cloud
- Integrar Microsoft Dynamics 365 com Salesforce Commerce Cloud
- Integrar SAP Business One com Salesforce Commerce Cloud
- Integrar Odoo com Salesforce Commerce Cloud
Perguntas frequentes
A Bluestone PIM tem um conector para o Salesforce Commerce Cloud?
Na consulta de 31-10-2026, o Extension Hub não listava nenhum conector para o Salesforce Commerce Cloud. Convém confirmar com a Bluestone PIM se houve novidades.
A API da Bluestone PIM permite escrever dados?
A API pública descrita na documentação é só de leitura e não tem endpoints de manutenção de dados. A escrita no SFCC tem de ser feita por outro componente.
Como sei o que mudou entre duas sincronizações?
A API tem um endpoint de sincronizações e endpoints de diferenças, que mostram as entidades novas, atualizadas ou removidas para um dado sync.
Que API da Salesforce se usa para gerir produtos?
A Salesforce descreve APIs de administração na SCAPI para gestão de produtos, encomendas, inventário e clientes. O desenho concreto depende do projeto e da versão em uso.
Um produto não publicado no PIM chega ao SFCC?
Não pela API pública: os produtos só aparecem depois de publicados no PIM. Por isso o estado de publicação deve fazer parte da checklist.