> ## 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.
# Configuration
> Préférences de site, services, certificats, jobs d'export et vérifications de stock en temps réel
## Préférences de site personnalisées
Après l'import des métadonnées, accédez à **BM > Merchant Tools > Site Preferences > Custom Preferences**.
Sélectionnez **Kleep** :
| Préférence | Description |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **Obligatoire.** Identifiant unique de votre revendeur sur la plateforme Kleep, fourni par votre Account Manager Kleep. Doit être saisi manuellement — il est envoyé dans chaque appel API Kleep et utilisé comme paramètre `domain` de l'iframe de Recommandation pour résoudre votre compte. Aucun fallback automatique : s'il est vide, le tracking, la fonctionnalité de Recommandation et l'iframe ne fonctionneront pas (une erreur de configuration est déclenchée). |
| `isKleepRecommendationEnabled` | Activer/désactiver le bouton Kleep sur la PDP. N'affecte pas le tracking ni les exports des jobs. |
| `kleepButtonColor` | Couleur du bouton (Noir ou Blanc). Remplacez via CSS pour un style personnalisé. |
| `kleepFontFamily` | Famille de police pour le bouton Kleep et l'iFrame. |
| `kleepCountryCode` | Code marché / pays ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). |
## Services
Disponibles dans **Administration > Operations > Services** :
**`kleep.sftp`** — Envoie les fichiers d'export depuis le WebDAV SFCC vers le SFTP Kleep. Remplacez l'utilisateur par celui fourni par Kleep, ainsi que le certificat `.p12`. Ne définissez aucun mot de passe.
**`kleep`** — Utilisé pour toutes les autres fonctionnalités. Aucun identifiant nécessaire — la requête est authentifiée par la préférence de site `kleepRetailerUUID`, envoyée dans le payload de chaque appel API Kleep pour résoudre votre compte.
## Clé privée et certificat
Accédez à **Administration > Operations > Private Keys and Certificates** :
1. Cliquez sur **Import**
2. Cliquez sur **Select** et choisissez le fichier `.p12` fourni par Kleep
3. Utilisez `kleep` comme alias
4. Cliquez sur **Save**
Le résultat doit ressembler à ceci — il doit être valide et nommé `kleep` :
## Jobs d'export
Accédez à **Administration > Operations > Jobs**. Deux jobs sont préconfigurés :
* **KleepExportProductsCSV** — exporte les produits de votre site
* **KleepExportOrdersCSV** — exporte l'historique des commandes de vos clients
Les deux sont **désactivés par défaut**. Activez-les pour qu'ils s'exécutent une fois par jour :
### Paramètres communs (les deux jobs)
Accédez à l'onglet **Job Steps** → cliquez sur **RefArch** pour sélectionner les sites où vous utilisez Kleep.
* **Timeout** — secondes avant l'arrêt de l'export
* **OrdersMaxToExport** — nombre maximum de commandes à exporter *(job commandes uniquement)*
### Paramètres de KleepExportProductsCSV
| Paramètre | Description | Défaut |
| -------------- | --------------------------------------------------------------------------------- | --------- |
| `SkipMaster` | Ignorer les exports de produits master | Désactivé |
| `OnlineOnly` | Exporter uniquement les produits en ligne | Désactivé |
| `ExportType` | Delta (uniquement mis à jour depuis le dernier export) ou Full | Delta |
| `MainViewType` | Type de vue d'image pour les images produits. Utilisez le même que sur votre PDP. | `large` |
| `Locale` | Locale spécifique pour l'export. Utilise la valeur par défaut si vide. | — |
Le nombre de produits exportés peut dépasser le nombre traité. Cela se produit lorsque des produits non catégorisés sont inclus via leur association avec un VariationGroup catégorisé.
Assurez-vous que le paramètre **MainViewType** correspond à la configuration de votre boutique. Un type de vue incorrect entraîne des images produits manquantes, qui sont nécessaires pour l'analyse IA.
### KleepResetLastExported (job utilitaire)
Un troisième job, **KleepResetLastExported**, est fourni pour forcer un **re-export complet des commandes**. Son étape `ResetKleepExportAttributes` efface les attributs de suivi d'export sur chaque commande (`kleepLastExported` → vide, `isKleepExported` → false) afin qu'ils soient repris lors de la prochaine exécution de `KleepExportOrdersCSV`.
Il est **désactivé par défaut** et destiné à être exécuté manuellement, à la demande (par exemple, après une réinitialisation des données côté Kleep). Il ne prend aucun paramètre.
## Vérifications de stock en temps réel
Kleep interroge les stocks en temps réel pour éviter de recommander des tailles en rupture de stock. Configurez l'accès en utilisant **l'une** des deux méthodes ci-dessous.
Vous ne savez pas laquelle choisir ? **OCAPI** est l'approche traditionnelle utilisant l'API Data du Business Manager. **SCAPI (IAS)** est la nouvelle Salesforce Commerce API avec le service de disponibilité des stocks (Inventory Availability Service). Demandez à votre administrateur Salesforce en cas de doute.
Utilisez cette méthode si votre instance s'appuie sur **OCAPI** pour la gestion des stocks.
**Étape 1 — Ouvrir les paramètres OCAPI**
Accédez à **Administration > Site Development > Open Commerce API Settings**, puis modifiez les paramètres de l'API **Data**.
**Étape 2 — Configurer le Client ID**
Pour les tests :
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
Pour la production, générez un nouveau client ID conformément à la [documentation Salesforce](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Tutoriel vidéo](https://www.youtube.com/watch?v=Z3cZlQHWjtM).
**Étape 3 — Configurer l'accès aux ressources**
Ajoutez ceci à vos configurations de l'API OCAPI **Data** :
```
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
```
**Étape 4 — Envoyer les identifiants à Kleep**
* Client ID
* Client Secret
* IDs d'inventaire (un par marché — fournissez votre mapping)
* URL SBX de production (les vérifications de stock ne sont activées qu'en production)
Utilisez cette méthode si votre instance utilise **SCAPI** avec le **service de disponibilité des stocks (IAS)** / Omnichannel Inventory (OCI).
**Étape 1 — Créer un client API**
1. Connectez-vous à [Salesforce Account Manager](https://account.demandware.com).
2. Cliquez sur **API Client** → **Add API Client**.
3. Nom d'affichage : par exemple `Kleep Inventory`.
4. Token Endpoint Auth Method : `client_secret_post`.
5. Access Token Format : `JWT`.
6. Allowed Scopes : `sfcc.inventory.availability`
7. Assignez à votre Organisation.
8. Enregistrez. **Copiez le Client ID et le Client Secret** — le secret n'est affiché qu'une seule fois.
Les clients SCAPI et OCAPI ne peuvent pas être partagés. Chaque framework API nécessite son propre client.
**Étape 2 — Rassembler les identifiants d'instance**
| Identifiant | Où le trouver | Exemple |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | Même page, ou 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` |
**Étape 3 — Envoyer les identifiants à Kleep**
* Client ID & Client Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s) (un par marché — fournissez votre mapping)