Magento

​

Fas 1: Serverdelskonfiguration (OAuth1 API)

Det här steget gör det möjligt för Kleep att hämta din produktkatalog, orderhistorik och returdata för att kalibrera algoritmen.

​

1. Skapa OAuth1-integration

1. Logga in på din Magento Admin Panel.
2. Navigera till System > Integrations.
3. Klicka på “Add New Integration”.
4. Fyll i fältet Name (t.ex. “Kleep Integration”).
5. Ange ditt Admin Password för att bekräfta.

​

2. Konfigurera API-behörigheter

Detta bör motsvara följande ACL:er i 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

⚠️ Viktigt:

• Om din Magento-instans exponerar ytterligare API-lager eller anpassade endpoints (till exempel anpassade retur/RMA-API:er), vänligen koordinera med oss.
• Om du använder en extern returtjänst utan integration via Magento API, se returdata-dokumentationen eller koordinera med oss för att välja rätt integrationsmetod.

​

3. Aktivera och hämta autentiseringsuppgifter

1. Klicka på “Save” för att skapa integrationen.
2. Klicka på “Activate” på den nyligen skapade integrationen.
3. En popup visas med dina OAuth-uppgifter:
   • Consumer Key
   • Consumer Secret
   • Access Token
   • Access Token Secret
4. Kopiera dessa uppgifter – du måste skicka dem till din Kleep-kontakt.

För vägledning om att skapa och hämta Magento 2 API-uppgifter, se:

Subscribe Pro tutorial: Create and get Magento 2 API credentials Adobe official tutorial: Magento 2 OAuth authentication

​

4. Skicka uppgifter till Kleep

Vänligen skicka följande information till din Kleep-kontakt via e-post:

1. Ange den fullständiga API-bas-URL:en (URL:erna) för butiken (butikerna).
2. OAuth1-uppgifter
   • Consumer Key
   • Consumer Secret
   • Access Token
   • Access Token Secret

---

​

Fas 2: Frontendintegration (Widget)

Det här steget innebär att Kleep-skriptet läggs till på dina produktsidor (PDP). Kompatibelt med alla versioner av Magento. Följ vår guide för JS Library Widget för att installera och konfigurera frontend-CTA:n på dina produktsidor.

---

​

Fas 3: Hantering av saknad data (SFTP)

Det här avsnittet gäller när data inte kan hämtas via standard API-endpoints. Om ditt Magento API inte tillåter hämtning av returer eller viss specifik data, använder vi CSV-filutbyte. Se dokumentationen nedan. Den här guiden leder dig steg för steg genom processen att överföra saknad data:

---

​

Fas 4: Validering och produktionsdriftsättning

​

1. Testmiljö

Driftsätt först i din Preprod/Staging-miljö.

​

2. Visuell validering

Verifiera följande innan du går live:

• Visas knappen korrekt?
• Öppnar ett klick popup:en (Drawer)?
• Inga “CORS”-fel i webbläsarkonsolen?

​

3. Driftsättning

När det har validerats av dig och Kleep-teamet, driftsätt ändringarna i ditt Production-tema.---

​

Cookies och dataintegritet

Kleep helt styrs av besökarens samtycke: skriptet laddas bara efter att samtycke har samlats in via din CMP, och du måste villkora laddningen därefter. För den fullständiga listan över spårare, behandlad data, ändamål och rättsliga grunder, hosting, underbiträden och säkerhet, se Cookies, CMP och dataintegritet.