Konfiguraatio

Mukautetut sivuasetukset

Metatietojen tuonnin jälkeen siirry kohtaan BM > Merchant Tools > Site Preferences > Custom Preferences.

Valitse Kleep:

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

Palvelut

Löytyy kohdasta Administration > Operations > Services:

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.

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:

Napsauta Import
Napsauta Select ja valitse Kleepin toimittama .p12-tiedosto
Käytä kleep aliaksena
Napsauta Save

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

Vientityöt

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

KleepExportProductsCSV — vie sivustosi tuotteet
KleepExportOrdersCSV — vie asiakkaidesi tilaushistorian

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

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

KleepExportProductsCSV-asetukset

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

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

Varmista, että MainViewType-parametri vastaa kauppasi konfiguraatiota. Väärä näkymätyyppi johtaa puuttuviin tuotekuviin, joita tarvitaan tekoälyanalyysiä varten.

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

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.

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

Käytä tätä, jos esiintymäsi perustuu OCAPI:in varastonhallinnassa.Vaihe 1 — Avaa OCAPI-asetuksetSiirry kohtaan Administration > Site Development > Open Commerce API Settings ja muokkaa Data API -asetuksia.Vaihe 2 — Määritä asiakastunnusTestausta varten:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Tuotantoa varten luo uusi asiakastunnus Salesforce-dokumentaation mukaan. Videoläpikäynti.Vaihe 3 — Konfiguroi resurssien käyttöoikeusLisää 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)

Käytä tätä, jos esiintymäsi käyttää SCAPI:a Inventory Availability Servicen (IAS) / Omnichannel Inventoryn (OCI) kanssa.Vaihe 1 — Luo API-asiakas

Kirjaudu sisään Salesforce Account Manageriin.
Napsauta API Client → Add API Client.
Näyttönimi: esim. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Määritä organisaatiollesi.
Tallenna. Kopioi asiakastunnus ja asiakassalaisuus — salaisuus näytetään vain kerran.

SCAPI- ja OCAPI-asiakkaita ei voi jakaa. Jokainen API-kehys vaatii oman asiakkaansa.

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)

Tervetuloa

CMS

Mobiili

Hallintapaneeli

Tiedot

Tietosuoja

Mukautetut sivuasetukset

Palvelut

Yksityinen avain ja sertifikaatti