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

| **Route**                         | Dettagli                                                             |
| --------------------------------- | -------------------------------------------------------------------- |
| `/products/*`                     | Accesso a tutte le risorse dei prodotti                              |
| `/categories/*`                   | Accesso a tutte le risorse delle categorie                           |
| `/orders/*`                       | Accesso a tutte le risorse degli ordini                              |
| `/returns/*`                      | Accesso a tutte le risorse dei resi                                  |
| `/returnsAttributeMetadata/*`     | Accesso a tutte le risorse degli attributi dei resi                  |
| `/returnsItemAttributeMetadata/*` | Accesso a tutte le risorse degli attributi degli articoli restituiti |
| `/creditmemos/*`                  | Accesso a tutte le risorse delle note di credito                     |
| `/creditmemo/*`                   | Accesso alle risorse di una singola nota di credito                  |
| `/stockItems/*`                   | Accesso a tutte le risorse del magazzino                             |
| `/store/*`                        | Accesso a tutte le risorse del negozio                               |
| `/inventory/*`                    | Accesso a tutte le risorse dell'inventario                           |
| `/customers/*`                    | Accesso a tutte le risorse dei clienti                               |

**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](https://docs.subscribepro.com/integrations/magento-2/installation/step-3-magento-api-connection/)
> [Tutorial ufficiale Adobe: Autenticazione OAuth di Magento 2](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-oauth/)

### 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**](/it/cms/js-library) 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](/it/cookie-consent).