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

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

| **Rutter**                        | Detaljer                                       |
| --------------------------------- | ---------------------------------------------- |
| `/products/*`                     | Åtkomst till alla produktresurser              |
| `/categories/*`                   | Åtkomst till alla kategoriresurser             |
| `/orders/*`                       | Åtkomst till alla orderresurser                |
| `/returns/*`                      | Åtkomst till alla returresurser                |
| `/returnsAttributeMetadata/*`     | Åtkomst till alla returattributresurser        |
| `/returnsItemAttributeMetadata/*` | Åtkomst till alla returartikelattributresurser |
| `/creditmemos/*`                  | Åtkomst till alla kreditnotaresurser           |
| `/creditmemo/*`                   | Åtkomst till enskild kreditnotaresurs          |
| `/stockItems/*`                   | Åtkomst till alla lagerresurser                |
| `/store/*`                        | Åtkomst till alla butiksresurser               |
| `/inventory/*`                    | Åtkomst till alla inventeringsresurser         |
| `/customers/*`                    | Åtkomst till alla kundresurser                 |

**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](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Adobe official tutorial: Magento 2 OAuth authentication](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 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**](/sv/cms/js-library) 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](/sv/cookie-consent).