Pular para o conteúdo principal

​
Preferências Personalizadas do Site

Após a importação de metadados, vá em BM > Merchant Tools > Site Preferences > Custom Preferences. image.png Selecione Kleep: image.png
PreferênciaDescrição
kleepRetailerUUIDObrigatório. Identificador único do seu varejista na plataforma Kleep, fornecido pelo seu Account Manager do Kleep. Deve ser inserido manualmente — é enviado em cada chamada de API do Kleep e usado como parâmetro domain do iframe de Recomendação para resolver sua conta. Sem fallback automático: se deixado vazio, o rastreamento, o recurso de Recomendação e o iframe não funcionarão (um erro de configuração é gerado).
isKleepRecommendationEnabledAtivar/desativar o botão Kleep na PDP. Não afeta o rastreamento ou as exportações de jobs.
kleepButtonColorCor do botão (Preto ou Branco). Substitua via CSS para estilização personalizada.
kleepFontFamilyFamília de fontes para o botão Kleep e iFrame.
kleepCountryCodeCódigo de Mercado / País (ISO 3166 A-2).

​
Serviços

Encontrado em Administration > Operations > Services: image.png kleep.sftp — Envia arquivos de exportação do SFCC WebDAV para o SFTP do Kleep. Substitua o usuário pelo fornecido pelo Kleep, juntamente com o certificado .p12. Não defina nenhuma senha. image.png kleep — Usado para todos os outros recursos. Não é necessário usuário/senha — a requisição é autenticada pela preferência de site kleepRetailerUUID, enviada no payload de cada chamada de API do Kleep para resolver sua conta.

​
Chave Privada e Certificado

Vá em Administration > Operations > Private Keys and Certificates:
  1. Clique em Import
  2. Clique em Select e escolha o arquivo .p12 fornecido pelo Kleep
  3. Use kleep como alias
  4. Clique em Save
image.png O resultado deve ser assim — deve ser válido e nomeado kleep: image.png

​
Jobs de Exportação

Vá em Administration > Operations > Jobs. Dois jobs são pré-configurados:
  • KleepExportProductsCSV — exporta os produtos do seu site
  • KleepExportOrdersCSV — exporta o histórico de pedidos dos seus clientes
image.png Ambos estão desativados por padrão. Ative-os para executar uma vez por dia: image.png

​
Configurações comuns (ambos os jobs)

Vá para a aba Job Steps → clique em RefArch para selecionar os sites onde você usa o Kleep.
  • Timeout — segundos antes de interromper a exportação
  • OrdersMaxToExport — máximo de pedidos a exportar (apenas job de pedidos)
image.png

​
Configurações do KleepExportProductsCSV

image.png
ParâmetroDescriçãoPadrão
SkipMasterIgnorar exportações de produtos masterDesativado
OnlineOnlyExportar apenas produtos onlineDesativado
ExportTypeDelta (apenas atualizados desde a última exportação) ou CompletoDelta
MainViewTypeTipo de visualização de imagem para imagens de produtos. Use o mesmo que a sua PDP.large
LocaleLocale específico para exportação. Usa o padrão se vazio.—
O número de produtos exportados pode exceder o número processado. Isso acontece quando produtos não categorizados são incluídos por meio de sua associação com um VariationGroup categorizado.
Certifique-se de que o parâmetro MainViewType corresponde à configuração da sua loja. Um tipo de visualização incorreto leva a imagens de produto ausentes, que são necessárias para análise de IA.
image.png

​
KleepResetLastExported (job utilitário)

Um terceiro job, KleepResetLastExported, é fornecido para forçar uma re-exportação completa de pedidos. Sua etapa ResetKleepExportAttributes limpa os atributos de rastreamento de exportação em todos os pedidos (kleepLastExported → vazio, isKleepExported → false) para que sejam processados novamente na próxima execução do KleepExportOrdersCSV. Está desativado por padrão e deve ser executado manualmente, sob demanda (ex.: após um reset de dados no lado do Kleep). Não aceita parâmetros.

​
Verificações de Estoque ao Vivo

O Kleep consulta os estoques em tempo real para evitar recomendar tamanhos fora de estoque. Configure o acesso usando um dos dois métodos abaixo.
Não sabe qual escolher? OCAPI é a abordagem tradicional usando a API de Dados do Business Manager. SCAPI (IAS) é a Salesforce Commerce API mais recente com o Inventory Availability Service. Pergunte ao seu administrador Salesforce em caso de dúvida.
Use isto se sua instância depende de OCAPI para gerenciamento de inventário.Passo 1 — Abrir Configurações OCAPINavegue até Administration > Site Development > Open Commerce API Settings, depois edite as configurações da API Data.Passo 2 — Configurar Client IDPara testes:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Para produção, gere um novo client ID conforme a documentação Salesforce. Vídeo tutorial.Passo 3 — Configurar Acesso a RecursosAdicione isso às configurações da API Data do OCAPI:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Passo 4 — Enviar credenciais ao Kleep
  • Client ID
  • Client Secret
  • IDs de Inventário (um por mercado — forneça o mapeamento)
  • URL do SBX de Produção (verificações de estoque são habilitadas apenas em produção)