> ## 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
> Webbplatsinställningar, tjänster, certifikat, exportjobb och lagerkontroller i realtid
## Anpassade webbplatsinställningar
Efter metadataimport, gå till **BM > Merchant Tools > Site Preferences > Custom Preferences**.
Välj **Kleep**:
| Inställning | Beskrivning |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **Obligatorisk.** Unik identifierare för din återförsäljare på Kleep-plattformen, tillhandahållen av din Kleep Account Manager. Måste anges manuellt — den skickas i varje Kleep API-anrop och används som `domain`-parametern i Recommendation-iframen för att lösa ditt konto. Ingen automatisk reservlösning: om den lämnas tom kommer spårning, rekommendationsfunktionen och iframen inte att fungera (ett konfigurationsfel uppstår). |
| `isKleepRecommendationEnabled` | Aktivera/inaktivera Kleep-knappen på PDP. Påverkar inte spårning eller jobbexporter. |
| `kleepButtonColor` | Knappfärg (svart eller vit). Åsidosätt via CSS för anpassad stil. |
| `kleepFontFamily` | Typsnittsfamilj för Kleep-knappen och iFrame. |
| `kleepCountryCode` | Marknad / Landskod ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). |
## Tjänster
Finns under **Administration > Operations > Services**:
**`kleep.sftp`** — Skickar exportfiler från SFCC WebDAV till Kleep SFTP. Ersätt användaren med den som tillhandahålls av Kleep, tillsammans med `.p12`-certifikatet. Ange inget lösenord.
**`kleep`** — Används för alla andra funktioner. Ingen användare/lösenord behövs — begäran autentiseras av webbplatsinställningen `kleepRetailerUUID`, som skickas i nyttolasten för varje Kleep API-anrop för att lösa ditt konto.
## Privat nyckel och certifikat
Gå till **Administration > Operations > Private Keys and Certificates**:
1. Klicka på **Import**
2. Klicka på **Select** och välj `.p12`-filen som tillhandahålls av Kleep
3. Använd `kleep` som alias
4. Klicka på **Save**
Resultatet ska se ut så här — det måste vara giltigt och heta `kleep`:
## Exportjobb
Gå till **Administration > Operations > Jobs**. Två jobb är förkonfigurerade:
* **KleepExportProductsCSV** — exporterar din webbplats produkter
* **KleepExportOrdersCSV** — exporterar dina kunders orderhistorik
Båda är **inaktiverade som standard**. Aktivera dem för att köras en gång per dag:
### Gemensamma inställningar (båda jobben)
Gå till fliken **Job Steps** → klicka på **RefArch** för att välja de webbplatser där du använder Kleep.
* **Timeout** — sekunder innan exporten stoppas
* **OrdersMaxToExport** — maximalt antal beställningar att exportera *(endast beställningsjobb)*
### Inställningar för KleepExportProductsCSV
| Parameter | Beskrivning | Standard |
| -------------- | ------------------------------------------------------------ | ----------- |
| `SkipMaster` | Ignorera export av masterprodukter | Inaktiverad |
| `OnlineOnly` | Exportera enbart onlineprodukter | Inaktiverad |
| `ExportType` | Delta (enbart uppdaterade sedan senaste exporten) eller Full | Delta |
| `MainViewType` | Bildvisningstyp för produktbilder. Använd samma som din PDP. | `large` |
| `Locale` | Specifik locale för export. Använder standard om tomt. | — |
Antalet exporterade produkter kan överstiga antalet behandlade. Detta inträffar när okategoriserade produkter inkluderas via sin koppling till en kategoriserad VariationGroup.
Se till att parametern **MainViewType** matchar din butikskonfiguration. En felaktig visningstyp leder till att produktbilder saknas, vilket krävs för AI-analys.
### KleepResetLastExported (verktygsjobb)
Ett tredje jobb, **KleepResetLastExported**, tillhandahålls för att tvinga fram en **fullständig omexport av beställningar**. Steget `ResetKleepExportAttributes` rensar exportspårningsattributen på varje beställning (`kleepLastExported` → tomt, `isKleepExported` → false) så att de hämtas upp igen vid nästa körning av `KleepExportOrdersCSV`.
Det är **inaktiverat som standard** och är avsett att köras manuellt, på begäran (t.ex. efter en dataåterställning på Kleep-sidan). Det tar inga parametrar.
## Lagerkontroller i realtid
Kleep kontrollerar lager i realtid för att undvika att rekommendera storlekar som är slut i lager. Konfigurera åtkomst med **en** av de två metoderna nedan.
Osäker på vilket alternativ du ska välja? **OCAPI** är det traditionella tillvägagångssättet med Business Manager Data API. **SCAPI (IAS)** är det nyare Salesforce Commerce API med Inventory Availability Service. Fråga din Salesforce-administratör om du är osäker.
Använd detta om din instans förlitar sig på **OCAPI** för lagerhantering.
**Steg 1 — Öppna OCAPI-inställningar**
Navigera till **Administration > Site Development > Open Commerce API Settings** och redigera sedan **Data** API-inställningarna.
**Steg 2 — Konfigurera klient-ID**
För testning:
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
För produktion, generera ett nytt klient-ID enligt [Salesforce-dokumentationen](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Videogenomgång](https://www.youtube.com/watch?v=Z3cZlQHWjtM).
**Steg 3 — Konfigurera resursåtkomst**
Lägg till detta i dina OCAPI **Data** API-konfigurationer:
```
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
```
**Steg 4 — Skicka uppgifter till Kleep**
* Client ID
* Client Secret
* Inventory IDs (ett per marknad — ange din mappning)
* Production SBX URL (lagerkontroller aktiveras endast i produktion)
Använd detta om din instans använder **SCAPI** med **Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI).
**Steg 1 — Skapa en API-klient**
1. Logga in på [Salesforce Account Manager](https://account.demandware.com).
2. Klicka på **API Client** → **Add API Client**.
3. Visningsnamn: t.ex. `Kleep Inventory`.
4. Token Endpoint Auth Method: `client_secret_post`.
5. Access Token Format: `JWT`.
6. Allowed Scopes: `sfcc.inventory.availability`
7. Tilldela till din organisation.
8. Spara. **Kopiera Client ID och Client Secret** — hemligheten visas bara en gång.
SCAPI- och OCAPI-klienter kan inte delas. Varje API-ramverk kräver sin egen klient.
**Steg 2 — Samla instansidentifierare**
| Identifierare | Var hittar du det | Exempel |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | Samma sida, eller 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` |
**Steg 3 — Skicka uppgifter till Kleep**
* Client ID & Client Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s) (ett per marknad — ange din mappning)