> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-di-unapi-conforama.md).

# Configurazione di un'Api Conforama

{% hint style="info" %}
**Aggiornamento dell’interfaccia utente:** C’è una nuova pagina di selezione del canale e una Panoramica per **Feed** y **Marketplace** (in precedenza chiamati API)! Alcune immagini e istruzioni potrebbero non essere aggiornate.&#x20;
{% endhint %}

{% 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](/manage-improve-product-data/manage-product-and-improve-data-it/categorizza-i-prodotti/crear-categorie-di-prodotto/usar-la-funzione-genera-categorie.md), oppure [creare nuove categorie da zero](/manage-improve-product-data/manage-product-and-improve-data-it/categorizza-i-prodotti/crear-categorie-di-prodotto/aggiungi-categorie-in-modo-manuale.md).
{% endstep %}

{% step %}

#### Regole

Crea [diverse regole](/manage-improve-product-data/manage-product-and-improve-data-it/regole-modifica-in-blocco-e-arricchisci/utilizzo-delle-regole.md) 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.

{% hint style="success" %}
**Suggerimento:** Passa il mouse sopra <i class="fa-circle-question">:circle-question:</i> per ulteriori informazioni sui requisiti specifici del campo.
{% endhint %}

\_ 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](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-delle-eco-contribuzioni-mirakl.md) 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](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-passaggio-di-creazione.md).

![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](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/cosa-devi-fare-para-essere-conforme-al-gpsr-y-al-dsa.md) per le piattaforme online, inclusi i marketplace.

Per la tua API Conforama in Channable, assicurati di compilare il [attributi](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-passaggio-di-creazione.md) 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](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-di-unapi-conforama.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
