# Comment configurer un canal Hornbach

Hornbach est une chaîne de bricolage allemande spécialisée dans l’amélioration de l’habitat, le jardin et les produits de bricolage.&#x20;

Dans cet article, vous apprendrez à configurer un canal Hornbach afin de créer, mettre à jour et gérer vos annonces Hornbach dans Channable.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> **Avant de commencer** <a href="#h_01kd2may8jg145nde7rhhyxbma" id="h_01kd2may8jg145nde7rhhyxbma"></a>

**Vous aurez besoin de**

* [Un compte Mirakl](https://www.miraklconnect.com/)
* L’autorisation de publier sur Hornbach\*
* Un projet dans Channable avec vos produits importés
* Des produits avec des codes EAN

**Bon à savoir**

* Actuellement, Hornbach prend uniquement en charge les annonces en **Allemagne**.
* \*L’équipe partenariat de Hornbach examine toutes les demandes de publication sur la plateforme. Vous pouvez soumettre une demande via leur [formulaire Marketplace Partner](https://forms.office.com/pages/responsepage.aspx?id=A5acU4BjPEKnDAGs1pyR1RoFDihP4cxKtIE31LhHMH9URUJFSTVPV0VKNEswQjVHN0lLVzdGME5QMy4u\&route=shorturl).&#x20;
* Hornbach utilise la plateforme Mirakl
* Certains attributs peuvent être obligatoires même s’ils ne semblent pas pertinents dans votre cas précis (par ex. un attribut permettant d’ajouter un titre en espagnol alors que vous vendez uniquement en Allemagne). Vous pouvez laisser ces attributs non mappés.

### **Étape 1 : Créer un canal Hornbach** <a href="#h_01kd2may8yx67j775amh442x6w" id="h_01kd2may8yx67j775amh442x6w"></a>

1. Dans Channable, allez dans **Projets > \[Votre projet] > Canaux**.
2. Dans la barre de recherche, saisissez « Hornbach » et sélectionnez **Hornbach**.

{% hint style="info" %}
**Remarque :** S’il n’apparaît pas, cliquez sur **Effacer** pour réinitialiser vos filtres.
{% endhint %}

3. Définissez les paramètres de votre canal :
   1. Pour **Nom**, donnez un nom à votre canal.
   2. Pour **ID unique par produit**, sélectionnez un champ contenant les codes EAN de vos produits (par ex. `ean`, `id`)
   3. Pour **Langue**, choisissez la langue dans laquelle se trouvent les données de vos produits.&#x20;
   4. Pour **Utiliser le groupe de règles générales**, vous pouvez définir un groupe de règles si vous en avez déjà un à appliquer à votre canal.
   5. Pour **Statut**, laissez votre API désactivée pour le moment.&#x20;
4. Cliquez sur **Sauvegarder**.

### **Étape 2 : Créer des fiches produit** <a href="#h_01kd2may9gv2v9x3dhyenbqgnw" id="h_01kd2may9gv2v9x3dhyenbqgnw"></a>

Suivez ces sous-étapes pour configurer votre canal.

**Catégoriser vos produits**

Configurez les données de vos produits en attribuant des catégories à vos produits.

* **Catégorisation intelligente :** Attribue automatiquement des catégories de produits à l’aide de notre algorithme.
* **Catégorisation manuelle :** Attribuez manuellement des catégories de produits à l’aide de règles personnalisées. Vous pouvez créer des filtres détaillés pour mapper chaque produit à sa bonne catégorie.
* **Produits non catégorisés :** Produits qui doivent encore être vérifiés et catégorisés.

**Configurer des règles**

Les règles vous aident à optimiser rapidement les données de vos produits pour votre marketplace cible.

* **Modèles de règles :** Règles couramment utilisées que vous pouvez ajuster et personnaliser selon vos besoins.
* **Configuration des règles :** Configurez des règles pour affiner les données de vos produits. Avec les règles, vous pouvez filtrer, modifier et/ou enrichir les champs de données afin de répondre aux exigences de la marketplace.

**Construire vos annonces**

L’étape **Construire** est l’endroit où vous configurez vos annonces produits pour qu’elles correspondent aux exigences de la marketplace. C’est une étape essentielle pour mettre vos produits en ligne et éviter les erreurs.

* **Champs obligatoires :** Requis pour publier vos produits sur cette marketplace
* **Recommandé :** Conseillé pour éviter les erreurs

{% hint style="warning" %}
**Important :** Certains attributs peuvent être obligatoires même s’ils ne semblent pas pertinents dans votre cas précis (par ex. un attribut permettant d’ajouter un titre en espagnol alors que vous vendez uniquement en Allemagne). Vous pouvez laisser ces attributs non mappés.
{% endhint %}

**Attributs partagés**

Les attributs partagés sont les champs communs qui s’appliquent à l’ensemble de vos produits, comme l’EAN, les prix et les titres. Le mapping de vos attributs partagés garantit des informations produit uniformes et cohérentes dans vos annonces.

Utiliser des valeurs statiques ou dynamiques :

* **Valeurs statiques :** Valeurs fixes qui ne changent pas (par ex. nom de marque, fabricant).
* **Valeurs dynamiques :** Champs qui se mettent à jour automatiquement en fonction des données liées (par ex. stock, prix).

**Attributs spécifiques à la catégorie**

Les attributs spécifiques à la catégorie sont des champs qui s’appliquent précisément aux catégories de vos produits. Cette étape vous aide à affiner vos annonces pour répondre aux exigences de catégorie de votre marketplace.

Renseignez les attributs propres à la catégorie sélectionnée (par ex. taille pour les vêtements ou dimensions pour les meubles).

{% hint style="success" %}
**Conseil :** Cliquez sur **Mapper les champs automatiquement** pour effectuer le mapping automatiquement à partir des informations de vos autres canaux ou d’autres configurations similaires.[ En savoir plus](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

**Bonnes pratiques pour les marketplaces Mirakl**

Ajout de plusieurs valeurs d’attribut : Séparez plusieurs valeurs dans un attribut à l’aide du symbole pipe « | » pour une détection et un traitement corrects.

ID produit du vendeur pour les produits simples/uniques : Il existe deux attributs appelés SellerArticleId et SellerProductId. SellerProductId correspond à l’ID parent, tandis que SellerArticleId fait référence aux variantes.

Pour les produits simples, SellerArticleId et SellerProductId doivent tous deux contenir la même valeur.

Pour plus d’informations sur les erreurs de la marketplace Mirakl, les modes d’emploi et les bonnes pratiques, consultez[ notre guide dédié](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions).

#### **Vérifier la qualité de votre configuration** <a href="#h_01kd2mayaj30t7t8rcax5ek0wj" id="h_01kd2mayaj30t7t8rcax5ek0wj"></a>

L’étape **Qualité** L’étape fournit un retour sur votre canal avant son activation. Elle met en évidence les erreurs obligatoires et optionnelles afin de garantir que vos données produit répondent aux exigences de publication sur la marketplace.

Résolvez les erreurs en priorisant d’abord les erreurs obligatoires.

Actions :

* **Voir les produits :** Voir les produits présentant des problèmes spécifiques.
* **Voir dans Construire :** Redirige vers l’étape **Construire** pour mapper les informations manquantes.
* **Définir des catégories :** Redirige vers l’étape **Catégories** pour catégoriser les produits.
* **Afficher la source :** Disponible pour les champs ID. Redirige vers l’étape **Paramètres** .

[En savoir plus sur l’étape Qualité pour les marketplaces](https://helpcenter.channable.com/hc/en-us/articles/19452435834642-Marketplaces-Quality-step)

#### **Prévisualiser avant activation** <a href="#h_01kd2mayax9d1yff172g00q61s" id="h_01kd2mayax9d1yff172g00q61s"></a>

L’étape **Aperçu** L’étape affiche les attributs que vous avez mappés dans l’étape **Construire** , ce qui vous aide à vérifier si tout est correctement configuré en fournissant une vue d’ensemble de vos produits et des erreurs potentielles.

Filtrage :

* **Filtrer par erreur :** Cliquez sur le menu déroulant **Tous** et sélectionnez si vous souhaitez afficher uniquement les produits avec des erreurs, ou les produits avec une erreur spécifique.
* **Filtrer par catégorie :** Cliquez sur le menu déroulant **Toutes les catégories** menu déroulant et sélectionnez la catégorie par laquelle vous souhaitez filtrer.

[En savoir plus sur l’étape Aperçu pour les marketplaces](https://helpcenter.channable.com/hc/en-us/articles/19452509593746-API-s-Preview-step)

**Avant de continuer :**

* **Vérifiez les attributs partagés :** Assurez-vous que tous les attributs partagés obligatoires sont renseignés.
* **Vérifiez les attributs spécifiques à la catégorie :** Assurez-vous que tous les attributs spécifiques à la catégorie obligatoires sont renseignés.
* **Vérifiez les erreurs :** Corrigez tous les champs marqués en rouge.

\
&#x20;

### **Exigences supplémentaires pour Hornbach** <a href="#h_01kd2maybdkh8va5qkrptykrzq" id="h_01kd2maybdkh8va5qkrptykrzq"></a>

**Répondez aux exigences GPSR et DSA**

L’Union européenne (UE) a introduit de nouvelles[ exigences GPSR et DSA](https://helpcenter.channable.com/hc/en-us/articles/22175644897042) pour les plateformes en ligne, y compris Hornbach.&#x20;

Pour vous conformer à ces exigences, vous devrez fournir des informations pour les attributs (au moins) **Fabricant** et **Opérateur économique** listés dans la section **Informations générales sur la sécurité des produits** dans l’étape **Construire** .

\
&#x20;

### **Étape 3 : Connecter à Hornbach via Mirakl** <a href="#h_01kd2maybggnr2c6w630vt1wfz" id="h_01kd2maybggnr2c6w630vt1wfz"></a>

Pour envoyer vos annonces à Hornbach, vous devez connecter votre canal à votre compte Mirakl Connect.&#x20;

**Important :** La liaison de votre compte ne modifiera rien : les annonces existantes resteront exactement identiques jusqu’à ce que vous les activiez.

1. Connectez-vous à votre compte Mirakl Connect.
2. Dans **\[votre canal Hornbach]**, allez dans **Paramètres**.
3. Dans **Compte vendeur associé**, cliquez sur **Sélectionner un compte vendeur**.&#x20;
4. Sélectionnez un compte vendeur existant, ou cliquez sur **+ Ajouter une nouvelle connexion** pour ajouter un nouveau compte vendeur.
   1. Si vous ajoutez un nouveau compte vendeur :
      1. Pour **Libellé**: nommez votre connexion de compte vendeur. Cela sert uniquement à identifier votre connexion dans Channable.
      2. Cliquez sur **Connecter avec Hornbach**.&#x20;

Vous serez redirigé(e) vers Mirakl pour vous connecter à votre compte. Cela permet d’authentifier votre connexion afin de garantir que Channable peut publier des produits pour vous.&#x20;

Après une connexion réussie, votre connexion sera prête et vous serez redirigé(e) vers votre canal.

### **Étape 4 : Activer votre canal** <a href="#h_01kd2maybw1hnhvpw8v6z10k76" id="h_01kd2maybw1hnhvpw8v6z10k76"></a>

Une fois vos annonces produits prêtes, vous pouvez les envoyer à Hornbach :&#x20;

1. Sélectionnez l’étape **Paramètres** dans **\[votre canal Hornbach]** et cliquez sur **Activer l’API**.
2. Cliquez sur **Sauvegarder**.
3. Cliquez sur **Exécuter** pour envoyer vos annonces produits à Hornbach.

### **Étape 5 : Vérifier et corriger les erreurs d’annonce** <a href="#h_01kd2mayc16zyv3vsheqqgfk35" id="h_01kd2mayc16zyv3vsheqqgfk35"></a>

Accédez à l’étape **Résultat** et cliquez sur l’onglet **Feedback** . Cette page affiche toutes les erreurs de traitement possibles présentes dans vos données produit à un instant donné.

#### **Résolution des erreurs :** <a href="#h_01kd2mayc23v4zzhmez2jsvh69" id="h_01kd2mayc23v4zzhmez2jsvh69"></a>

1. Dans **Description**, cliquez sur le nom de l’erreur. Vous accédez alors à une vue d’ensemble des produits concernés par cette erreur.
2. Dans **ID**, cliquez sur le numéro d’ID et faites défiler la page. Vous devriez voir un encadré mis en évidence en rouge dans la section où l’erreur s’est produite. Survolez l’encadré pour obtenir plus d’informations.
   1. Si l’erreur est une erreur de mapping, cliquez sur **Voir dans Construire** pour accéder à l’attribut que vous devez mapper/remapper, qui est mis en évidence en bleu.
   2. Pour plus d’informations sur l’attribut et ses valeurs acceptées, survolez .
3. Résolvez l’erreur.

#### **Erreurs courantes et solutions** <a href="#h_01kd2mayc76abf35zh7peeyq92" id="h_01kd2mayc76abf35zh7peeyq92"></a>

#### **mirakl\_unknown\_error\_code** <a href="#h_01kd2mayc78evjehhcbwpdhzqc" id="h_01kd2mayc78evjehhcbwpdhzqc"></a>

Cette erreur désigne un groupe d’erreurs qui surviennent généralement lorsque Mirakl ne peut pas identifier l’EAN d’un produit dans la base de données Mirakl. Cela signifie que le produit est soit nouveau dans Mirakl, soit qu’il lui manque des attributs nécessaires pour être reconnu comme produit.&#x20;

**Solution**:

1. **Vérifiez vos catégories :** Dans l’étape **Catégories** , vérifiez que les catégories de vos produits sont correctement associées. Si ce n’est pas le cas, prenez le temps de les mapper correctement. Pour des instructions détaillées sur ce processus,[ consultez notre article sur le mapping des catégories](https://helpcenter.channable.com/hc/en-us/articles/360020365580-What-are-categories-in-Channable).
2. **Vérifiez votre mapping :** Dans l’étape **Construire** étape, vérifiez les champs mappés et corrigez tout ce qui semble mal mappé. Vous pouvez utiliser des règles pour créer et renseigner de nouveaux champs.

Une fois que vous avez vérifié vos catégories et vos attributs mappés, cliquez sur **Exécuter** pour relancer votre canal.
