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

## Fase 1: Backendconfiguratie (OAuth1 API)

*Deze stap stelt Kleep in staat uw productcatalogus, ordergeschiedenis en retourgegevens op te halen om het algoritme te kalibreren.*

### 1. OAuth1-integratie aanmaken

1. Meld u aan bij uw **Magento-beheerderspaneel**.
2. Ga naar **System > Integrations**.
3. Klik op **"Add New Integration"**.
4. Vul het veld **Name** in (bijv. "Kleep Integration").
5. Voer uw **Admin Password** in ter bevestiging.

### 2. API-machtigingen configureren

| **Routes**                        | Details                                      |
| --------------------------------- | -------------------------------------------- |
| `/products/*`                     | Toegang tot alle productbronnen              |
| `/categories/*`                   | Toegang tot alle categoriebronnen            |
| `/orders/*`                       | Toegang tot alle bestellingsbronnen          |
| `/returns/*`                      | Toegang tot alle retourbronnen               |
| `/returnsAttributeMetadata/*`     | Toegang tot alle retourkenmerkbronnen        |
| `/returnsItemAttributeMetadata/*` | Toegang tot alle retourartikelkenmerkbronnen |
| `/creditmemos/*`                  | Toegang tot alle creditnotabronnen           |
| `/creditmemo/*`                   | Toegang tot een enkele creditnotabron        |
| `/stockItems/*`                   | Toegang tot alle voorraadbronnen             |
| `/store/*`                        | Toegang tot alle winkelbronnen               |
| `/inventory/*`                    | Toegang tot alle voorraadbeheersbronnen      |
| `/customers/*`                    | Toegang tot alle klantbronnen                |

**Dit moet overeenkomen met de volgende ACL's in 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`

**⚠️ Belangrijk:**

* Als uw Magento-instantie aanvullende API-lagen of aangepaste eindpunten blootstelt (bijvoorbeeld aangepaste retour/RMA API's), neem dan contact met ons op.
* Als u een externe retourprovider gebruikt zonder integratie via de Magento API, raadpleeg dan de documentatie over retourgegevens of neem contact met ons op om de juiste integratiemethode te kiezen.

### 3. Activeren en referenties ophalen

1. Klik op **"Save"** om de integratie aan te maken.
2. Klik op **"Activate"** bij de nieuw aangemaakte integratie.
3. Een pop-up toont uw **OAuth-referenties**:
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret
4. **Kopieer deze referenties** – u moet ze doorsturen naar uw Kleep-contactpersoon.

Raadpleeg de volgende bronnen voor hulp bij het aanmaken en ophalen van Magento 2 API-referenties:

> [Subscribe Pro-handleiding: Magento 2 API-referenties aanmaken en ophalen](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Officiële Adobe-handleiding: Magento 2 OAuth-authenticatie](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 4. Referenties naar Kleep sturen

Stuur de volgende informatie via e-mail naar uw Kleep-contactpersoon:

1. **Geef de volledige API-basis-URL('s) op voor de winkel(s).**
2. **OAuth1-referenties**
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret

***

## Fase 2: Frontend-integratie (Widget)

*Deze stap omvat het toevoegen van het Kleep-script aan uw productpagina's (PDP). Compatibel met alle versies van Magento.*

Volg onze [**JS Library Widget-gids**](/nl/cms/js-library) om de front-end CTA op uw productpagina's te installeren en configureren.

***

## Fase 3: Beheer van ontbrekende gegevens (SFTP)

*Deze sectie is van toepassing wanneer gegevens niet kunnen worden opgehaald via standaard API-eindpunten.*

Als uw Magento API het ophalen van retouren of bepaalde specifieke gegevens niet toestaat, werken we via CSV-bestandsuitwisseling.

Raadpleeg de onderstaande documentatie. Deze gids begeleidt u stap voor stap door het proces van het verzenden van ontbrekende gegevens:

***

## **Fase 4: Validatie & Productie-uitrol**

### 1. Testomgeving

Implementeer eerst op uw **Preprod/Staging**-omgeving.

### 2. Visuele validatie

Controleer het volgende voordat u live gaat:

* Wordt de knop correct weergegeven?
* Opent een klik het pop-upvenster (Drawer)?
* Geen "CORS"-fouten in de browserconsole?

### 3. Live gaan

Na validatie door u en het Kleep-team, implementeert u de wijzigingen in uw **Productie**-thema.---

## Cookies & gegevensprivacy

Kleep is volledig afhankelijk van de toestemming van de bezoeker: het script wordt pas geladen **nadat** toestemming is verzameld via uw CMP, en u moet het laden hiervan dienovereenkomstig conditioneren. Zie [Cookies, CMP & Gegevensprivacy](/nl/cookie-consent) voor de volledige lijst van trackers, de verwerkte gegevens, de doeleinden en rechtsgrondslagen, hosting, subverwerkers en beveiliging.