Konfiguration

Brugerdefinerede sitepræferencer

Efter metadataimport skal du gå til BM > Merchant Tools > Site Preferences > Custom Preferences.

Screenshot — Custom Preferences menu

Vælg Kleep:

Screenshot — Kleep preferences group

Præference	Beskrivelse
`kleepRetailerUUID`	Obligatorisk. Unik identifikator for din forhandler på Kleep-platformen, leveret af din Kleep Account Manager. Skal indtastes manuelt — den sendes i hvert Kleep API-kald og bruges som `domain`-parameteren i anbefalings-iframe’en til at løse din konto. Ingen automatisk fallback: hvis den efterlades tom, fungerer sporing, anbefalingsfunktionen og iframe’en ikke (en konfigurationsfejl opstår).
`isKleepRecommendationEnabled`	Aktivér/deaktivér Kleep-knappen på PDP. Påvirker ikke sporing eller jobeksport.
`kleepButtonColor`	Knapfarve (Sort eller Hvid). Tilsidesæt via CSS for brugerdefineret styling.
`kleepFontFamily`	Skrifttype til Kleep-knappen og iFrame.
`kleepCountryCode`	Marked / Landekode (ISO 3166 A-2).

Services

Findes i Administration > Operations > Services:

Screenshot — Services list

kleep.sftp — Sender eksportfiler fra SFCC WebDAV til Kleep SFTP. Erstat brugeren med den leveret af Kleep, sammen med .p12-certifikatet. Angiv ingen adgangskode.

Screenshot — kleep.sftp service details

kleep — Bruges til alle andre funktioner. Ingen bruger/adgangskode nødvendig — anmodningen autentificeres af sitepræferencen kleepRetailerUUID, sendt i payloaden for hvert Kleep API-kald til at løse din konto.

Privat nøgle & certifikat

Gå til Administration > Operations > Private Keys and Certificates:

Klik på Import
Klik på Select og vælg .p12-filen leveret af Kleep
Brug kleep som alias
Klik på Save

Screenshot — Import certificate

Resultatet bør se sådan ud — det skal være gyldigt og navngivet kleep:

Screenshot — Imported certificate

Eksportjobs

Gå til Administration > Operations > Jobs. To jobs er forudkonfigurerede:

KleepExportProductsCSV — eksporterer dit sites produkter
KleepExportOrdersCSV — eksporterer dine kunders ordrehistorik

Screenshot — Export jobs list

Begge er deaktiveret som standard. Aktivér dem til at køre én gang om dagen:

Screenshot — Enabling an export job

Fælles indstillinger (begge jobs)

Gå til fanen Job Steps → klik på RefArch for at vælge de sites, hvor du bruger Kleep.

Timeout — sekunder inden eksporten stoppes
OrdersMaxToExport — maks. ordrer til eksport (kun ordrejob)

Screenshot — GenerateOrdersCSV step parameters

KleepExportProductsCSV-indstillinger

Screenshot — KleepExportProductsCSV job steps

Parameter	Beskrivelse	Standard
`SkipMaster`	Ignorer masterprodukteksporter	Deaktiveret
`OnlineOnly`	Eksportér kun online produkter	Deaktiveret
`ExportType`	Delta (kun opdateret siden sidste eksport) eller Fuld	Delta
`MainViewType`	Billedvisningstype for produktbilleder. Brug den samme som din PDP.	`large`
`Locale`	Specifik locale for eksport. Bruger standard, hvis tom.	—

Antallet af eksporterede produkter kan overstige antallet af behandlede. Dette sker, når ukategoriserede produkter medtages via deres tilknytning til en kategoriseret VariationGroup.

Sørg for, at parameteren MainViewType svarer til din butiks konfiguration. En forkert visningstype fører til manglende produktbilleder, som er påkrævet til 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 (hjælpejob)

Et tredje job, KleepResetLastExported, leveres for at tvinge en fuld re-eksport af ordrer. Dets ResetKleepExportAttributes-trin rydder eksportsporingsattributterne på alle ordrer (kleepLastExported → tom, isKleepExported → false), så de hentes igen ved næste KleepExportOrdersCSV-kørsel. Det er deaktiveret som standard og beregnet til at køres manuelt, efter behov (f.eks. efter en Kleep-side dataréset). Det tager ingen parametre.

Live lagertjek

Kleep forespørger lagerbeholdning live for at undgå at anbefale udsolgte størrelser. Konfigurér adgang ved hjælp af én af de to metoder nedenfor.

Er du usikker på, hvilken du skal vælge? OCAPI er den traditionelle tilgang ved brug af Business Manager Data API. SCAPI (IAS) er den nyere Salesforce Commerce API med Inventory Availability Service. Spørg din Salesforce-administrator, hvis du er usikker.

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

Brug dette, hvis din instans benytter OCAPI til lagerstyring.Trin 1 — Åbn OCAPI-indstillingerNaviger til Administration > Site Development > Open Commerce API Settings, og rediger Data API-indstillingerne.Trin 2 — Opsæt Client IDTil test:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Til produktion skal du generere et nyt client ID jf. Salesforce-dokumentationen. Videogennemgang.Trin 3 — Konfigurér ressourceadgangTilføj dette til dine OCAPI Data API-konfigurationer:

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

Trin 4 — Send legitimationsoplysninger til Kleep

Client ID
Client Secret
Inventory IDs (én pr. marked — angiv din kortlægning)
Produktions-SBX URL (lagertjek er kun aktiveret i produktion)

Brug dette, hvis din instans bruger SCAPI med Inventory Availability Service (IAS) / Omnichannel Inventory (OCI).Trin 1 — Opret en API Client

Log ind på Salesforce Account Manager.
Klik på API Client → Add API Client.
Vist navn: f.eks. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Tildel til din organisation.
Gem. Kopiér Client ID og Client Secret — hemmeligheden vises kun én gang.

SCAPI- og OCAPI-klienter kan ikke deles. Hvert API-framework kræver sin egen klient.

Trin 2 — Saml instansidentifikatorer

Identifikator	Hvor finder du det	Eksempel
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	Samme side, eller 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`

Trin 3 — Send legitimationsoplysninger til Kleep

Client ID & Client Secret
Short Code
Organization ID
Tenant ID
Location Group(s) (én pr. marked — angiv din kortlægning)

Velkommen

CMS

Mobil

Data

Privatliv

Brugerdefinerede sitepræferencer

Services

Privat nøgle & certifikat