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

# WShop

## **Faza 1: Konfiguracja backendu (dostęp do API)**

*Ten krok umożliwia Kleep pobieranie katalogu produktów, historii zamówień i danych dotyczących zwrotów w celu kalibracji algorytmu.*

**1. Podaj dane uwierzytelniające API**

Udostępnij swojemu kontaktowi w Kleep następujące dane uwierzytelniające:

* **Adres URL API**
* **Nazwa użytkownika**
* **Hasło**

**2. Autoryzuj wymagane punkty końcowe API**

Po udzieleniu dostępu nasz zespół pobierze niezbędne dane z poniższych punktów końcowych. Upewnij się, że mamy do nich autoryzację:

* `/products/get` (import produktów)
* `/sizes/get` (import produktów)
* `/returns/getreasons` (import zamówień)
* `/returns/get` (import zwrotów)
* `/orders/get` (import zamówień)
* `/departments/get` (import produktów)
* `/authentificate` (sprawdzenie uwierzytelniania)
* `/attributes/get`

**3. Udostępnij dane uwierzytelniające**

Wyślij dane uwierzytelniające API do swojego kontaktu w Kleep pocztą elektroniczną.

***

## **Faza 2: Integracja frontendowa (Widget)**

*Ten krok polega na dodaniu skryptu Kleep do stron produktów (PDP). Kompatybilny ze wszystkimi wersjami WSHOP.*

Postępuj zgodnie z naszym [**przewodnikiem Widget JS Library**](/pl/cms/js-library), aby zainstalować i skonfigurować CTA frontendowe na stronach produktów.

***

## **Faza 3: Obsługa brakujących danych (SFTP)**

*Jeśli API WSHOP nie umożliwia pobierania zwrotów lub pewnych określonych danych, korzystamy z wymiany plików CSV.*

Zapoznaj się z poniższą dokumentacją. Przeprowadzi Cię krok po kroku przez proces przesłania nam brakujących danych.

***

## **Faza 4: Walidacja i uruchomienie produkcyjne**

1. **Środowisko testowe:**
   * Wdróż najpierw na środowisku **Preprod/Staging**.
2. **Walidacja wizualna:**
   * Czy przycisk wyświetla się poprawnie?
   * Czy kliknięcie otwiera wyskakujące okienko (Drawer)?
   * Brak błędów „CORS" w konsoli przeglądarki?
3. **Uruchomienie produkcyjne:**
   * Po zatwierdzeniu przez Ciebie i zespół Kleep, wdróż zmiany na swoim środowisku **produkcyjnym**.

***

## **Informacje dodatkowe**

### Konfiguracja produktów

Przed integracją podaj następujące informacje:

* **Wewnętrzne odniesienie do produktu:**
  * Czy posiadasz specyficzny dla marki kod referencyjny dla każdego produktu, różny od domyślnego identyfikatora produktu używanego przez WSHOP?
* **Grupowanie produktów według wariantów kolorystycznych:**
  * Czy masz produkty, które dzielą te same rozmiary, ale są rozmieszczone na wielu stronach produktów (np. różne kolory)? Jeśli tak, w jaki sposób możemy zidentyfikować odniesienie nadrzędne wspólne dla wszystkich wariantów kolorystycznych?
* **Wymiary produktów:**
  * Czy wymiary produktów są dostępne w Twoim katalogu? Jeśli tak, możemy udostępnić Ci szablon do uzupełnienia w celu uzyskania dokładniejszych rekomendacji.

### Obsługiwane języki

Kleep obsługuje następujące języki: fr, en, de, it, ja, ko, pt, br, es, pl, sv, da, nl, fi.

Potwierdź, których języków potrzebujesz w swoim sklepie.---

## Pliki cookie i prywatność danych

Kleep jest w pełni uzależniony od zgody odwiedzającego: skrypt ładuje się **wyłącznie po** zebraniu zgody przez Twoją CMP i musisz odpowiednio warunkować jego ładowanie. Pełną listę trackerów, przetwarzanych danych, celów i podstaw prawnych, hostingu, podprzetwórców i zabezpieczeń znajdziesz w [Pliki cookie, CMP i prywatność danych](/pl/cookie-consent).