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

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 Oficjalny samouczek Adobe: Uwierzytelnianie OAuth Magento 2

​

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