Saltar para o conteúdo principal

​
Preferências de Site Personalizadas

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

​
Serviços

Encontrado em Administration > Operations > Services: image.png kleep.sftp — Envia ficheiros de exportação do WebDAV SFCC para o SFTP Kleep. Substitua o utilizador pelo fornecido pelo Kleep, juntamente com o certificado .p12. Não defina qualquer palavra-passe. image.png kleep — Utilizado para todas as outras funcionalidades. Não é necessário utilizador/palavra-passe — o pedido é autenticado pela preferência de site kleepRetailerUUID, enviada no payload de cada chamada à API Kleep para resolver a sua conta.

​
Chave Privada e Certificado

Vá a Administration > Operations > Private Keys and Certificates:
  1. Clique em Import
  2. Clique em Select e escolha o ficheiro .p12 fornecido pelo Kleep
  3. Utilize kleep como alias
  4. Clique em Save
image.png O resultado deve ter este aspeto — deve ser válido e ter o nome kleep: image.png

​
Jobs de Exportação

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

​
Definições comuns (ambos os jobs)

Vá ao separador Job Steps → clique em RefArch para selecionar os sites onde utiliza o Kleep.
  • Timeout — segundos antes de parar a exportação
  • OrdersMaxToExport — máximo de encomendas a exportar (apenas no job de encomendas)
image.png

​
Definiçõ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 FullDelta
MainViewTypeTipo de vista de imagem para imagens de produto. Utilize o mesmo que o seu PDP.large
LocaleLocale específico para exportação. Utiliza o padrão se vazio.—
O número de produtos exportados pode exceder o número processado. Isto acontece quando produtos não categorizados são incluídos através da sua associação com um VariationGroup categorizado.
Certifique-se de que o parâmetro MainViewType corresponde à configuração da sua loja. Um tipo de vista incorreto resulta em imagens de produto em falta, que são necessárias para a análise de IA.
image.png

​
KleepResetLastExported (job utilitário)

Um terceiro job, KleepResetLastExported, é fornecido para forçar uma re-exportação completa de encomendas. O seu passo ResetKleepExportAttributes limpa os atributos de tracking de exportação em todas as encomendas (kleepLastExported → vazio, isKleepExported → false) para que sejam recolhidas na próxima execução de KleepExportOrdersCSV. Está desativado por padrão e destina-se a ser executado manualmente, a pedido (por exemplo, após um reset de dados do lado do Kleep). Não recebe parâmetros.

​
Verificações de Stock em Tempo Real

O Kleep consulta o stock em tempo real para evitar recomendar tamanhos esgotados. Configure o acesso utilizando 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 nova Salesforce Commerce API com o Inventory Availability Service. Consulte o seu administrador Salesforce em caso de dúvida.
Utilize este método se a sua instância se baseia em OCAPI para gestão de inventário.Passo 1 — Abrir as Definições OCAPINavegue até Administration > Site Development > Open Commerce API Settings e edite as definições da API Data.Passo 2 — Configurar o Client IDPara testes:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Para produção, gere um novo client ID conforme a documentação Salesforce. Demonstração em vídeo.Passo 3 — Configurar o Acesso a RecursosAdicione isto às suas configurações da API Data 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 seu mapeamento)
  • URL SBX de Produção (as verificações de stock estão ativas apenas em produção)