> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuración
> Preferencias del sitio, servicios, certificados, trabajos de exportación y verificaciones de stock en vivo
## Preferencias de sitio personalizadas
Tras la importación de metadatos, ve a **BM > Merchant Tools > Site Preferences > Custom Preferences**.
Selecciona **Kleep**:
| Preferencia | Descripción |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **Obligatorio.** 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). |
| `isKleepRecommendationEnabled` | Habilitar/deshabilitar el botón de Kleep en la PDP. No afecta al seguimiento ni a las exportaciones de trabajos. |
| `kleepButtonColor` | Color del botón (Negro o Blanco). Sobreescribe mediante CSS para estilos personalizados. |
| `kleepFontFamily` | Familia tipográfica para el botón de Kleep y el iFrame. |
| `kleepCountryCode` | Código de mercado / país ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). |
## Servicios
Ubicados en **Administration > Operations > Services**:
**`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.
**`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**
El resultado debería verse así — debe ser válido y llamarse `kleep`:
## 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
Ambos están **deshabilitados por defecto**. Habilítalos para ejecutarse una vez al día:
### 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)*
### Configuración de KleepExportProductsCSV
| Parámetro | Descripción | Predeterminado |
| -------------- | ----------------------------------------------------------------------------------- | -------------- |
| `SkipMaster` | Ignorar exportaciones de productos maestros | Deshabilitado |
| `OnlineOnly` | Exportar solo productos en línea | Deshabilitado |
| `ExportType` | Delta (solo actualizados desde la última exportación) o Completo | Delta |
| `MainViewType` | Tipo de vista de imagen para las imágenes del producto. Usa el mismo que en tu PDP. | `large` |
| `Locale` | Locale 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.
### 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 OCAPI**
Ve a **Administration > Site Development > Open Commerce API Settings** y edita la configuración de la API **Data**.
**Paso 2 — Configurar el Client ID**
Para pruebas:
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
Para producción, genera un nuevo client ID según la [documentación de Salesforce](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Tutorial en vídeo](https://www.youtube.com/watch?v=Z3cZlQHWjtM).
**Paso 3 — Configurar el acceso a recursos**
Añ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)
Usa esto si tu instancia usa **SCAPI** con el **Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI).
**Paso 1 — Crear un API Client**
1. Inicia sesión en [Salesforce Account Manager](https://account.demandware.com).
2. Haz clic en **API Client** → **Add API Client**.
3. Nombre visible: por ejemplo, `Kleep Inventory`.
4. Token Endpoint Auth Method: `client_secret_post`.
5. Access Token Format: `JWT`.
6. Allowed Scopes: `sfcc.inventory.availability`
7. Asigna a tu organización.
8. Guarda. **Copia el Client ID y el Client Secret** — el secreto se muestra solo una vez.
Los clientes SCAPI y OCAPI no pueden compartirse. Cada marco de API requiere su propio cliente.
**Paso 2 — Recopilar los identificadores de instancia**
| Identificador | Dónde encontrarlo | Ejemplo |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | La misma página, o Account Manager | `f_ecom_zzzz_prd` |
| **Tenant ID** | Account Manager > Organizations | `zzzz_prd` |
| **Location Group(s)** | BM > **Merchant Tools > Inventory > Inventory Availability** | `WAREHOUSE_FR`, `WAREHOUSE_US` |
**Paso 3 — Enviar las credenciales a Kleep**
* Client ID y Client Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s) (uno por mercado — proporciona tu mapeo)