Vers le site principal
  1. Help Center - Channable
  2. APIs
  3. Installation d'autres canaux

Articles dans cette section

Afficher plus

Configurer une API Allegro

Souhaitez-vous apprendre de manière interactive toutes les bases pour la création d'une API export, ou comment effectuer une configuration avancée d'API dans Channable ? Apprenez comment créer un compte Channacademy dans Channable grâce à cet article du Centre d'aide et commencez avec le cours Bases - APIs ou le cours Expert - APIs.

Dans cet article, nous verrons comment configurer une API Allegro dans Channable, en suivant les étapes ci-dessous :

Avant de commencer le paramétrage

Comme pour toute autre marketplace, pour vendre sur Allegro, vous devez avoir un compte vendeur Allegro. Vous pouvez ouvrir un compte vendeur sur cette page.

Avant de configurer l'API Allegro, nous vous recommandons vivement de lire le Centre d'aide d'Allegro pour les vendeurs internationaux (en anglais). Vous y trouverez les informations de base à propos de la vente sur Allegro, de la façon de demander et de configurer votre compte, et de la façon de naviguer dans votre compte vendeur. Vous trouverez également des informations sur les frais d'inscription et les commissions de vente.

Voici d'autres articles que nous recommandons :

Si vous avez un compte vendeur Allegro, assurez-vous d'avoir configuré les éléments suivants dans le compte avant de commencer la configuration dans Channable :

  1. Une politique de garantie
  2. Une politique de retour
  3. Des paramètres de livraison
  4. Les termes de la politique de réclamations

Vous trouverez ces élements sous Sales settings de votre compte Allegro, où il vous sera demandé de nommer chacune de ces politiques. Vous aurez besoin de ces noms au cours du processus d'installation.

Une fois votre compte vendeur Allegro configuré, il est temps de configurer l'API dans Channable.

Configuration de l'API

Étape 1 : Ajouter une nouvelle connexion Allegro dans Channable

Pour créer une nouvelle connexion Allegro, cliquez sur "Connexions > "+Ajouter une nouvelle connexion". Vous verrez l'écran ci-dessous, où vous pouvez sélectionner Allegro :

Après avoir cliqué sur le bouton "Connecter avec Allegro", vous serez redirigé(e) vers l'espace vendeur d'Allegro, où vous pourrez vous connecter à l'aide de vos identifiants Allegro.

Allegro-HC-article-Google-Docs.png

Étape 2 : Ajouter une nouvelle API Allegro dans Channable

Allez maintenant sur l'onglet APIs, dans votre projet. Cliquez sur +Ajouter nouvelle API, sélectionnez la connexion Allegro que vous venez de créer, et donnez un nom à votre nouvelle API.Nouvelle API Allegro.jpg

Sélectionnez le champ que vous souhaitez utiliser comme ID unique par produit. Nous vous recommandons d'utiliser le champ id. Vous pouvez éventuellement ajouter un groupe de règles générales , puis cliquez sur "Continuer" pour terminer de créer votre API Allegro.

Étape 3 : Créer vos annonces produits

    1. Catégories
      Catégorisez vos produits en utilisant la fonction auto-générer des catégories ou créez manuellement des catégories. Si Allegro connaît déjà le code EAN de vos produits et que vous soumettez une catégorie différente de celle connue par Allegro, vous verrez une erreur "Category_Mismatch" à l'étape Résultat. Pour éviter ces erreurs, nous vous recommandons de vérifier la catégorie correcte de vos produits sur la vitrine Allegro.pl.

    2. Règles
      Créez des règles pour optimiser vos données produit. Regardez par exemple notre article sur les règles courantes. Assurez-vous d'ajouter les règles suivantes pour éviter les erreurs :
        • Vous pouvez créer une description détaillée à l'aide de ces balises HTML. Vous pouvez également regrouper toute votre description dans un seul paragraphe en créant cette règle :



        • Indiquer votre temps de traitement

          Allegro utilise des formats spécifiques pour le temps de traitement. Voici la liste des valeurs acceptées :
          1. PT0S: Immédiatement
          2. PT24H: 24 heures
          3. PT2D: 2 jours
          4. P3D: 3 jours
          5. P4D: 4 jours
          6. P5D: 5 jours
          7. P7D: 7 jours
          8. P10D: 10 jours
          9. P14D: 14 jours
          10. P21D: 21 jours
          11. P30D: 30 jours
          Vous pouvez indiquer manuellement un temps de traitement fixe pour tous vos produits à l'étape Construire. Si vous gérez des temps de traitement différents, définissez une règle pour insérer dynamiquement des temps de traitement différents par produit.

        • Formatage des descriptions

          Allegro s'attend à ce que les descriptions utilisent le langage HTML. Afin d'éviter toute erreur, adaptez vos descriptions en conséquence. Les balises HTML suivantes sont autorisées sur Allegro : 
          1. <h1> </h1> pour un titre
          2. <h2> </h2 pour un sous-titre
          3. <p> </p> pour un paragraphe
          4. <ul> </ul> pour une liste de points (liste à puces)
          5. <ol> </ol> pour une liste numérotée
          6. <li> </li> pour un élément de la liste
          7. <b> </b> pour une police en gras

    3. Construire
      La construction de vos annonces se fait très facilement et rapidement. Avec notre modèle prédéfini, tout ce que vous avez à faire est de le remplir en cliquant sur un champ vide et en sélectionnant la valeur correspondante. Par exemple, le champ "Titre" devrait afficher le "Titre" de votre produit et ainsi de suite.
      Allegro - Construire.jpg

      Politiques de vente
      C'est à l'étape Construire que vous pouvez soumettre les politiques mentionnées précédemment dans l'article. Allegro reliera vos produits aux politiques de vente que vous avez définies dans votre compte vendeur Allegro en utilisant les noms de ces politiques. Pour vous assurer que chaque produit est lié à la bonne politique de vente, indiquez le nom de chacune de ces politiques dans les champs appropriés en entrant une valeur statique.

      Si vous utilisez plusieurs politiques de vente, ajoutez de nouveaux champs dans votre mapping d'import et indiquez les noms des politiques à l'aide de règles dynamiques.

      Politiques Allegro.jpg

      Laisser des champs vides
      Une dernière chose à savoir : Allegro remplira lui-même un ensemble spécifique de champs au cas où ces champs seraient vides. Par exemple : le champ "Format du mode de vente" sera défini sur "BUY_NOW" si le champ soumis est vide. Ou si vous laissez le champ "Date de début de la publication" vide, Allegro le lira comme "L'offre sera activée immédiatement".

      Créer une structure parent/variant sur Allegro
      Allegro gère cela différemment des autres plateformes. Plutôt que de demander aux vendeurs d'indiquer à Allegro quels sont les variants, Allegro le détermine lui-même en se basant sur les informations relatives au produit qui sont incluses dans vos annonces. Cela signifie que vous n'avez pas besoin de configurer quoi que ce soit dans Channable pour créer des annonces groupées.

    4. Attributs
      Dans la section "Attributs", sélectionnez la catégorie que vous souhaitez optimiser en premier. Pour chaque attribut, vous pouvez indiquer une valeur statique ou utiliser un champ dynamique. Une explication plus détaillée peut être trouvée dans notre article du Centre d'aide sur les attributs.

Étape 4 : Envoyez vos produits à Allegro

Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet dans Channable, allez dans l'onglet "Paramètres > Paramètres de projet > Activer le projet". Ensuite, retournez sur l'onglet APIs et cliquez sur "Paramètres" de votre API Allegro nouvellement créée. Activez l'API en sélectionnant "Activer API". Une fois cette étape terminée, retournez sur l'onglet APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits à Allegro.

Étape 5 : Vérifiez que vos annonces produits ne contiennent pas d'erreurs

Après avoir envoyé vos listes de produits à Allegro, accédez à l'étape Résultat de votre API Allegro. Cliquez sur l'onglet "Erreurs". Vous pouvez maintenant voir quelles annonces produits ont des erreurs et ne sont pas envoyées. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de l'erreur.

Important : Allegro ne renverra pas toutes les erreurs en une seule fois, il se peut donc qu'il faille plusieurs exécutions de l'API pour que vos produits soient corrects et acceptés.

Vous trouverez ci-dessous les erreurs les plus courantes et la manière de les résoudre :

      • VALIDATION ERROR (erreur de validation)
        Il s'agit d'une erreur générée par Channable. Pour vous éviter d'avoir à exécuter l'API encore et encore pour des erreurs qui peuvent être évitées lors du paramétrage, nous avons ajouté une validation de notre côté. Cela signifie que cette erreur apparaîtra pour les données dont nous savons qu'elles seront erronées - pensez aux champs de prix vides ou aux balises HTML erronées dans votre description. Vous pouvez résoudre ce problème en corrigeant les données associées indiquées dans le message d'erreur.

      • PARAMETER_MISMATCH (incompatibilité de paramètre)
        Cette erreur apparaît lorsque le code EAN/GTIN est déjà connu sur Allegro et que vous avez soumis un attribut qui ne correspond pas à ce qu'Allegro attend.
        Channable tente de mettre à jour le produit mais ne peut le faire en raison de cette erreur. Le produit sera toujours en ligne si l'annonce a déjà été créée, mais avec un stock et un prix inchangés. Vous pouvez résoudre cette erreur en changeant la valeur de l'attribut par la valeur suggérée par Allegro. Cette valeur suggérée est indiquée dans le message d'erreur.

      • CATEGORY_MISMATCH (incompatibilité de catégorie)
        Cette erreur est similaire à l'erreur précédente, mais pour les catégories. Allegro s'attend à ce qu'un produit entre dans une catégorie spécifique, mais vous avez soumis une catégorie différente. Vous pouvez résoudre ce problème en modifiant la configuration de votre catégorie. La valeur correcte est indiquée dans le message d'erreur.

      • Attribute value in possible values (Valeur de l'attribut dans les valeurs possibles)
        Channable tente de créer une nouvelle valeur autorisée pour un attribut spécifique, mais Allegro indique que la valeur est déjà connue dans ses valeurs autorisées. Il peut alors y avoir une différence entre les majuscules, les minuscules ou les espaces, ce qui provoque cette erreur.
        Pour résoudre ce problème, vous devez modifier la valeur actuellement définie dans les attributs pour qu'elle corresponde aux valeurs affichées dans la liste des "valeurs autorisées", y compris les majuscules, les minuscules, les espaces et les accents. Vous trouverez cette liste de valeurs autorisées à l'étape Attributs. Par exemple, si vous avez défini "Channable" comme attribut et qu'Allegro affiche "channable" comme valeur autorisée, vous devrez définir cette valeur comme "channable" depuis les règles.