Konfiguracja

Niestandardowe preferencje witryny

Po zaimportowaniu metadanych przejdź do BM > Merchant Tools > Site Preferences > Custom Preferences.

Screenshot — Custom Preferences menu

Wybierz Kleep:

Screenshot — Kleep preferences group

Preferencja	Opis
`kleepRetailerUUID`	Obowiązkowe. Unikalny identyfikator Twojego sprzedawcy na platformie Kleep, dostarczony przez Twojego Account Managera Kleep. Należy go wprowadzić ręcznie — jest wysyłany w każdym wywołaniu API Kleep i używany jako parametr `domain` elementu iframe rekomendacji w celu rozwiązania Twojego konta. Brak automatycznego fallbacku: jeśli pozostanie pusty, śledzenie, funkcja rekomendacji i iframe nie będą działać (zostanie zgłoszony błąd konfiguracji).
`isKleepRecommendationEnabled`	Włącz/wyłącz przycisk Kleep na PDP. Nie wpływa na śledzenie ani eksport zadań.
`kleepButtonColor`	Kolor przycisku (czarny lub biały). Zastąp za pomocą CSS dla niestandardowej stylizacji.
`kleepFontFamily`	Rodzina czcionek dla przycisku Kleep i iFrame.
`kleepCountryCode`	Kod rynku / kraju (ISO 3166 A-2).

Usługi

Dostępne w Administration > Operations > Services:

Screenshot — Services list

kleep.sftp — Wysyła pliki eksportu z SFCC WebDAV do Kleep SFTP. Zastąp użytkownika tym dostarczonym przez Kleep, wraz z certyfikatem .p12. Nie ustawiaj żadnego hasła.

Screenshot — kleep.sftp service details

kleep — Używane do wszystkich pozostałych funkcji. Nie jest wymagany żaden użytkownik/hasło — żądanie jest uwierzytelniane przez preferencję witryny kleepRetailerUUID, wysyłaną w ładunku każdego wywołania API Kleep w celu rozwiązania Twojego konta.

Klucz prywatny i certyfikat

Przejdź do Administration > Operations > Private Keys and Certificates:

Kliknij Import
Kliknij Select i wybierz plik .p12 dostarczony przez Kleep
Użyj kleep jako aliasu
Kliknij Save

Screenshot — Import certificate

Wynik powinien wyglądać tak — musi być ważny i nazwany kleep:

Screenshot — Imported certificate

Zadania eksportu

Przejdź do Administration > Operations > Jobs. Dwa zadania są wstępnie skonfigurowane:

KleepExportProductsCSV — eksportuje produkty Twojej witryny
KleepExportOrdersCSV — eksportuje historię zamówień Twoich klientów

Screenshot — Export jobs list

Oba są domyślnie wyłączone. Włącz je, aby uruchamiały się raz dziennie:

Screenshot — Enabling an export job

Wspólne ustawienia (oba zadania)

Przejdź do zakładki Job Steps → kliknij RefArch, aby wybrać witryny, w których używasz Kleep.

Timeout — sekundy przed zatrzymaniem eksportu
OrdersMaxToExport — maksymalna liczba zamówień do eksportu (tylko zadanie zamówień)

Screenshot — GenerateOrdersCSV step parameters

Ustawienia KleepExportProductsCSV

Screenshot — KleepExportProductsCSV job steps

Parametr	Opis	Domyślne
`SkipMaster`	Ignoruj eksport produktów głównych	Wyłączone
`OnlineOnly`	Eksportuj tylko produkty dostępne online	Wyłączone
`ExportType`	Delta (tylko zaktualizowane od ostatniego eksportu) lub Pełny	Delta
`MainViewType`	Typ widoku obrazu dla obrazów produktów. Użyj tego samego co na Twoim PDP.	`large`
`Locale`	Określony język eksportu. Używa domyślnego, jeśli puste.	—

Liczba eksportowanych produktów może przekraczać liczbę przetworzonych. Dzieje się tak, gdy nieskatalogowane produkty są uwzględniane poprzez ich powiązanie ze skatalogowaną VariationGroup.

Upewnij się, że parametr MainViewType pasuje do konfiguracji Twojego sklepu. Niedopasowany typ widoku prowadzi do brakujących obrazów produktów, które są wymagane do analizy 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 (zadanie pomocnicze)

Trzecie zadanie, KleepResetLastExported, jest dostarczane, aby wymusić pełny ponowny eksport zamówień. Jego krok ResetKleepExportAttributes czyści atrybuty śledzenia eksportu na każdym zamówieniu (kleepLastExported → puste, isKleepExported → false), dzięki czemu zostaną one ponownie uwzględnione przy następnym uruchomieniu KleepExportOrdersCSV. Jest domyślnie wyłączone i przeznaczone do ręcznego uruchamiania na żądanie (np. po resetowaniu danych po stronie Kleep). Nie przyjmuje żadnych parametrów.

Sprawdzanie stanów magazynowych na żywo

Kleep sprawdza stany magazynowe na żywo, aby uniknąć rekomendowania rozmiarów niedostępnych w magazynie. Skonfiguruj dostęp przy użyciu jednej z dwóch poniższych metod.

Nie wiesz, którą wybrać? OCAPI to tradycyjne podejście korzystające z Business Manager Data API. SCAPI (IAS) to nowszy Salesforce Commerce API z usługą dostępności zapasów (Inventory Availability Service). Zapytaj swojego administratora Salesforce, jeśli nie jesteś pewien.

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

Użyj tego, jeśli Twoja instancja korzysta z OCAPI do zarządzania zapasami.Krok 1 — Otwórz ustawienia OCAPIPrzejdź do Administration > Site Development > Open Commerce API Settings, a następnie edytuj ustawienia API Data.Krok 2 — Skonfiguruj Client IDDo testów:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Do produkcji wygeneruj nowy client ID zgodnie z dokumentacją Salesforce. Instrukcja wideo.Krok 3 — Skonfiguruj dostęp do zasobówDodaj to do konfiguracji Data API w OCAPI:

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

Krok 4 — Wyślij dane uwierzytelniające do Kleep

Client ID
Client Secret
Identyfikatory zapasów (jeden na rynek — podaj swoje mapowanie)
Produkcyjny adres URL SBX (sprawdzanie stanów magazynowych jest włączone tylko na produkcji)

Użyj tego, jeśli Twoja instancja używa SCAPI z Inventory Availability Service (IAS) / Omnichannel Inventory (OCI).Krok 1 — Utwórz klienta API

Zaloguj się do Salesforce Account Manager.
Kliknij API Client → Add API Client.
Nazwa wyświetlana: np. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Przypisz do swojej organizacji.
Zapisz. Skopiuj Client ID i Client Secret — tajny klucz jest wyświetlany tylko raz.

Klientów SCAPI i OCAPI nie można współdzielić. Każdy framework API wymaga własnego klienta.

Krok 2 — Zbierz identyfikatory instancji

Identyfikator	Gdzie go znaleźć	Przykład
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	Ta sama strona lub 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`

Krok 3 — Wyślij dane uwierzytelniające do Kleep

Client ID i Client Secret
Short Code
Organization ID
Tenant ID
Location Group(s) (jeden na rynek — podaj swoje mapowanie)

Witamy

CMS

Mobilne

Dane

Prywatność

Niestandardowe preferencje witryny

Usługi

Klucz prywatny i certyfikat

Zadania eksportu

Wspólne ustawienia (oba zadania)

Ustawienia KleepExportProductsCSV

KleepResetLastExported (zadanie pomocnicze)

Sprawdzanie stanów magazynowych na żywo

​Niestandardowe preferencje witryny

​Usługi

​Klucz prywatny i certyfikat

​Zadania eksportu

​Wspólne ustawienia (oba zadania)

​Ustawienia KleepExportProductsCSV

​KleepResetLastExported (zadanie pomocnicze)

​Sprawdzanie stanów magazynowych na żywo

Niestandardowe preferencje witryny

Usługi

Klucz prywatny i certyfikat

Zadania eksportu

Wspólne ustawienia (oba zadania)

Ustawienia KleepExportProductsCSV

KleepResetLastExported (zadanie pomocnicze)

Sprawdzanie stanów magazynowych na żywo