# Configurare un'API Carrefour Spain
**Nota:** I codici EAN sono obbligatori per Carrefour. Assicurati di avere codici EAN validi per tutti i tuoi prodotti, altrimenti non potranno essere creati annunci per i tuoi prodotti.
{% hint style="info" %}
**Nota:** Attraverso Channable puoi creare una connessione con **Carrefour Spagna e Francia**, non con altri paesi. Per maggiori informazioni sulla configurazione di un'API Carrefour Francia, consulta [questo articolo del Centro assistenza](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurare-unapi-carrefour-france).
{% endhint %}
{% stepper %}
{% step %}
### Aggiungi una nuova connessione Carrefour Spagna
L'API Carrefour Spagna utilizza la piattaforma Mirakl, quindi avrai bisogno di un account Mirakl per iniziare a inviare i tuoi annunci prodotto a Carrefour.
* Una volta che hai un account Mirakl Carrefour Spagna, vai a **Connessioni > Aggiungi collegamento**.
* Clicca **+ Aggiungi un nuovo collegamento** e seleziona Carrefour Spagna.
* Compila l'etichetta per la tua connessione, ad esempio "Carrefour".
* Clicca **Connetti con Carrefour**. Verrai reindirizzato all'ambiente dove potrai effettuare il login con le credenziali Mirakl. Dopo il login verrai riportato su Channable dove la connessione sarà disponibile.
|  |  |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| {% endstep %} | |
{% step %}
### Crea una nuova API Carrefour Spagna in Channable
* Vai **\[Il tuo progetto] > API**.
* Clicca **+ Aggiungi nuova API.**
* Seleziona la connessione Carrefour Spagna che hai appena creato.
* Assegna un nome alla tua nuova API.
Seleziona il campo che vuoi usare per **ID univoco per articolo** (consigliamo il campo 'id') e il **Paese** in cui vuoi vendere. Clicca su "Continua" per terminare la creazione del nuovo canale Carrefour Spagna.
{% endstep %}
{% step %}
### Crea i tuoi annunci prodotto in Channable
Una volta creata l'API Carrefour Spagna, configura i tuoi dati prodotto seguendo i passaggi dell'API:
**Passo categorie**\
Perché i tuoi annunci vengano creati, i prodotti devono avere una categoria. Aggiungi le categorie usando il [funzione genera categorie](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/use-the-generate-categories-function) o [creare nuove categorie da zero](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products/create-product-categories/add-categories-manually).
**Regole**\
Crea [regole](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/rules-in-channable) per ottimizzare le tue inserzioni prodotto.
**Build**\
Usa il modello preimpostato per gli annunci prodotto e compilalo cliccando sul campo e selezionando il valore sorgente. Ad esempio, il campo 'Stock' dovrebbe mostrare la giacenza del prodotto. Quando hai finito, clicca su 'salva' in fondo alla schermata.
Nota: Carrefour richiede la Shipping Class (categoria logistica) dei prodotti, in base al peso. Puoi aggiungere la Categoria Logistica seguendo le specifiche in questa tabella:\
Per aggiungerla, [crea un nuovo campo nella mappatura di importazione](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) e [usare una regola](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) per aggiungere la classe di spedizione corrispondente ai tuoi prodotti, in base al loro peso.
* **Build**\
Compila i campi nella **Build** fase. Seleziona prima la categoria che vuoi ottimizzare. Una spiegazione più dettagliata del passaggio Attributi è disponibile in [il nostro articolo di supporto sugli Attributi](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/per-iniziare-con-i-marketplace/marketplace-passaggio-build).
#### 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-e-soluzioni).
{% 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/per-iniziare-con-i-marketplace/cosa-devi-fare-per-essere-conforme-a-gpsr-e-dsa) per le piattaforme online, inclusi i marketplace.
Per la tua API Carrefour Spagna in Channable, assicurati di compilare gli attributi nella **Attributi per categoria** scheda nel **Build** passaggio:
* Reglamento Advertencia / Indicación
* Reglamento Correo Electrónico
* Reglamento Dirección Del Fabricante/Importador
{% endstep %}
{% step %}
### Invia i tuoi dati prodotto a Carrefour
* Se non hai attivato il progetto, vai su **Il tuo progetto > Impostazioni** e clicca **Attiva progetto**.
* Torna a **Api** e apri **Il nome della tua API Carrefour > Impostazioni**.
* Clicca **Attiva API**.
* Torna all' **Api** panoramica e clicca **Esegui** per inviare i tuoi annunci prodotto a Carrefour.
{% hint style="info" %}
Nota: i venditori possono ora inviare nuovi prodotti tramite l'API Carrefour per la Spagna senza inviare un modello CSV manuale a Carrefour. Tuttavia, Carrefour richiede sempre che ogni venditore che registra nuovi prodotti invii una copia del proprio feed in formato Excel per revisione e validazione.
{% endhint %}
{% endstep %}
{% step %}
### Controlla i tuoi annunci per errori
Se hai inviato i tuoi annunci prodotto a Carrefour, vai alla **Anteprima** scheda della tua API Carrefour. Clicca sul filtro 'error' per vedere quali annunci hanno errori e non sono stati creati.
Nota: in Carrefour non è possibile eliminare prodotti dal tuo account, ma solo impostare stock=0 (che inattiva il prodotto sulla piattaforma). Per rimuovere i prodotti, invia nuovamente i prodotti con stock 0.
#### 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-e-soluzioni).
{% endstep %}
{% endstepper %}