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

# Konfiguraatio

> Sivuasetukset, palvelut, sertifikaatit, vientityöt ja reaaliaikaiset varastotarkistukset

## Mukautetut sivuasetukset

Metatietojen tuonnin jälkeen siirry kohtaan **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" />

Valitse **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" />

| Asetus                         | Kuvaus                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID`            | **Pakollinen.** Jälleenmyyjäsi yksilöllinen tunniste Kleep-alustalla, jonka Kleep-tilinhallintajasi toimittaa. On syötettävä manuaalisesti — se lähetetään jokaisessa Kleep API -kutsussa ja sitä käytetään Suositus-iframen `domain`-parametrina tilisi selvittämiseen. Ei automaattista varavaihtoehtoa: jos jätetään tyhjäksi, seuranta, Suositus-ominaisuus ja iframe eivät toimi (konfigurointivirhe ilmoitetaan). |
| `isKleepRecommendationEnabled` | Ota käyttöön/poista käytöstä Kleep-painike PDP:ssä. Ei vaikuta seurantaan tai työvienteihin.                                                                                                                                                                                                                                                                                                                            |
| `kleepButtonColor`             | Painikkeen väri (musta tai valkoinen). Ohita CSS:llä mukautettua tyyliä varten.                                                                                                                                                                                                                                                                                                                                         |
| `kleepFontFamily`              | Fonttiperhe Kleep-painikkeelle ja iFramelle.                                                                                                                                                                                                                                                                                                                                                                            |
| `kleepCountryCode`             | Markkina / Maakoodi ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)).                                                                                                                                                                                                                                                                                               |

## Palvelut

Löytyy kohdasta **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`** — Lähettää vientitiedostot SFCC WebDAVista Kleep SFTP:hen. Korvaa käyttäjä Kleepin toimittamalla käyttäjällä sekä `.p12`-sertifikaatilla. Älä aseta salasanaa.

<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`** — Käytetään kaikkiin muihin ominaisuuksiin. Ei tarvita käyttäjää/salasanaa — pyyntö todennetaan `kleepRetailerUUID`-sivuasetuksella, joka lähetetään jokaisen Kleep API -kutsun kuormassa tilisi selvittämiseksi.

## Yksityinen avain ja sertifikaatti

Siirry kohtaan **Administration > Operations > Private Keys and Certificates**:

1. Napsauta **Import**
2. Napsauta **Select** ja valitse Kleepin toimittama `.p12`-tiedosto
3. Käytä `kleep` aliaksena
4. Napsauta **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" />

Tuloksen pitäisi näyttää tältä — sen on oltava voimassa ja nimettynä `kleep`:

<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" />

## Vientityöt

Siirry kohtaan **Administration > Operations > Jobs**. Kaksi työtä on esikonfiguroitu:

* **KleepExportProductsCSV** — vie sivustosi tuotteet
* **KleepExportOrdersCSV** — vie asiakkaidesi tilaushistorian

<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" />

Molemmat ovat **oletuksena poissa käytöstä**. Ota ne käyttöön ajamaan kerran päivässä:

<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" />

### Yhteiset asetukset (molemmat työt)

Siirry **Job Steps** -välilehdelle → napsauta **RefArch** valitaksesi sivustot, joissa käytät Kleepiä.

* **Timeout** — sekuntia ennen viennin pysäyttämistä
* **OrdersMaxToExport** — vietävien tilausten enimmäismäärä *(vain tilaustyö)*

<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" />

### KleepExportProductsCSV-asetukset

<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" />

| Parametri      | Kuvaus                                                     | Oletus        |
| -------------- | ---------------------------------------------------------- | ------------- |
| `SkipMaster`   | Ohita päätuotteiden vienti                                 | Pois käytöstä |
| `OnlineOnly`   | Vie vain verkkotuotteet                                    | Pois käytöstä |
| `ExportType`   | Delta (vain päivitetty edellisen viennin jälkeen) tai Full | Delta         |
| `MainViewType` | Tuotekuvien kuvanäkymätyyppi. Käytä samaa kuin PDP:ssä.    | `large`       |
| `Locale`       | Viennin tietty kielialue. Käyttää oletusta, jos tyhjä.     | —             |

<Note>
  Vietyjen tuotteiden määrä voi ylittää käsiteltyjen määrän. Tämä tapahtuu, kun luokittelemattomat tuotteet sisällytetään luokitellun VariationGroupin kautta.
</Note>

<Warning>
  Varmista, että **MainViewType**-parametri vastaa kauppasi konfiguraatiota. Väärä näkymätyyppi johtaa puuttuviin tuotekuviin, joita tarvitaan tekoälyanalyysiä varten.
</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 (apuohjelmatyö)

Kolmas työ, **KleepResetLastExported**, on tarjolla pakottamaan **tilausten täydellinen uudelleenvienti**. Sen `ResetKleepExportAttributes`-vaihe tyhjentää viennin seurantaattribuutit jokaisesta tilauksesta (`kleepLastExported` → tyhjä, `isKleepExported` → false), jotta ne noudetaan uudelleen seuraavalla `KleepExportOrdersCSV`-ajokerralla.

Se on **oletuksena poissa käytöstä** ja tarkoitettu ajettavaksi manuaalisesti tarpeen mukaan (esim. Kleep-puolen tietojen nollauksen jälkeen). Se ei ota parametreja.

## Reaaliaikaiset varastotarkistukset

Kleep kyselee varastoja reaaliaikaisesti välttääkseen loppuunmyytyjen kokojen suosittelemisen. Konfiguroi pääsy käyttämällä **yhtä** alla olevista kahdesta menetelmästä.

<Info>
  Epävarma kumpi valita? **OCAPI** on perinteinen lähestymistapa Business Manager Data API:lla. **SCAPI (IAS)** on uudempi Salesforce Commerce API Inventory Availability Servicellä. Kysy Salesforce-järjestelmänvalvojaltasi, jos et ole varma.
</Info>

<Tabs>
  <Tab title="OCAPI (Open Commerce API)">
    Käytä tätä, jos esiintymäsi perustuu **OCAPI**:in varastonhallinnassa.

    **Vaihe 1 — Avaa OCAPI-asetukset**

    Siirry kohtaan **Administration > Site Development > Open Commerce API Settings** ja muokkaa **Data** API -asetuksia.

    **Vaihe 2 — Määritä asiakastunnus**

    Testausta varten:

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

    Tuotantoa varten luo uusi asiakastunnus [Salesforce-dokumentaation](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5) mukaan. [Videoläpikäynti](https://www.youtube.com/watch?v=Z3cZlQHWjtM).

    **Vaihe 3 — Konfiguroi resurssien käyttöoikeus**

    Lisää tämä OCAPI **Data** API -konfiguraatioihisi:

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

    **Vaihe 4 — Lähetä tunnistetiedot Kleepille**

    * Asiakastunnus
    * Asiakassalaisuus
    * Varastotunnukset (yksi per markkina — toimita kartoituksesi)
    * Tuotannon SBX-URL (varastotarkistukset ovat käytössä vain tuotannossa)
  </Tab>

  <Tab title="SCAPI — Inventory Availability Service (IAS)">
    Käytä tätä, jos esiintymäsi käyttää **SCAPI**:a **Inventory Availability Servicen (IAS)** / Omnichannel Inventoryn (OCI) kanssa.

    **Vaihe 1 — Luo API-asiakas**

    1. Kirjaudu sisään [Salesforce Account Manageriin](https://account.demandware.com).
    2. Napsauta **API Client** → **Add API Client**.
    3. Näyttönimi: esim. `Kleep Inventory`.
    4. Token Endpoint Auth Method: `client_secret_post`.
    5. Access Token Format: `JWT`.
    6. Allowed Scopes: `sfcc.inventory.availability`
    7. Määritä organisaatiollesi.
    8. Tallenna. **Kopioi asiakastunnus ja asiakassalaisuus** — salaisuus näytetään vain kerran.

    <Warning>
      SCAPI- ja OCAPI-asiakkaita ei voi jakaa. Jokainen API-kehys vaatii oman asiakkaansa.
    </Warning>

    **Vaihe 2 — Kerää esiintymätunnisteet**

    | Tunniste              | Mistä löytää                                                                  | Esimerkki                      |
    | --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
    | **Short Code**        | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78`                     |
    | **Organization ID**   | Sama sivu tai 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` |

    **Vaihe 3 — Lähetä tunnistetiedot Kleepille**

    * Asiakastunnus ja asiakassalaisuus
    * Short Code
    * Organization ID
    * Tenant ID
    * Location Group(s) (yksi per markkina — toimita kartoituksesi)
  </Tab>
</Tabs>
