> ## 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.

# Configuratie

> Sitevoorkeuren, services, certificaten, exporttaken en live-voorraadcontroles

## Aangepaste sitevoorkeuren

Ga na het importeren van metadata naar **BM > Merchant Tools > Site Preferences > Custom Preferences**.

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image7.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=3cb6bcc19b6a641efc04bd899b903a40" alt="image.png" width="1429" height="699" data-path="images/sfcc/image7.png" />

Selecteer **Kleep**:

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image8.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=3bf7f87b789fd4e2c854e513666e1426" alt="image.png" width="1429" height="696" data-path="images/sfcc/image8.png" />

| Voorkeur                       | Beschrijving                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID`            | **Verplicht.** Unieke identificator voor uw retailer op het Kleep-platform, verstrekt door uw Kleep-accountmanager. Moet handmatig worden ingevoerd — het wordt meegestuurd bij elke Kleep API-aanroep en gebruikt als de parameter `domain` van de Aanbeveling-iframe om uw account te bepalen. Geen automatisch alternatief: indien leeg gelaten, werken tracking, de Aanbevelingsfunctie en de iframe niet (een configuratiefout wordt gegenereerd). |
| `isKleepRecommendationEnabled` | De Kleep-knop in PDP in-/uitschakelen. Heeft geen invloed op tracking of taakexports.                                                                                                                                                                                                                                                                                                                                                                   |
| `kleepButtonColor`             | Knopkleur (zwart of wit). Overschrijf via CSS voor aangepaste opmaak.                                                                                                                                                                                                                                                                                                                                                                                   |
| `kleepFontFamily`              | Lettertypefamilie voor de Kleep-knop en iFrame.                                                                                                                                                                                                                                                                                                                                                                                                         |
| `kleepCountryCode`             | Markt / Landcode ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)).                                                                                                                                                                                                                                                                                                                                  |

## Services

Te vinden in **Administration > Operations > Services**:

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image9.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=1f298d1ff1d5c84cc878ba424ce7db61" alt="image.png" width="1429" height="473" data-path="images/sfcc/image9.png" />

**`kleep.sftp`** — Verstuurt exportbestanden van SFCC WebDAV naar Kleep SFTP. Vervang de gebruiker door degene die door Kleep is verstrekt, samen met het `.p12`-certificaat. Stel geen wachtwoord in.

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image10.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=ad947fb9b13e5868791ccc6a29951e39" alt="image.png" width="1254" height="1030" data-path="images/sfcc/image10.png" />

**`kleep`** — Gebruikt voor alle andere functies. Geen gebruiker/wachtwoord nodig — het verzoek wordt geverifieerd via de siteinstelling `kleepRetailerUUID`, meegestuurd in de payload van elke Kleep API-aanroep om uw account te bepalen.

## Privésleutel & Certificaat

Ga naar **Administration > Operations > Private Keys and Certificates**:

1. Klik op **Import**
2. Klik op **Select** en kies het `.p12`-bestand verstrekt door Kleep
3. Gebruik `kleep` als alias
4. Klik op **Save**

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image11.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=b8e9edbc87ec28cd95999906473cd556" alt="image.png" width="671" height="796" data-path="images/sfcc/image11.png" />

Het resultaat zou er als volgt uit moeten zien — het moet geldig zijn en de naam `kleep` hebben:

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image12.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=ac8df7c5e67683486e34ea129b17c186" alt="image.png" width="1432" height="439" data-path="images/sfcc/image12.png" />

## Exporttaken

Ga naar **Administration > Operations > Jobs**. Twee taken zijn vooraf geconfigureerd:

* **KleepExportProductsCSV** — exporteert de producten van uw site
* **KleepExportOrdersCSV** — exporteert de ordergeschiedenis van uw klanten

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image13.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=9578b9d90e65d26c10e0d749ac0feaae" alt="image.png" width="1430" height="526" data-path="images/sfcc/image13.png" />

Beide zijn **standaard uitgeschakeld**. Schakel ze in om eenmaal per dag te worden uitgevoerd:

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image14.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=17a570801f04cbba179e771e8145dd78" alt="image.png" width="1429" height="1032" data-path="images/sfcc/image14.png" />

### Algemene instellingen (beide taken)

Ga naar het tabblad **Job Steps** → klik op **RefArch** om de sites te selecteren waar u Kleep gebruikt.

* **Timeout** — seconden voordat de export wordt gestopt
* **OrdersMaxToExport** — maximaal te exporteren orders *(alleen ordertaak)*

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image15.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=1e61450b40aa522b1ce0c9f81122c2a6" alt="image.png" width="1430" height="774" data-path="images/sfcc/image15.png" />

### Instellingen KleepExportProductsCSV

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image16.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=cfa7a5109d2d464ecfd56b06073c74c8" alt="image.png" width="1304" height="858" data-path="images/sfcc/image16.png" />

| Parameter      | Beschrijving                                                           | Standaard     |
| -------------- | ---------------------------------------------------------------------- | ------------- |
| `SkipMaster`   | Masterproductexports overslaan                                         | Uitgeschakeld |
| `OnlineOnly`   | Alleen online producten exporteren                                     | Uitgeschakeld |
| `ExportType`   | Delta (alleen bijgewerkt sinds laatste export) of Volledig             | Delta         |
| `MainViewType` | Weergavetype voor productafbeeldingen. Gebruik hetzelfde als uw PDP.   | `large`       |
| `Locale`       | Specifieke landinstelling voor export. Gebruikt standaard indien leeg. | —             |

<Note>
  Het aantal geëxporteerde producten kan het aantal verwerkte producten overstijgen. Dit gebeurt wanneer niet-gecategoriseerde producten worden opgenomen via hun koppeling met een gecategoriseerde VariationGroup.
</Note>

<Warning>
  Zorg ervoor dat de parameter **MainViewType** overeenkomt met de configuratie van uw winkel. Een onjuist weergavetype leidt tot ontbrekende productafbeeldingen, die vereist zijn voor AI-analyse.
</Warning>

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image17.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=29874674c882456b59e41688bef4a693" alt="image.png" width="1432" height="630" data-path="images/sfcc/image17.png" />

### KleepResetLastExported (hulptaak)

Een derde taak, **KleepResetLastExported**, is beschikbaar om een **volledige herexport van orders** te forceren. De stap `ResetKleepExportAttributes` wist de exporttrackingattributen op elke order (`kleepLastExported` → leeg, `isKleepExported` → false) zodat ze bij de volgende uitvoering van `KleepExportOrdersCSV` opnieuw worden opgepakt.

Het is **standaard uitgeschakeld** en bedoeld om handmatig te worden uitgevoerd, op verzoek (bijv. na een gegevensherstel aan de Kleep-zijde). Er zijn geen parameters nodig.

## Live-voorraadcontroles

Kleep bevraagt de voorraad live om te voorkomen dat niet op voorraad zijnde maten worden aanbevolen. Configureer toegang via **één** van de twee onderstaande methoden.

<Info>
  Weet u niet welke u moet kiezen? **OCAPI** is de traditionele aanpak via de Business Manager Data API. **SCAPI (IAS)** is de nieuwere Salesforce Commerce API met de Inventory Availability Service. Vraag uw Salesforce-beheerder als u het niet zeker weet.
</Info>

<Tabs>
  <Tab title="OCAPI (Open Commerce API)">
    Gebruik dit als uw instantie op **OCAPI** vertrouwt voor voorraadbeheer.

    **Stap 1 — Open OCAPI-instellingen**

    Navigeer naar **Administration > Site Development > Open Commerce API Settings** en bewerk vervolgens de **Data** API-instellingen.

    **Stap 2 — Client-ID instellen**

    Voor testen:

    ```
    "client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    ```

    Genereer voor productie een nieuw client-ID volgens de [Salesforce-documentatie](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).

    **Stap 3 — Resourcetoegang configureren**

    Voeg dit toe aan uw OCAPI **Data** API-configuraties:

    ```
    Authorizations
    (GET) /inventory_lists/*
    (GET) /inventory_lists/*/product_inventory_records/*
    ```

    **Stap 4 — Stuur inloggegevens naar Kleep**

    * Client-ID
    * Client Secret
    * Inventaris-ID's (één per markt — geef uw mapping op)
    * Productie-SBX-URL (voorraadcontroles zijn alleen ingeschakeld op productie)
  </Tab>

  <Tab title="SCAPI — Inventory Availability Service (IAS)">
    Gebruik dit als uw instantie **SCAPI** gebruikt met de **Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI).

    **Stap 1 — Een API-client aanmaken**

    1. Log in op [Salesforce Account Manager](https://account.demandware.com).
    2. Klik op **API Client** → **Add API Client**.
    3. Weergavenaam: bijv. `Kleep Inventory`.
    4. Token Endpoint-verificatiemethode: `client_secret_post`.
    5. Toegangstoken-formaat: `JWT`.
    6. Toegestane scopes: `sfcc.inventory.availability`
    7. Wijs toe aan uw organisatie.
    8. Opslaan. **Kopieer de Client-ID en Client Secret** — het geheim wordt slechts één keer weergegeven.

    <Warning>
      SCAPI- en OCAPI-clients kunnen niet worden gedeeld. Elk API-framework vereist zijn eigen client.
    </Warning>

    **Stap 2 — Instantie-identificatoren verzamelen**

    | Identificator        | Waar te vinden                                                                | Voorbeeld                      |
    | -------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
    | **Korte code**       | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78`                     |
    | **Organisatie-ID**   | Zelfde pagina, of Account Manager                                             | `f_ecom_zzzz_prd`              |
    | **Tenant-ID**        | Account Manager > Organizations                                               | `zzzz_prd`                     |
    | **Locatiegroep(en)** | BM > **Merchant Tools > Inventory > Inventory Availability**                  | `WAREHOUSE_FR`, `WAREHOUSE_US` |

    **Stap 3 — Stuur inloggegevens naar Kleep**

    * Client-ID & Client Secret
    * Korte code
    * Organisatie-ID
    * Tenant-ID
    * Locatiegroep(en) (één per markt — geef uw mapping op)
  </Tab>
</Tabs>
