> ## 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.
# Configurazione
> Preferenze del sito, servizi, certificati, job di esportazione e controlli stock in tempo reale
## Preferenze del Sito Personalizzate
Dopo l'importazione dei metadati, vai su **BM > Merchant Tools > Site Preferences > Custom Preferences**.
Seleziona **Kleep**:
| Preferenza | Descrizione |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **Obbligatorio.** Identificatore univoco per il tuo retailer sulla piattaforma Kleep, fornito dal tuo Account Manager Kleep. Deve essere inserito manualmente — viene inviato in ogni chiamata API Kleep e utilizzato come parametro `domain` dell'iframe di Raccomandazione per risolvere il tuo account. Nessun fallback automatico: se lasciato vuoto, il tracciamento, la funzionalità di Raccomandazione e l'iframe non funzioneranno (viene generato un errore di configurazione). |
| `isKleepRecommendationEnabled` | Abilita/disabilita il pulsante Kleep nella PDP. Non influisce sul tracciamento o sull'esportazione dei job. |
| `kleepButtonColor` | Colore del pulsante (Nero o Bianco). Sovrascrivibile tramite CSS per uno stile personalizzato. |
| `kleepFontFamily` | Font family per il pulsante Kleep e l'iFrame. |
| `kleepCountryCode` | Mercato / Codice Paese ([ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). |
## Servizi
Disponibili in **Administration > Operations > Services**:
**`kleep.sftp`** — Invia i file di esportazione da SFCC WebDAV all'SFTP Kleep. Sostituisci l'utente con quello fornito da Kleep, insieme al certificato `.p12`. Non impostare alcuna password.
**`kleep`** — Utilizzato per tutte le altre funzionalità. Non è necessario utente/password — la richiesta viene autenticata dalla preferenza del sito `kleepRetailerUUID`, inviata nel payload di ogni chiamata API Kleep per risolvere il tuo account.
## Chiave Privata e Certificato
Vai su **Administration > Operations > Private Keys and Certificates**:
1. Clicca su **Import**
2. Clicca su **Select** e scegli il file `.p12` fornito da Kleep
3. Usa `kleep` come alias
4. Clicca su **Save**
Il risultato dovrebbe apparire così — deve essere valido e denominato `kleep`:
## Job di Esportazione
Vai su **Administration > Operations > Jobs**. Sono preconfigurati due job:
* **KleepExportProductsCSV** — esporta i prodotti del tuo sito
* **KleepExportOrdersCSV** — esporta la cronologia degli ordini dei tuoi clienti
Entrambi sono **disabilitati per impostazione predefinita**. Abilitali per l'esecuzione una volta al giorno:
### Impostazioni comuni (entrambi i job)
Vai alla scheda **Job Steps** → clicca su **RefArch** per selezionare i siti dove utilizzi Kleep.
* **Timeout** — secondi prima di interrompere l'esportazione
* **OrdersMaxToExport** — numero massimo di ordini da esportare *(solo per il job degli ordini)*
### Impostazioni KleepExportProductsCSV
| Parametro | Descrizione | Predefinito |
| -------------- | --------------------------------------------------------------------------------- | ------------ |
| `SkipMaster` | Ignora le esportazioni dei prodotti master | Disabilitato |
| `OnlineOnly` | Esporta solo i prodotti online | Disabilitato |
| `ExportType` | Delta (solo aggiornati dall'ultima esportazione) o Full | Delta |
| `MainViewType` | Tipo di vista immagine per le immagini dei prodotti. Usa lo stesso della tua PDP. | `large` |
| `Locale` | Locale specifico per l'esportazione. Usa il predefinito se vuoto. | — |
Il numero di prodotti esportati può superare il numero di prodotti elaborati. Ciò accade quando i prodotti non categorizzati vengono inclusi tramite la loro associazione con un VariationGroup categorizzato.
Assicurati che il parametro **MainViewType** corrisponda alla configurazione del tuo negozio. Un tipo di vista non corrispondente porta a immagini di prodotto mancanti, richieste per l'analisi AI.
### KleepResetLastExported (job di utilità)
Un terzo job, **KleepResetLastExported**, viene fornito per forzare una **ri-esportazione completa degli ordini**. Il suo step `ResetKleepExportAttributes` cancella gli attributi di tracciamento dell'esportazione su ogni ordine (`kleepLastExported` → vuoto, `isKleepExported` → false) in modo che vengano acquisiti nuovamente alla prossima esecuzione di `KleepExportOrdersCSV`.
È **disabilitato per impostazione predefinita** e pensato per essere eseguito manualmente, su richiesta (es. dopo un reset dei dati lato Kleep). Non richiede parametri.
## Controlli Stock in Tempo Reale
Kleep interroga gli stock in tempo reale per evitare di raccomandare taglie esaurite. Configura l'accesso utilizzando **uno** dei due metodi seguenti.
Non sai quale scegliere? **OCAPI** è l'approccio tradizionale che utilizza la Data API di Business Manager. **SCAPI (IAS)** è la nuova Salesforce Commerce API con l'Inventory Availability Service. Chiedi al tuo amministratore Salesforce in caso di dubbi.
Usa questa opzione se la tua istanza si basa su **OCAPI** per la gestione dell'inventario.
**Passaggio 1 — Apri le Impostazioni OCAPI**
Vai su **Administration > Site Development > Open Commerce API Settings**, poi modifica le impostazioni dell'API **Data**.
**Passaggio 2 — Configura il Client ID**
Per i test:
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
Per la produzione, genera un nuovo client ID secondo la [documentazione Salesforce](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Guida video](https://www.youtube.com/watch?v=Z3cZlQHWjtM).
**Passaggio 3 — Configura l'Accesso alle Risorse**
Aggiungi questo alle tue configurazioni dell'API **Data** OCAPI:
```
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
```
**Passaggio 4 — Invia le credenziali a Kleep**
* Client ID
* Client Secret
* ID inventario (uno per mercato — fornisci la tua mappatura)
* URL SBX di produzione (i controlli stock sono abilitati solo in produzione)
Usa questa opzione se la tua istanza utilizza **SCAPI** con l'**Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI).
**Passaggio 1 — Crea un Client API**
1. Accedi a [Salesforce Account Manager](https://account.demandware.com).
2. Clicca su **API Client** → **Add API Client**.
3. Nome visualizzato: es. `Kleep Inventory`.
4. Token Endpoint Auth Method: `client_secret_post`.
5. Access Token Format: `JWT`.
6. Allowed Scopes: `sfcc.inventory.availability`
7. Assegna alla tua Organizzazione.
8. Salva. **Copia il Client ID e il Client Secret** — il secret viene mostrato una sola volta.
I client SCAPI e OCAPI non possono essere condivisi. Ogni framework API richiede il proprio client.
**Passaggio 2 — Raccogli gli identificatori dell'istanza**
| Identificatore | Dove trovarlo | Esempio |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | Stessa pagina, o 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` |
**Passaggio 3 — Invia le credenziali a Kleep**
* Client ID e Client Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s) (uno per mercato — fornisci la tua mappatura)