> ## Documentation Index > Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt > Use this file to discover all available pages before exploring further. # Konfiguracja > Preferencje witryny, usługi, certyfikaty, zadania eksportu i sprawdzanie stanów magazynowych na żywo ## Niestandardowe preferencje witryny Po zaimportowaniu metadanych przejdź do **BM > Merchant Tools > Site Preferences > Custom Preferences**. image.png Wybierz **Kleep**: image.png | 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)). | ## Usługi Dostępne w **Administration > Operations > Services**: image.png **`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. image.png **`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**: 1. Kliknij **Import** 2. Kliknij **Select** i wybierz plik `.p12` dostarczony przez Kleep 3. Użyj `kleep` jako aliasu 4. Kliknij **Save** image.png Wynik powinien wyglądać tak — musi być ważny i nazwany `kleep`: image.png ## 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 image.png Oba są **domyślnie wyłączone**. Włącz je, aby uruchamiały się raz dziennie: image.png ### 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ń)* image.png ### Ustawienia KleepExportProductsCSV image.png | 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. image.png ### 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. Użyj tego, jeśli Twoja instancja korzysta z **OCAPI** do zarządzania zapasami. **Krok 1 — Otwórz ustawienia OCAPI** Przejdź do **Administration > Site Development > Open Commerce API Settings**, a następnie edytuj ustawienia API **Data**. **Krok 2 — Skonfiguruj Client ID** Do testów: ``` "client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ``` Do produkcji wygeneruj nowy client ID zgodnie z [dokumentacją Salesforce](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5). [Instrukcja wideo](https://www.youtube.com/watch?v=Z3cZlQHWjtM). **Krok 3 — Skonfiguruj dostęp do zasobów** Dodaj 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** 1. Zaloguj się do [Salesforce Account Manager](https://account.demandware.com). 2. Kliknij **API Client** → **Add API Client**. 3. Nazwa wyświetlana: np. `Kleep Inventory`. 4. Token Endpoint Auth Method: `client_secret_post`. 5. Access Token Format: `JWT`. 6. Allowed Scopes: `sfcc.inventory.availability` 7. Przypisz do swojej organizacji. 8. 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)