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

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 Adoben virallinen opas: Magento 2 OAuth-todennus

​

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