# Configurazione di un'Api Conforama

{% hint style="warning" %}
Importante: i codici EAN sono obbligatori per Conforama. Assicurati di avere codici EAN validi per tutti i tuoi prodotti, altrimenti non sarà possibile creare inserzioni per i tuoi prodotti.
{% endhint %}

{% stepper %}
{% step %}

### Passo 1: Aggiungi una nuova connessione Conforama

L'API di Conforama utilizza la piattaforma Mirakl, quindi avrai bisogno di un account Mirakl per iniziare a inviare le tue inserzioni prodotto a Conforama.

Quando hai un account Mirakl Conforama, vai a **Connessioni > Aggiungi collegamento**. Clicca **+ Aggiungi un nuovo collegamento** e vedrai una schermata in cui potrai selezionare Conforama. Compila l'etichetta per la tua connessione, per esempio Conforama. Poi clicca **Connetti con Conforama.** Verrai reindirizzato all'ambiente in cui potrai effettuare il login con le tue credenziali Mirakl. Dopo il login verrai riportato in Channable dove la connessione sarà disponibile.

|               | ![Conforama\_1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/L7SY4utSdPCTAgHHHOO2/7649591663506) | ![Sing\_in\_Mirakl\_-Oauth\_\_1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/E3xncxVxeAfXSeWGNv4d/7649505894930) |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| {% endstep %} |                                                                                                                        |                                                                                                                                         |

{% step %}

### Passo 2: Aggiungi una nuova API Conforama in Channable

Ora vai alla panoramica delle API nel tuo progetto. Clicca su "+ Aggiungi nuova API", seleziona la connessione Conforama appena creata e dai un nome al tuo nuovo canale.

Seleziona il campo che vuoi usare per **ID univoco per articolo** (consigliamo il campo 'id), e il **Lingua** per le categorie. Clicca su "Continua" per terminare la creazione del nuovo canale Conforama.
{% endstep %}

{% step %}

### Passo 3: Crea le tue inserzioni prodotto in Channable

Una volta creato il canale Conforama puoi configurare i dati prodotto seguendo i passaggi del canale.

{% stepper %}
{% step %}

#### Passo categorie

Per creare i tuoi dati prodotto, i prodotti devono avere una categoria. Aggiungi le categorie ai tuoi prodotti usando il [funzione genera categorie](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/use-the-generate-categories-function), oppure [creare nuove categorie da zero](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/add-categories-manually).
{% endstep %}

{% step %}

#### Regole

Crea [diverse regole](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) per ottimizzare i dati dei tuoi prodotti.&#x20;
{% endstep %}

{% step %}

#### Build

Qui trovi il nostro template preimpostato per le inserzioni prodotto. Devi solo compilare i campi cliccando sul campo stesso e selezionando cosa vuoi inserire. Per esempio, il campo 'Price' dovrebbe mostrare il prezzo del tuo prodotto e così via. Quando hai finito di configurare le inserzioni prodotto, clicca su 'salva' in fondo alla schermata.

\_ Eco-contributi \_

La Francia ha introdotto una normativa sull'eco-partecipazione. Se la tua azienda opera in Francia, deve aggiungere gli eco-contributi alle proprie offerte sul marketplace. In [questo articolo](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurare-arriba-gli-eco-contributi-mirakl) puoi trovare un elenco delle categorie EPR disponibili.

[![HD Conforama Build.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/yPTAhUfiurqJWp4LmSRW/15232665863698)](https://helpcenter.channable.com/hc/article_attachments/15232665863698)
{% endstep %}

{% step %}

#### Attributi di categoria

Quasi fatto! Il passo successivo è compilare i campi nella *Attributi* fase. Seleziona prima la categoria che vuoi ottimizzare. Un esempio di ciò che dovresti vedere è mostrato nello screenshot qui sotto. Una spiegazione più dettagliata su cosa fare nella *Attributi* fase può essere trovata in [il nostro articolo di supporto sugli Attributi](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-fase-di-creazione).

![EN\_-\_API\_Conforama\_6.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/m0yNeP1FaB91RsaKLAsg/360007600220)
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}

### Requisiti GPSR e DSA

L'Unione Europea (UE) ha introdotto nuovi [Requisiti GPSR e DSA](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/cosa-devi-fare-para-essere-conforme-a-gpsr-y-dsa) per le piattaforme online, inclusi i marketplace.

Per la tua API Conforama in Channable, assicurati di compilare il [attributi](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-fase-di-creazione) nel **Attributi** passaggio (marketplace V1) o nel passaggio specifico della categoria (marketplace V2): **Attributi per categoria** scheda nel **Build** passaggio (marketplace V2):

* **Référence Fournisseur**
  {% endstep %}

{% step %}

### Passo 4: Invia i tuoi dati prodotto a Conforama

Quando tutti i passaggi sono completati, sei pronto per inviare le tue inserzioni. Segui le istruzioni qui sotto per inviare le tue inserzioni prodotto:

{% stepper %}
{% step %}
Vai a **Impostazioni** > **Impostazioni del progetto**.
{% endstep %}

{% step %}
Clicca **Attiva progetto**.
{% endstep %}

{% step %}
Torna a **Api** e vai a \[ **Il nome della tua API** ] > **Impostazioni**.
{% endstep %}

{% step %}
Seleziona **Attiva API** per attivare l'Api.
{% endstep %}

{% step %}
Torna a **Panoramica delle API** e clicca **Esegui** per inviare i tuoi annunci prodotto.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Nota: all'inizio i tuoi prodotti potrebbero essere inviati a un ambiente di test. Dopo che Conforama avrà accettato i tuoi prodotti, potrai inviarli all'ambiente live. Per favore [contatta il nostro team di supporto](https://www.channable.com/company/contact/) per assicurarti di inviare all'ambiente corretto.
{% endhint %}
{% endstep %}

{% step %}

### Passo 5: Controlla le tue inserzioni prodotto per errori

Se hai inviato le tue inserzioni a Conforama vai alla *Anteprima* scheda della tua API Conforama. Filtra per 'error'. Ora puoi vedere quali inserzioni prodotto presentano errori e non sono pubblicate. Clicca su un errore specifico per vedere maggiori informazioni su cosa causa l'errore.
{% endstep %}
{% endstepper %}

### Buone pratiche

* Aggiunta di più valori di attributo: quando aggiungi più valori in un campo attributo per i marketplace Mirakl, separa ogni valore con il simbolo pipe "|" per garantire la corretta individuazione e gestione.
* ID prodotto del venditore per prodotti singoli/semplici: Ci sono due attributi chiamati rispettivamente 'SellerArticleId' e 'SellerProductId'. 'SellerProductId' si riferisce all'ID Parent, mentre 'SellerArticleId' si riferisce alle varianti. Per i prodotti singoli, entrambi gli attributi devono essere compilati con lo stesso valore.

Per maggiori informazioni sugli errori del marketplace Mirakl, how-to e best practice, consulta [la nostra guida dedicata](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni).
