Magento

​

Fase 1: Configurazione Backend (API OAuth1)

Questo passaggio consente a Kleep di recuperare il tuo catalogo prodotti, la cronologia degli ordini e i dati sui resi per calibrare l’algoritmo.

​

1. Creazione dell’Integrazione OAuth1

1. Accedi al tuo Pannello di Amministrazione Magento.
2. Vai su System > Integrations.
3. Clicca su “Add New Integration”.
4. Compila il campo Name (es. “Kleep Integration”).
5. Inserisci la tua Admin Password per confermare.

​

2. Configurazione dei Permessi API

Questo dovrebbe corrispondere ai seguenti ACL 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

⚠️ Importante:

• Se la tua istanza Magento espone livelli API aggiuntivi o endpoint personalizzati (ad esempio, API personalizzate per resi/RMA), coordinati con noi.
• Se utilizzi un fornitore di resi esterno senza integrazione tramite l’API Magento, fai riferimento alla documentazione sui dati dei resi o coordinati con noi per scegliere il metodo di integrazione corretto.

​

3. Attivazione e Recupero delle Credenziali

1. Clicca su “Save” per creare l’integrazione.
2. Clicca su “Activate” sull’integrazione appena creata.
3. Un pop-up mostrerà le tue credenziali OAuth:
   • Consumer Key
   • Consumer Secret
   • Access Token
   • Access Token Secret
4. Copia queste credenziali — dovrai inviarle al tuo contatto Kleep.

Per indicazioni sulla creazione e il recupero delle credenziali API di Magento 2, fai riferimento a:

Tutorial Subscribe Pro: Crea e ottieni le credenziali API di Magento 2 Tutorial ufficiale Adobe: Autenticazione OAuth di Magento 2

​

4. Invio delle Credenziali a Kleep

Invia le seguenti informazioni al tuo contatto Kleep via email:

1. Fornisci il/i URL base API completo/i per il/i negozio/i.
2. Credenziali OAuth1
   • Consumer Key
   • Consumer Secret
   • Access Token
   • Access Token Secret

---

​

Fase 2: Integrazione Frontend (Widget)

Questo passaggio prevede l’aggiunta dello script Kleep alle tue pagine prodotto (PDP). Compatibile con tutte le versioni di Magento. Segui la nostra guida al Widget Libreria JS per installare e configurare il CTA frontend nelle tue pagine prodotto.

---

​

Fase 3: Gestione dei Dati Mancanti (SFTP)

Questa sezione si applica quando i dati non possono essere recuperati tramite gli endpoint API standard. Se la tua API Magento non consente di recuperare i resi o determinati dati specifici, procediamo tramite scambio di file CSV. Fai riferimento alla documentazione qui sotto. Questa guida ti accompagnerà passo dopo passo nel processo di trasmissione dei dati mancanti:

---

​

Fase 4: Validazione & Deploy in Produzione

​

1. Ambiente di Test

Effettua prima il deploy sul tuo ambiente Preprod/Staging.

​

2. Validazione Visiva

Prima di andare in produzione, verifica:

• Il pulsante viene visualizzato correttamente?
• Cliccandoci si apre il pop-up (Drawer)?
• Nessun errore “CORS” nella console del browser?

​

3. Go-Live

Una volta validato da te e dal team Kleep, effettua il deploy delle modifiche al tuo tema Production.---

​

Cookie e privacy dei dati

Kleep è completamente subordinato al consenso del visitatore: lo script si carica solo dopo che il consenso è stato raccolto tramite la tua CMP, e devi condizionarne il caricamento di conseguenza. Per l’elenco completo dei tracker, i dati trattati, le finalità e le basi giuridiche, hosting, responsabili del trattamento e sicurezza, consulta Cookie, CMP & Privacy dei Dati.