Configuratie

Aangepaste sitevoorkeuren

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

Screenshot — Custom Preferences menu

Selecteer Kleep:

Screenshot — Kleep preferences group

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

Services

Te vinden in Administration > Operations > Services:

Screenshot — Services list

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.

Screenshot — kleep.sftp service details

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:

Klik op Import
Klik op Select en kies het .p12-bestand verstrekt door Kleep
Gebruik kleep als alias
Klik op Save

Screenshot — Import certificate

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

Screenshot — Imported certificate

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

Screenshot — Export jobs list

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

Screenshot — Enabling an export job

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)

Screenshot — GenerateOrdersCSV step parameters

Instellingen KleepExportProductsCSV

Screenshot — KleepExportProductsCSV job steps

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

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.

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.

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

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.

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

Gebruik dit als uw instantie op OCAPI vertrouwt voor voorraadbeheer.Stap 1 — Open OCAPI-instellingenNavigeer naar Administration > Site Development > Open Commerce API Settings en bewerk vervolgens de Data API-instellingen.Stap 2 — Client-ID instellenVoor testen:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Genereer voor productie een nieuw client-ID volgens de Salesforce-documentatie. Video-walkthrough.Stap 3 — Resourcetoegang configurerenVoeg 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)

Gebruik dit als uw instantie SCAPI gebruikt met de Inventory Availability Service (IAS) / Omnichannel Inventory (OCI).Stap 1 — Een API-client aanmaken

Log in op Salesforce Account Manager.
Klik op API Client → Add API Client.
Weergavenaam: bijv. Kleep Inventory.
Token Endpoint-verificatiemethode: client_secret_post.
Toegangstoken-formaat: JWT.
Toegestane scopes: sfcc.inventory.availability
Wijs toe aan uw organisatie.
Opslaan. Kopieer de Client-ID en Client Secret — het geheim wordt slechts één keer weergegeven.

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

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)

Welkom

CMS

Mobiel

Gegevens

Privacy

Aangepaste sitevoorkeuren

Services

Privésleutel & Certificaat