Configurazione

Preferenze del Sito Personalizzate

Dopo l’importazione dei metadati, vai su BM > Merchant Tools > Site Preferences > Custom Preferences.

Screenshot — Custom Preferences menu

Seleziona Kleep:

Screenshot — Kleep preferences group

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

Servizi

Disponibili in Administration > Operations > Services:

Screenshot — Services list

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.

Screenshot — kleep.sftp service details

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:

Clicca su Import
Clicca su Select e scegli il file .p12 fornito da Kleep
Usa kleep come alias
Clicca su Save

Screenshot — Import certificate

Il risultato dovrebbe apparire così — deve essere valido e denominato kleep:

Screenshot — Imported certificate

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

Screenshot — Export jobs list

Entrambi sono disabilitati per impostazione predefinita. Abilitali per l’esecuzione una volta al giorno:

Screenshot — Enabling an export job

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)

Screenshot — GenerateOrdersCSV step parameters

Impostazioni KleepExportProductsCSV

Screenshot — KleepExportProductsCSV job steps

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.

Screenshot — SFTPUpload step parameters (products)

The TargetFolder parameter of each SFTP upload step must match the folder structure expected by Kleep’s ingestion pipeline. For example, a dev store might use dev/products instead of products. See the SFTP Data Structure documentation for the complete directory layout.

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.

OCAPI (Open Commerce API)
SCAPI — Inventory Availability Service (IAS)

Usa questa opzione se la tua istanza si basa su OCAPI per la gestione dell’inventario.Passaggio 1 — Apri le Impostazioni OCAPIVai su Administration > Site Development > Open Commerce API Settings, poi modifica le impostazioni dell’API Data.Passaggio 2 — Configura il Client IDPer i test:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Per la produzione, genera un nuovo client ID secondo la documentazione Salesforce. Guida video.Passaggio 3 — Configura l’Accesso alle RisorseAggiungi 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

Accedi a Salesforce Account Manager.
Clicca su API Client → Add API Client.
Nome visualizzato: es. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Assegna alla tua Organizzazione.
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)

Benvenuto

CMS

Mobile

Dati

Privacy

Preferenze del Sito Personalizzate

Servizi

Chiave Privata e Certificato