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

## Vaihe 1: Backend-konfiguraatio (OAuth1 API)

*Tämä vaihe mahdollistaa Kleepin hakea tuoteluettelosi, tilaushistoriasi ja palautustiedot algoritmin kalibroimiseksi.*

### 1. Luo OAuth1-integraatio

1. Kirjaudu sisään **Magento-hallintapaneeliin**.
2. Siirry kohtaan **System > Integrations**.
3. Napsauta **"Add New Integration"**.
4. Täytä **Name**-kenttä (esim. "Kleep Integration").
5. Syötä **Admin Password** vahvistukseksi.

### 2. Konfiguroi API-käyttöoikeudet

| **Reitit**                        | Tiedot                                             |
| --------------------------------- | -------------------------------------------------- |
| `/products/*`                     | Pääsy kaikkiin tuoteresursseihin                   |
| `/categories/*`                   | Pääsy kaikkiin kategoriresursseihin                |
| `/orders/*`                       | Pääsy kaikkiin tilausresursseihin                  |
| `/returns/*`                      | Pääsy kaikkiin palautusresursseihin                |
| `/returnsAttributeMetadata/*`     | Pääsy kaikkiin palautusattribuuttiresursseihin     |
| `/returnsItemAttributeMetadata/*` | Pääsy kaikkiin palautuskohdattribuuttiresursseihin |
| `/creditmemos/*`                  | Pääsy kaikkiin hyvityslaskuresursseihin            |
| `/creditmemo/*`                   | Pääsy yksittäisiin hyvityslaskuresursseihin        |
| `/stockItems/*`                   | Pääsy kaikkiin varastoresursseihin                 |
| `/store/*`                        | Pääsy kaikkiin myymäläresursseihin                 |
| `/inventory/*`                    | Pääsy kaikkiin inventaarioresursseihin             |
| `/customers/*`                    | Pääsy kaikkiin asiakasresursseihin                 |

**Tämän tulee vastata seuraavia ACL:iä Magentossa**:

* `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`

**⚠️ Tärkeää:**

* Jos Magento-instanssisi tarjoaa lisäkerroksia tai mukautettuja päätepisteitä (esim. mukautettuja palautus-/RMA-API:ja), koordinoi kanssamme.
* Jos käytät ulkoista palautusjärjestelmää ilman integraatiota Magento-API:n kautta, katso palautustietodokumentaatio tai koordinoi kanssamme oikean integrointimenetelmän valitsemiseksi.

### 3. Aktivoi ja hae tunnistetiedot

1. Napsauta **"Save"** integraation luomiseksi.
2. Napsauta **"Activate"** juuri luodusta integraatiosta.
3. Ponnahdusikkuna näyttää **OAuth-tunnistetietosi**:
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret
4. **Kopioi nämä tunnistetiedot** — sinun on lähetettävä ne Kleep-yhteyshenkilöllesi.

Ohjeita Magento 2 API -tunnistetietojen luomiseen ja hakemiseen löydät täältä:

> [Subscribe Pro -opas: Luo ja hae Magento 2 API -tunnistetiedot](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Adoben virallinen opas: Magento 2 OAuth-todennus](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 4. Lähetä tunnistetiedot Kleepille

Lähetä seuraavat tiedot Kleep-yhteyshenkilöllesi sähköpostitse:

1. **Anna kaupan/kauppojen täydellinen API-pohja-URL.**
2. **OAuth1-tunnistetiedot**
   * Consumer Key
   * Consumer Secret
   * Access Token
   * Access Token Secret

***

## Vaihe 2: Frontend-integraatio (Widget)

*Tässä vaiheessa lisätään Kleep-skripti tuotesivuillesi (PDP). Yhteensopiva kaikkien Magento-versioiden kanssa.*

Seuraa [**JS Library Widget -opastamme**](/fi/cms/js-library) asentaaksesi ja konfiguroimalla frontend-CTA tuotesivuillesi.

***

## Vaihe 3: Puuttuvien tietojen hallinta (SFTP)

*Tämä osio koskee tilanteita, joissa tietoja ei voida hakea standardien API-päätepisteiden kautta.*

Jos Magento-API ei salli palautusten tai tiettyjen erityistietojen hakemista, etenemme CSV-tiedostonvaihdolla.

Katso alla olevasta dokumentaatiosta. Tämä opas ohjaa sinut puuttuvien tietojen välittämisprosessin läpi askel askeleelta:

***

## **Vaihe 4: Validointi ja tuotantoympäristöön siirtyminen**

### 1. Testiympäristö

Ota käyttöön ensin **Preprod/Staging**-ympäristössäsi.

### 2. Visuaalinen validointi

Ennen julkaisua varmista seuraavat:

* Näkyykö painike oikein?
* Avautuuko napsauttaminen ponnahdusikkunan (Drawer)?
* Ei "CORS"-virheitä selaimen konsolissa?

### 3. Julkaisu

Kun sinä ja Kleep-tiimi olette vahvistaneet, ota muutokset käyttöön **tuotanto**-teemassasi.---

## Evästeet ja tietosuoja

Kleep on täysin kävijän suostumuksen alainen: skripti latautuu vasta **sen jälkeen**, kun suostumus on kerätty CMP:n kautta, ja sinun on ehdollistettava sen lataaminen vastaavasti. Täydellinen luettelo seuraimista, käsitellyistä tiedoista, tarkoituksista ja oikeusperusteista, isännöinnistä, alitoimittajista ja tietoturvasta löytyy täältä: [Evästeet, CMP ja tietosuoja](/fi/cookie-consent).