Conectando o Salesforce Commerce Cloud

O Commerce Cloud B2C é a loja online da família Salesforce (a plataforma que já se chamou Demandware): pedidos, catálogo, estoque, promoções, cupons e clientes. Não confunda com o CRM — leads, oportunidades e casos são o card Salesforce, e jornadas e disparos de e-mail são o Salesforce Marketing Cloud. O B2B/D2C Commerce que roda dentro da org Lightning também fica coberto pelo card Salesforce, não por este.

A conexão é feita por credenciais: o API Client criado no Account Manager mais os identificadores da loja.

Antes de começar

• No Account Manager, crie um API Client com o papel Salesforce Commerce API para o seu tenant e permita nele os escopos sfcc.* que a Toca vai usar.
• No Business Manager › Administration › Site Development › Salesforce Commerce API Settings, anote o Organization ID, o Short Code e o Site ID da loja.
• Opcional: o host da instância, usado só para a busca de pedidos pela OCAPI. Esse caminho exige também que o client esteja permitido em Business Manager › Administration › Open Commerce API Settings (Data). Confirme os detalhes na documentação oficial da Salesforce.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Salesforce Commerce Cloud e clique em Conectar.
3. Preencha o formulário:
   • Client ID e Client Secret — do API Client do Account Manager.
   • Organization ID — no formato f_ecom_zzrf_001.
   • Short Code — ex.: kv7kzm78.
   • Site ID — ex.: RefArch.
   • Escopos SCAPI — separados por espaço, todos começando com sfcc., exatamente os permitidos no API Client.
   • Host da instância para OCAPI — opcional.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Leitura: pedidos e faturamento, produtos e catálogo, categorias, estoque por lista de inventário, promoções, campanhas, cupons e a base de clientes da loja.

A Toca também sabe alterar a loja: status, envio e cancelamento de pedido, produto e vitrine, categoria, estoque, preço, promoção, campanha, cupom, cliente e execução de jobs. Nenhuma alteração acontece sozinha: cada uma passa por sua aprovação explícita, pedido a pedido, dentro do chat.

A integração foi construída a partir da documentação oficial e ainda está em validação com as primeiras instâncias conectadas; confira números importantes no Business Manager e fale com o suporte se algo não bater.

Manutenção da conexão

As credenciais do API Client não expiram sozinhas: a conexão vale até o client ser revogado no Account Manager ou até você desconectar a integração na Toca. Alterar os escopos permitidos no API Client muda o que a conexão consegue fazer — se um escopo informado no card deixar de ser permitido, a autenticação passa a falhar até os dois lados baterem de novo.

Problemas comuns

• Erro de escopo logo após conectar — a plataforma só emite o acesso se todos os escopos informados estiverem permitidos no API Client. Confira a lista do card contra a configuração do Account Manager, item a item.
• Autentica, mas as consultas pela OCAPI respondem acesso negado — falta a entrada do client em Open Commerce API Settings (Data) no Business Manager, com os recursos e métodos liberados.
• A busca de pedidos não responde — dependendo da configuração da loja, a listagem de pedidos sai pelo caminho da OCAPI, que exige o host da instância preenchido no card. Adicione o host e tente de novo.
• Procurando leads, casos ou jornadas — este card é a loja B2C. O CRM é a integração Salesforce e o marketing é a Salesforce Marketing Cloud.