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

# Magento

## Faza 1: Konfiguracja backendu (OAuth1 API)

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

### 1. Utwórz integrację OAuth1

1. Zaloguj się do **panelu administracyjnego Magento**.
2. Przejdź do **System > Integracje**.
3. Kliknij **„Dodaj nową integrację"**.
4. Wypełnij pole **Nazwa** (np. „Kleep Integration").
5. Wprowadź **hasło administratora** w celu potwierdzenia.

### 2. Skonfiguruj uprawnienia API

| **Ścieżki**                       | Szczegóły                                              |
| --------------------------------- | ------------------------------------------------------ |
| `/products/*`                     | Dostęp do wszystkich zasobów produktów                 |
| `/categories/*`                   | Dostęp do wszystkich zasobów kategorii                 |
| `/orders/*`                       | Dostęp do wszystkich zasobów zamówień                  |
| `/returns/*`                      | Dostęp do wszystkich zasobów zwrotów                   |
| `/returnsAttributeMetadata/*`     | Dostęp do wszystkich zasobów atrybutów zwrotów         |
| `/returnsItemAttributeMetadata/*` | Dostęp do wszystkich zasobów atrybutów pozycji zwrotów |
| `/creditmemos/*`                  | Dostęp do wszystkich zasobów faktur korygujących       |
| `/creditmemo/*`                   | Dostęp do pojedynczego zasobu faktury korygującej      |
| `/stockItems/*`                   | Dostęp do wszystkich zasobów magazynowych              |
| `/store/*`                        | Dostęp do wszystkich zasobów sklepu                    |
| `/inventory/*`                    | Dostęp do wszystkich zasobów inwentarza                |
| `/customers/*`                    | Dostęp do wszystkich zasobów klientów                  |

**Powinno to odpowiadać następującym ACL w Magento**:

* `Magento_Catalog::products`
* `Magento_Catalog::categories`
* `Magento_Sales::sales`
* `Magento_Sales::creditmemo`
* `Magento_Sales::actions_view`
* `Magento_Rma::rma`
* `Magento_Rma::magento_rma`
* `Magento_Rma::rma_attributes`
* `Vendor_Module::returns`
* `Magento_CatalogInventory::cataloginventory`
* `Magento_Store::store`
* `Magento_Config::config`
* `Magento_Inventory::inventory`
* `Magento_Customer::customer`

**⚠️ Ważne:**

* Jeśli Twoja instancja Magento udostępnia dodatkowe warstwy API lub niestandardowe punkty końcowe (np. niestandardowe API zwrotów/RMA), prosimy o koordynację z nami.
* Jeśli korzystasz z zewnętrznego dostawcy zwrotów bez integracji przez API Magento, zapoznaj się z dokumentacją danych dotyczących zwrotów lub skontaktuj się z nami w celu wybrania właściwej metody integracji.

### 3. Aktywuj i pobierz dane uwierzytelniające

1. Kliknij **„Zapisz"**, aby utworzyć integrację.
2. Kliknij **„Aktywuj"** na nowo utworzonej integracji.
3. W wyskakującym oknie zostaną wyświetlone **dane uwierzytelniające OAuth**:
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret
4. **Skopiuj te dane uwierzytelniające** — będziesz musiał przesłać je do swojego kontaktu w Kleep.

Aby uzyskać wskazówki dotyczące tworzenia i pobierania danych uwierzytelniających API Magento 2, zapoznaj się z:

> [Samouczek Subscribe Pro: Tworzenie i pobieranie danych uwierzytelniających API Magento 2](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Oficjalny samouczek Adobe: Uwierzytelnianie OAuth Magento 2](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 4. Wyślij dane uwierzytelniające do Kleep

Wyślij następujące informacje do swojego kontaktu w Kleep pocztą elektroniczną:

1. **Podaj pełne bazowe adresy URL API dla sklepu (sklepów).**
2. **Dane uwierzytelniające OAuth1**
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret

***

## Faza 2: Integracja frontendowa (Widget)

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

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: Zarządzanie brakującymi danymi (SFTP)

*Ta sekcja dotyczy sytuacji, gdy danych nie można pobrać przez standardowe punkty końcowe API.*

Jeśli API Magento nie umożliwia pobierania zwrotów lub pewnych określonych danych, realizujemy wymianę plików CSV.

Zapoznaj się z poniższą dokumentacją. Niniejszy przewodnik przeprowadzi Cię przez proces przekazywania brakujących danych krok po kroku:

***

## **Faza 4: Walidacja i wdrożenie produkcyjne**

### 1. Środowisko testowe

Wdróż najpierw na swoim środowisku **Preprod/Staging**.

### 2. Walidacja wizualna

Przed uruchomieniem produkcyjnym sprawdź:

* 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óż modyfikacje na swoim motywie **produkcyjnym**.---

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