Saltar al contenido principal

​
Preferencias de sitio personalizadas

Tras la importación de metadatos, ve a BM > Merchant Tools > Site Preferences > Custom Preferences. image.png Selecciona Kleep: image.png
PreferenciaDescripción
kleepRetailerUUIDObligatorio. Identificador único de tu comerciante en la plataforma Kleep, proporcionado por tu Account Manager de Kleep. Debe introducirse manualmente — se envía en cada llamada a la API de Kleep y se usa como parámetro domain del iframe de Recomendación para resolver tu cuenta. Sin alternativa automática: si se deja vacío, el seguimiento, la funcionalidad de Recomendación y el iframe no funcionarán (se genera un error de configuración).
isKleepRecommendationEnabledHabilitar/deshabilitar el botón de Kleep en la PDP. No afecta al seguimiento ni a las exportaciones de trabajos.
kleepButtonColorColor del botón (Negro o Blanco). Sobreescribe mediante CSS para estilos personalizados.
kleepFontFamilyFamilia tipográfica para el botón de Kleep y el iFrame.
kleepCountryCodeCódigo de mercado / país (ISO 3166 A-2).

​
Servicios

Ubicados en Administration > Operations > Services: image.png kleep.sftp — Envía archivos de exportación desde SFCC WebDAV al SFTP de Kleep. Reemplaza el usuario con el proporcionado por Kleep, junto con el certificado .p12. No establezcas ninguna contraseña. image.png kleep — Usado para todas las demás funcionalidades. No se necesita usuario/contraseña — la solicitud se autentica mediante la preferencia de sitio kleepRetailerUUID, enviada en el payload de cada llamada a la API de Kleep para resolver tu cuenta.

​
Clave privada y certificado

Ve a Administration > Operations > Private Keys and Certificates:
  1. Haz clic en Import
  2. Haz clic en Select y elige el archivo .p12 proporcionado por Kleep
  3. Usa kleep como alias
  4. Haz clic en Save
image.png El resultado debería verse así — debe ser válido y llamarse kleep: image.png

​
Trabajos de exportación

Ve a Administration > Operations > Jobs. Hay dos trabajos preconfigurados:
  • KleepExportProductsCSV — exporta los productos de tu sitio
  • KleepExportOrdersCSV — exporta el historial de pedidos de tus clientes
image.png Ambos están deshabilitados por defecto. Habilítalos para ejecutarse una vez al día: image.png

​
Configuración común (ambos trabajos)

Ve a la pestaña Job Steps → haz clic en RefArch para seleccionar los sitios donde usas Kleep.
  • Timeout — segundos antes de detener la exportación
  • OrdersMaxToExport — máximo de pedidos a exportar (solo trabajo de pedidos)
image.png

​
Configuración de KleepExportProductsCSV

image.png
ParámetroDescripciónPredeterminado
SkipMasterIgnorar exportaciones de productos maestrosDeshabilitado
OnlineOnlyExportar solo productos en líneaDeshabilitado
ExportTypeDelta (solo actualizados desde la última exportación) o CompletoDelta
MainViewTypeTipo de vista de imagen para las imágenes del producto. Usa el mismo que en tu PDP.large
LocaleLocale específico para la exportación. Usa el predeterminado si está vacío.—
El número de productos exportados puede superar el número procesado. Esto ocurre cuando se incluyen productos sin categorizar a través de su asociación con un VariationGroup categorizado.
Asegúrate de que el parámetro MainViewType coincide con la configuración de tu tienda. Un tipo de vista que no coincide provoca la ausencia de imágenes de producto, que son necesarias para el análisis de IA.
image.png

​
KleepResetLastExported (trabajo utilitario)

Un tercer trabajo, KleepResetLastExported, se proporciona para forzar una reexportación completa de pedidos. Su paso ResetKleepExportAttributes borra los atributos de seguimiento de exportación en todos los pedidos (kleepLastExported → vacío, isKleepExported → false) para que sean recogidos de nuevo en la siguiente ejecución de KleepExportOrdersCSV. Está deshabilitado por defecto y está pensado para ejecutarse manualmente, bajo demanda (por ejemplo, tras un reinicio de datos en el lado de Kleep). No requiere parámetros.

​
Verificaciones de stock en vivo

Kleep consulta el stock en tiempo real para evitar recomendar tallas agotadas. Configura el acceso usando uno de los dos métodos a continuación.
¿No sabes cuál elegir? OCAPI es el enfoque tradicional mediante la API de datos de Business Manager. SCAPI (IAS) es la Salesforce Commerce API más reciente con el Servicio de Disponibilidad de Inventario. Consulta a tu administrador de Salesforce si no estás seguro.
Usa esto si tu instancia depende de OCAPI para la gestión de inventario.Paso 1 — Abrir la configuración de OCAPIVe a Administration > Site Development > Open Commerce API Settings y edita la configuración de la API Data.Paso 2 — Configurar el Client IDPara pruebas:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Para producción, genera un nuevo client ID según la documentación de Salesforce. Tutorial en vídeo.Paso 3 — Configurar el acceso a recursosAñade esto a las configuraciones de la API Data de OCAPI:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Paso 4 — Enviar las credenciales a Kleep
  • Client ID
  • Client Secret
  • IDs de inventario (uno por mercado — proporciona tu mapeo)
  • URL de SBX de producción (las verificaciones de stock solo están habilitadas en producción)