Spring til hovedindhold

Fase 1: Backendkonfiguration (OAuth1 API)

Dette trin giver Kleep mulighed for at hente dit produktkatalog, ordrehistorik og returdata for at kalibrere algoritmen.

1. Opret OAuth1-integration

  1. Log ind på dit Magento Admin Panel.
  2. Naviger til System > Integrations.
  3. Klik på “Add New Integration”.
  4. Udfyld feltet Name (f.eks. “Kleep Integration”).
  5. Indtast din Admin Password for at bekræfte.

2. Konfigurer API-tilladelser

RuterDetaljer
/products/*Adgang til alle produktressourcer
/categories/*Adgang til alle kategoriressourcer
/orders/*Adgang til alle ordreressourcer
/returns/*Adgang til alle returressourcer
/returnsAttributeMetadata/*Adgang til alle returattributressourcer
/returnsItemAttributeMetadata/*Adgang til alle returvareattributressourcer
/creditmemos/*Adgang til alle kreditnotaressourcer
/creditmemo/*Adgang til enkelt kreditnotaressource
/stockItems/*Adgang til alle lagerressourcer
/store/*Adgang til alle butiksressourcer
/inventory/*Adgang til alle lagerressourcer
/customers/*Adgang til alle kunderessourcer
Dette bør svare til følgende 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
⚠️ Vigtigt:
  • Hvis din Magento-instans eksponerer yderligere API-lag eller brugerdefinerede endpoints (f.eks. brugerdefinerede retur/RMA API’er), bedes du koordinere med os.
  • Hvis du bruger en ekstern returleverandør uden integration via Magento API, bedes du se returdatadokumentationen eller koordinere med os for at vælge den rigtige integrationsmetode.

3. Aktiver og hent legitimationsoplysninger

  1. Klik på “Save” for at oprette integrationen.
  2. Klik på “Activate” på den nyoprettede integration.
  3. Et pop-up-vindue viser dine OAuth-legitimationsoplysninger:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret
  4. Kopiér disse legitimationsoplysninger — du skal sende dem til din Kleep-kontakt.
For vejledning i oprettelse og hentning af Magento 2 API-legitimationsoplysninger, se venligst:
Subscribe Pro tutorial: Create and get Magento 2 API credentials Adobe official tutorial: Magento 2 OAuth authentication

4. Send legitimationsoplysninger til Kleep

Send venligst følgende oplysninger til din Kleep-kontakt via e-mail:
  1. Angiv den komplette API-basis-URL(er) for butikken/butikkerne.
  2. OAuth1-legitimationsoplysninger
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret

Fase 2: Frontend-integration (Widget)

Dette trin indebærer at tilføje Kleep-scriptet til dine produktsider (PDP). Kompatibelt med alle versioner af Magento. Følg vores JS Library Widget-guide for at installere og konfigurere frontend-CTA’en på dine produktsider.

Fase 3: Håndtering af manglende data (SFTP)

Dette afsnit gælder, når data ikke kan hentes via standard API-endpoints. Hvis dit Magento API ikke tillader hentning af returdata eller visse specifikke data, fortsætter vi via CSV-filudveksling. Se venligst dokumentationen nedenfor. Denne guide vil guide dig trin for trin gennem processen med at transmittere manglende data:

Fase 4: Validering & produktionsudrulning

1. Testmiljø

Udrul først på dit Preprod/Staging-miljø.

2. Visuel validering

Verificér følgende inden go-live:
  • Vises knappen korrekt?
  • Åbner klik pop-up’en (Drawer)?
  • Ingen “CORS”-fejl i browserkonsollen?

3. Go-live

Når det er valideret af dig og Kleep-teamet, udrul ændringerne til dit Production-tema.---

Cookies og databeskyttelse

Kleep er fuldt ud styret af besøgenes samtykke: scriptet indlæses kun efter samtykke er indsamlet via din CMP, og du skal betinge dets indlæsning derefter. For den komplette liste over trackere, behandlede data, formål og retsgrundlag, hosting, underbehandlere og sikkerhed, se Cookies, CMP & Databeskyttelse.