> ## 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.
# Konfiguration
> Site-Preferences, Services, Zertifikate, Export-Jobs und Live-Bestandsprüfungen
## Benutzerdefinierte Site-Preferences
Gehen Sie nach dem Metadaten-Import zu **BM > Merchant Tools > Site Preferences > Benutzerdefinierte Preferences**.
Wählen Sie **Kleep**:
| Preference | Beschreibung |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **Obligatorisch.** Eindeutiger Identifikator für Ihren Händler auf der Kleep-Plattform, bereitgestellt von Ihrem Kleep Account Manager. Muss manuell eingegeben werden — er wird in jedem Kleep-API-Aufruf gesendet und als `domain`-Parameter des Empfehlungs-iFrames verwendet, um Ihr Konto aufzulösen. Kein automatischer Fallback: Wenn leer gelassen, funktionieren Tracking, die Empfehlungsfunktion und der iFrame nicht (ein Konfigurationsfehler wird ausgelöst). |
| `isKleepRecommendationEnabled` | Kleep-Schaltfläche im PDP aktivieren/deaktivieren. Hat keinen Einfluss auf Tracking oder Job-Exporte. |
| `kleepButtonColor` | Schaltflächenfarbe (Schwarz oder Weiß). Über CSS für benutzerdefiniertes Styling überschreiben. |
| `kleepFontFamily` | Schriftfamilie für die Kleep-Schaltfläche und den iFrame. |
| `kleepCountryCode` | Markt / Ländercode ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). |
## Services
Zu finden unter **Administration > Operations > Services**:
**`kleep.sftp`** — Sendet Exportdateien von SFCC WebDAV an Kleep SFTP. Ersetzen Sie den Benutzer durch den von Kleep bereitgestellten, zusammen mit dem `.p12`-Zertifikat. Legen Sie kein Passwort fest.
**`kleep`** — Wird für alle anderen Funktionen verwendet. Kein Benutzer/Passwort erforderlich — die Anfrage wird durch die Site-Preference `kleepRetailerUUID` authentifiziert, die im Payload jedes Kleep-API-Aufrufs gesendet wird, um Ihr Konto aufzulösen.
## Privater Schlüssel & Zertifikat
Gehen Sie zu **Administration > Operations > Private Keys and Certificates**:
1. Klicken Sie auf **Import**
2. Klicken Sie auf **Select** und wählen Sie die von Kleep bereitgestellte `.p12`-Datei
3. Verwenden Sie `kleep` als Alias
4. Klicken Sie auf **Save**
Das Ergebnis sollte so aussehen — es muss gültig sein und `kleep` heißen:
## Export-Jobs
Gehen Sie zu **Administration > Operations > Jobs**. Zwei Jobs sind vorkonfiguriert:
* **KleepExportProductsCSV** — exportiert die Produkte Ihrer Site
* **KleepExportOrdersCSV** — exportiert die Bestellhistorie Ihrer Kunden
Beide sind **standardmäßig deaktiviert**. Aktivieren Sie sie für einen täglichen Lauf:
### Gemeinsame Einstellungen (beide Jobs)
Gehen Sie zum Tab **Job Steps** → klicken Sie auf **RefArch**, um die Sites auszuwählen, auf denen Sie Kleep verwenden.
* **Timeout** — Sekunden vor dem Stopp des Exports
* **OrdersMaxToExport** — maximale Anzahl zu exportierender Bestellungen *(nur Bestellungs-Job)*
### KleepExportProductsCSV-Einstellungen
| Parameter | Beschreibung | Standard |
| -------------- | ----------------------------------------------------------------------------- | ----------- |
| `SkipMaster` | Master-Produktexporte ignorieren | Deaktiviert |
| `OnlineOnly` | Nur Online-Produkte exportieren | Deaktiviert |
| `ExportType` | Delta (nur seit letztem Export aktualisiert) oder Full | Delta |
| `MainViewType` | Bildansichtstyp für Produktbilder. Verwenden Sie denselben wie auf Ihrem PDP. | `large` |
| `Locale` | Spezifische Locale für den Export. Verwendet Standard, wenn leer. | — |
Die Anzahl der exportierten Produkte kann die Anzahl der verarbeiteten übersteigen. Dies tritt auf, wenn nicht kategorisierte Produkte durch ihre Zugehörigkeit zu einer kategorisierten VariationGroup einbezogen werden.
Stellen Sie sicher, dass der Parameter **MainViewType** mit der Konfiguration Ihres Shops übereinstimmt. Ein falscher Ansichtstyp führt zu fehlenden Produktbildern, die für die KI-Analyse erforderlich sind.
### KleepResetLastExported (Hilfsjob)
Ein dritter Job, **KleepResetLastExported**, wird bereitgestellt, um einen **vollständigen Re-Export von Bestellungen** zu erzwingen. Sein Schritt `ResetKleepExportAttributes` löscht die Export-Tracking-Attribute bei jeder Bestellung (`kleepLastExported` → leer, `isKleepExported` → false), sodass sie beim nächsten `KleepExportOrdersCSV`-Lauf erneut erfasst werden.
Er ist **standardmäßig deaktiviert** und ist für den manuellen Betrieb auf Anfrage vorgesehen (z. B. nach einem datenseitigen Reset bei Kleep). Er benötigt keine Parameter.
## Live-Bestandsprüfungen
Kleep fragt Bestände live ab, um das Empfehlen nicht vorrätiger Größen zu vermeiden. Konfigurieren Sie den Zugang mit **einer** der beiden folgenden Methoden.
Nicht sicher, welche Sie wählen sollen? **OCAPI** ist der traditionelle Ansatz mit der Business Manager Data API. **SCAPI (IAS)** ist die neuere Salesforce Commerce API mit dem Inventory Availability Service. Fragen Sie Ihren Salesforce-Administrator, falls Sie unsicher sind.
Verwenden Sie diese Option, wenn Ihre Instanz **OCAPI** für die Bestandsverwaltung nutzt.
**Schritt 1 — OCAPI-Einstellungen öffnen**
Navigieren Sie zu **Administration > Site Development > Open Commerce API Settings** und bearbeiten Sie dann die **Data**-API-Einstellungen.
**Schritt 2 — Client-ID einrichten**
Zum Testen:
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
Für die Produktion generieren Sie eine neue Client-ID gemäß der [Salesforce-Dokumentation](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Video-Walkthrough](https://www.youtube.com/watch?v=Z3cZlQHWjtM).
**Schritt 3 — Ressourcenzugriff konfigurieren**
Fügen Sie dies zu Ihren OCAPI **Data**-API-Konfigurationen hinzu:
```
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
```
**Schritt 4 — Zugangsdaten an Kleep senden**
* Client-ID
* Client-Secret
* Inventar-IDs (eine pro Markt — stellen Sie Ihr Mapping bereit)
* Produktions-SBX-URL (Bestandsprüfungen sind nur in der Produktion aktiviert)
Verwenden Sie diese Option, wenn Ihre Instanz **SCAPI** mit dem **Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI) verwendet.
**Schritt 1 — API-Client erstellen**
1. Melden Sie sich beim [Salesforce Account Manager](https://account.demandware.com) an.
2. Klicken Sie auf **API Client** → **API-Client hinzufügen**.
3. Anzeigename: z. B. `Kleep Inventory`.
4. Token Endpoint Auth Method: `client_secret_post`.
5. Access Token Format: `JWT`.
6. Allowed Scopes: `sfcc.inventory.availability`
7. Ihrer Organisation zuweisen.
8. Speichern. **Kopieren Sie Client-ID und Client-Secret** — das Secret wird nur einmal angezeigt.
SCAPI- und OCAPI-Clients können nicht geteilt werden. Jedes API-Framework benötigt seinen eigenen Client.
**Schritt 2 — Instanz-Identifikatoren sammeln**
| Identifikator | Wo zu finden | Beispiel |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | Gleiche Seite oder 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` |
**Schritt 3 — Zugangsdaten an Kleep senden**
* Client-ID & Client-Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s) (eine pro Markt — stellen Sie Ihr Mapping bereit)