# Configurer une API Carrefour Espagne

{% hint style="warning" %}
Remarque : Les codes EAN sont obligatoires pour Carrefour. Assurez-vous de disposer de codes EAN valides pour tous vos produits, sinon aucune fiche produit ne pourra être créée pour vos produits.

Remarque : Via Channable, vous pouvez créer une connexion avec Carrefour Espagne et France, pas avec d'autres pays. Pour plus d'informations sur la configuration d'une API Carrefour France, consultez ceci [configurer-une-api-carrefour-france](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/configurer-une-api-carrefour-france "mention")
{% endhint %}

{% stepper %}
{% step %}

### Ajouter une nouvelle connexion Carrefour Espagne

L'API Carrefour Espagne utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos fiches produit à Carrefour.

* Une fois que vous avez un compte Mirakl Carrefour Espagne, rendez-vous sur **Connections > Add connection**.
* Cliquez **+ Ajouter une nouvelle connexion** et sélectionnez Carrefour Espagne.
* Remplissez le libellé de votre connexion, par exemple « Carrefour ».&#x20;
* Cliquez **Connecter avec Carrefour**. Vous serez redirigé(e) vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après la connexion, vous serez redirigé(e) vers Channable où la connexion sera disponible.

| ![Carrefour\_Spain\_-\_Connect\_with.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/I7NgvCxHluEDDF7vrkyj/7645392727442) | ![Sing\_in\_Mirakl\_-\_Oauth.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/owVGJPUz7PGxJvDVBO4L/7645388279314) |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| {% endstep %}                                                                                                                                |                                                                                                                                      |

{% step %}

### Créer une nouvelle API Carrefour Espagne dans Channable

* Allez à **\[Votre projet] > API's**.
* Cliquez **+ Ajouter une nouvelle API.**
* Sélectionnez la connexion Carrefour Espagne que vous venez de créer.
* Donnez un nom à votre nouvelle API.

![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/H7eG3mVAaRK3Oa6EPCSy/19237578475282)

Sélectionnez le champ que vous souhaitez utiliser pour **ID unique par produit** (nous recommandons le champ 'id') et le **Pays** vous souhaitez vendre. Cliquez sur "Continuer" pour terminer la création de la nouvelle API Carrefour Espagne.
{% endstep %}

{% step %}

### Créez vos annonces produits dans Channable

Une fois que vous avez créé l'API Carrefour Espagne, configurez vos données produit en suivant les étapes de l'API.

Carrefour demande la Shipping Class (catégorie logistique) des produits, en fonction du poids. Vous pouvez ajouter la catégorie logistique à vos produits en suivant les spécifications de ce tableau :\
![shipping\_category\_Carrefour.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/6O11WIN1Ala1BGIidmBI/21018606009490)

Pour l'ajouter, [créez un nouveau champ dans le mapping d'import](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) et [utiliser une règle](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) pour ajouter la classe d'expédition correspondant à vos produits, selon leur poids.

#### Bonnes pratiques

* Ajout de plusieurs valeurs d'attribut : Lors de l'ajout de plusieurs valeurs dans un champ d'attribut pour les places de marché Mirakl, séparez chaque valeur par un symbole pipe "|" afin d'assurer une détection et un traitement corrects.
* ID produit du vendeur pour les produits simples/uniques : Il existe deux attributs nommés 'SellerArticleId' et 'SellerProductId'. 'SellerProductId' fait référence à l'ID parent, tandis que 'SellerArticleId' fait référence aux variantes. Pour les produits simples, les deux attributs doivent être remplis avec la même valeur.

Pour plus d'informations sur les erreurs Mirakl Marketplace, les modes d'emploi et les bonnes pratiques, consultez [notre guide dédié](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/guide-mirakl-parametres-et-solutions).
{% endstep %}

{% step %}

### Étape 4 : Envoyez vos données produit à Carrefour

* Si vous n'avez pas activé votre projet, allez dans **Votre projet > Paramètres** et cliquez **Activer le projet**.
* Retournez à **APIs** et allez à **Votre nom d'API Carrefour > Paramètres.**
* Cliquez **Activer l'API**.
* Revenez à la **APIs** vue d'ensemble et cliquez sur **Exécuter maintenant** pour envoyer vos fiches produit à Carrefour.

Remarque : Les vendeurs peuvent désormais envoyer leurs nouveaux produits via l'API Carrefour pour l'Espagne, sans avoir à transmettre un modèle CSV manuel à Carrefour. Cependant, Carrefour exige toujours que tout vendeur souhaitant enregistrer de nouveaux produits envoie une copie de son flux, au format Excel, pour examen, car Carrefour doit vérifier et valider tous les nouveaux articles qui seront mis en ligne sur Carrefour.es.
{% endstep %}

{% step %}

### Étape 5 : Vérifiez vos annonces produits pour détecter les erreurs

* Après avoir envoyé vos fiches produits à Carrefour, allez dans l'onglet **Aperçu** de votre API Carrefour. Cliquez sur le filtre 'erreur'. Vous pouvez maintenant voir quelles fiches produit contiennent des erreurs et n'ont pas été créées.

Remarque : Chez Carrefour, il n'est pas possible de supprimer des produits de votre compte, seulement de les définir à stock=0 (ce qui désactive le produit sur la plateforme). Par conséquent, si vous souhaitez retirer vos produits de Carrefour, renvoyez les produits avec un stock à 0.
{% endstep %}
{% endstepper %}

### Exigences GPSR et DSA

L'Union européenne (UE) a introduit de nouvelles [Exigences GPSR et DSA](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/ce-que-vous-devez-faire-pour-etre-conforme-au-gpsr-et-au-dsa) pour les plateformes en ligne, y compris les places de marché.

Pour votre API Carrefour Espagne dans Channable, assurez-vous de remplir le **Attributs par catégorie** onglet dans le **La étape** l'étape

* Reglamento Advertencia / Indicación
* Reglamento Correo Electrónico
* Reglamento Dirección Del Fabricante/Importador

Pour plus d'informations sur les erreurs Mirakl Marketplace, les modes d'emploi et les bonnes pratiques, consultez [notre guide dédié](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/guide-mirakl-parametres-et-solutions).
