Configurer une API Conrad

Conrad, entreprise familiale depuis près de 100 ans, fournit à ses clients européens des technologies innovantes et fiables. Proposant plus de 1,5 million de produits provenant de fabricants de premier plan, Conrad est au service de clients industriels, de professionnels, d'institutions éducatives, de courtiers et de particuliers.

Ce guide vous aidera à travers les étapes de la mise en place d'une API entre Channable et Conrad.

Table des matières

1. Étape de préparation
2. Créer une nouvelle connexion
3. Créer l'API
4. Créer vos annonces produits
5. Envoyer vos annonces produits à Conrad
6. Vérifier que vos annonces ne contiennent pas d'erreurs

Étape de préparation

Afin de garantir une installation réussie, veuillez lire et suivre ces directives importantes :

• Configuration du compte : Pour vendre vos produits sur Conrad, vous devez disposer d'un compte vendeur professionnel. Suivez les instructions de création de compte sur cette page.
• Pays pris en charge : Actuellement, les pays suivants sont disponibles : Allemagne, Italie, France, Pays-Bas, Autriche et République tchèque.
• Plusieurs APIs Conrad : Chaque boutique correspond à un canal de vente. Si vous souhaitez vendre dans plusieurs pays, vous devez :
1. Ouvrir un nouveau compte pour cette boutique.
2. Créer une nouvelle API Conrad dans Channable pour vous connecter à ce compte.

Après avoir complété et revu tous ces points, vous êtes prêt(e) à passer à la première étape.

Étape 1 : Créer une nouvelle connexion

Pour créer une nouvelle connexion Conrad, suivez les étapes ci-dessous :

1. Commencez par vous rendre sur la page API de votre projet et cliquez sur le bouton "+Ajouter nouvelle API". Cette action vous redirigera vers la page des connexions de votre compte.
   
2. Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
3. Recherchez la connexion "Conrad" et donnez un nom à cette nouvelle connexion.
   
4. Cliquez sur "Se connecter avec Conrad". Vous serez redirigé(e) vers Conrad pour l'étape suivante. Une fois redirigé(e), connectez-vous en utilisant les identifiants Mirakl/Conrad.

Après avoir réussi à vous connecter, la connexion avec Conrad est établie et disponible ! Vous serez ramené(e) à la configuration de l'API.

Étape 2 : Créer l'API

Une fois de retour sur Channable, vous devez sélectionner votre nouvelle connexion avec Conrad et continuer à configurer votre API.

1. 1. Configurer les paramètres de l'API:
      
      • Nommez votre API
      • Choisissez l'ID unique par produit (nous recommandons le champ "ID")
      • Sélectionnez la langue de votre API
        
   2. Créer l'API : Cliquez sur "Continuer" pour créer la nouvelle API Conrad.

Étape 3 : Créer vos annonces produits

Pour configurer votre API, suivez les étapes décrites ci-dessous. Cliquez sur chaque étape pour afficher les instructions détaillées, qui vous guideront tout au long du processus.

1. Catégorisation

2. Règles

3. Construire

L'étape Construire dans Channable vous permet de configurer tous les attributs nécessaires pour vos produits, en veillant à ce que les données soient conformes aux exigences de la marketplace. Cette étape est cruciale pour réussir la mise en ligne des produits et pour éviter les erreurs.

3.1 Vue d'ensemble

1. Accéder à l'étape Construire : Commencez par accéder à l'interface centralisée de l'étape Construire. C'est là que vous gérerez et attribuerez tous les attributs du produit.
2. Identifier les champs obligatoires et optionnels : Les champs obligatoires sont indiqués en rose, ce qui indique qu'ils sont essentiels pour la mise en ligne de vos produits. Les champs optionnels sont marqués en jaune et peuvent être remplis en fonction de besoins spécifiques.

3.2 Renseigner les attributs partagés

1. Renseigner les attributs partagés : Saisissez les détails communs qui s'appliquent à tous les produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations de base sur les produits dans l'ensemble de vos annonces produits.
   • Utiliser des valeurs statiques ou dynamiques :
     • Valeurs statiques : Saisissez directement des valeurs qui restent constantes, comme le nom de la marque ou du fabricant.
     • Valeurs dynamiques : Utilisez des champs qui se mettent automatiquement à jour en fonction des données liées, ce qui est idéal pour les variables telles que les niveaux de stock ou les prix.

Après avoir indiqué les valeurs souhaitées pour les attributs partagés, passez aux attributs par catégorie ci-dessous.

3.3 Spécifier des attributs par catégorie

1. Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
2. Catégorie - attributs spécifiques : Renseignez les attributs spécifiques à la catégorie sélectionnée, tels que la taille pour les vêtements ou les dimensions pour les meubles. Cette étape permet d'affiner vos annonces en fonction des exigences de la catégorie. Ici encore, vous pouvez utiliser des valeurs statiques ou dynamiques.

Cliquez ici pour en savoir plus sur l'étape Construire de vos APIs.

4. Qualité

L'étape Qualité fournit un retour d'information instantané sur la qualité de la configuration, en mettant en évidence les erreurs obligatoires et optionnelles afin de garantir que les données relatives à vos produits répondent aux normes des marketplaces.

Actions

• Voir les produits : Pour voir les produits présentant des problèmes spécifiques.
• Voir dans Construire : Redirige vers l'étape Construire pour lier les informations manquantes.
• Catégoriser : Renvoie à l'étape Catégorisation pour classer les produits.
• Source : Disponible pour les champs IDs, dirige vers l'étape Paramètres.

Cliquez ici pour en savoir plus sur l'étape Qualité de vos APIs.

5. Aperçu

L'étape Aperçu affiche les attributs mappés de plusieurs produits et met en évidence les erreurs avant l'export vers la marketplace.

Caractéristiques

• Rechercher et filtrer : Recherchez des produits spécifiques ou filtrez par message d'erreur/catégorie.
• Vue d'ensemble des produits : Affiche tous les produits à exporter; elle peut être filtrée pour n'afficher que les produits comportant des erreurs.
• Aperçu détaillé du produit : Affiche les informations manquantes et les actions pour corriger les erreurs.

Checklist pour la finalisation des attributs

• Examiner les attributs partagés : Assurez-vous que tous les attributs partagés obligatoires sont remplis.
• Examiner les attributs par catégorie : Veillez à ce que tous les attributs obligatoires spécifiques à chaque catégorie soient remplis.
• Vérifier les erreurs : Corrigez les champs indiqués en rouge.

Cliquez ici pour en savoir plus sur l'étape Aperçu de vos APIs.

6. Résultat

Exigences supplémentaires pour Conrad

Les informations suivantes sont spécifiques à Conrad, nous détaillons par onglet les points sur lesquels vous devez être vigilant(e).

Onglet Produit

• Délai d'expédition : Le délai d'expédition indique le temps nécessaire jusqu'à ce que le colis soit remis au prestataire en charge de l'expédition. Cette valeur écrase tous les paramètres par défaut de Mirakl. Si la valeur reste vide, l'expédition est considérée par Conrad comme étant le jour même. Dans la boutique Conrad, 1 à 2 jours sont ajoutés au délai d'expédition spécifié.
• Catégorie d'envoi : Les classes logistiques déterminent les frais d'expédition respectifs de vos produits. Vous pouvez configurer jusqu'à huit classes d'expédition différentes.Les valeurs correctes doivent être renseignées dans l'attribut "Catégorie d'envoi" lors de l'étape Construire. Vous trouverez ci-dessous les valeurs possibles, qui peuvent également être trouvées en tant que valeurs statiques en survolant le symbole (?) à côté de l'attribut "Catégorie d'envoi".
  

  Valeur de la catégorie d'envoi	ID de la catégorie d'envoi	Description
  Small & Medium 1	SM1	10 kg et moins
  Small & Medium 2	SM2	De plus de 10 kg à 15 kg
  Small & Medium 3	SM3	De plus de 15 kg à 31.5 kg
  Bulk shipment	bulk	"En vrac". De plus de 31.5 à 40 kg
  Pallet Shipment	pallet	Palette. De plus de 40 kg à 500 kg
  Extra Logistic class 1	extra1	Prix spécifique pour Extra logistic class 1
  Extra Logistic class 2	extra2	Prix spécifique pour Extra logistic class 2
  Free shipping	free	Livraison gratuite
  Fulfillment Small & Medium 1	FSM1	Remplissage de 10 kg et moins
  Fulfillment Small & Medium 2	FSM2	Remplissade de plus de 10 kg à 15 kg
  Fulfillment Small & Medium 3	FSM3	Remplissage de plus de 15 kg à 31.5 kg
  Fulfillment Bulk Shipment	fbulk	Encombrant de plus de 31.5 kg à 40 kg
  Fulfillment Pallet Shipment	fpallet	Palette de plus de 40 kg à 500 kg
  Fulfillment Extra Logistic 1	fextra1	Remplissage additionnel 1
  Fulfillment Extra Logistic 2	fextra2	Remplissage additionnel 2
  Fulfillment Free shipping	fulfree	Remplissage livraison gratuite (pas de frais de port autorisés)
  OCI assortment	oci	Assortiment OCI (pas de frais de port)

  Remarque : Extra Logistic Class 1 and 2 sont disponibles seulement pour l'Allemagne
• L'autoliquidation s'applique : La procédure d'autoliquidation annule l'assujettissement à la TVA pour les livraisons : Ce n'est pas l'entreprise qui effectue la livraison qui paie la TVA aux impôts, mais le client. La condition préalable à l'application de la procédure d'autoliquidation est que le client soit également titulaire d'un numéro d'identification TVA.
  Veuillez indiquer la valeur "false" ou "true" pour chaque offre, selon que cette réglementation s'applique ou non.
• ID de l'entrepôt : renvoie l'emplacement de l'entrepôt à partir duquel le produit concerné est envoyé. La configuration se fait dans l'attribut "ID de l'entrepôt" de l'étape Construire.
  Une valeur de 1 à 5 est saisie en fonction de la configuration des emplacements des entrepôts. L'attribut lié à l'entrepôt requiert à un chiffre spécifique, vous pouvez spécifier jusqu'à 5 emplacements de stockage dans votre compte Conrad. Cet attribut détermine ensuite l'entrepôt d'où provient le produit en sélectionnant l'identifiant 1 à 5.
• Unités de mesure : L'attribut "Unité de mesure" spécifie l'unité utilisée pour calculer le prix unitaire d'un produit. Cela permet aux consommateurs de comparer facilement les coûts. Pour les produits vendus au poids, au volume, à la longueur ou à la surface, indiquez les prix unitaires en utilisant des unités courantes telles que le kilogramme (KG), le litre (L), le mètre (M) ou le mètre carré (M²). Assurez-vous que l'attribut "Unité de mesure" dans Channable est correctement rempli pour refléter ces normes.
• Quantité : Dans Channable, cet attribut "Quantité" spécifie l'unité de mesure du produit vendu. Par exemple, si vous vendez un paquet de 4 bouchons, vous devez entrer "4" comme quantité. Cela permet à Conrad d'afficher à la fois le prix unitaire et le prix total du paquet de quatre. Vous pouvez réaliser cela pour des produits spécifiques en :
  1. Créant un champ de projet
  2. En l'utilisant dans une règle et en lui attribuant une valeur.
  3. Sélectionnez ensuite le champ dans l'attribut "Quantité". Consultez cet article pour plus d'informations sur les champs dynamiques.
• Taxe sur la copie privée : En France, la taxe sur la copie privée est une obligation légale qui rémunère les auteurs et les titulaires de droits pour les copies privées réalisées à l'aide de supports vierges tels que les CD, les DVD, les disques durs externes et les clés USB. Cette redevance est incluse dans le prix de vente de ces supports vierges et est ensuite distribuée aux créateurs et aux ayants droit par l'intermédiaire des organismes collectifs de gestion. Les vendeurs sont tenus d'indiquer le montant de la redevance "copie-privée" en euros pour chaque produit de cette catégorie.
• Eco-participations : La France a introduit une législation sur l'éco-participation. Si votre entreprise opère en France, elle doit ajouter des éco-participations à ses offres sur la marketplace. Dans cet article, vous trouverez une liste des catégories EPR disponibles.

En suivant ces lignes directrices, vous pourrez vous assurer que vos annonces produits Conrad sont correctement configurées et conformes aux exigences de la plateforme.

Étape 4 : Envoyer vos annonces produits à Conrad

Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans les paramètres de votre projet sur le côté gauche de l'écran et cliquez sur "Activer le projet".

Ensuite, retournez à la vue d'ensemble des APIs et allez dans [Votre API Conrad] > Paramètres, où vous pourrez activer l'API en cliquant sur "Activer API".

Une fois l'API activée, retournez à la vue d'ensemble des APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits à Conrad.

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

Pour vérifier s'il y a des erreurs, rendez-vous sur la page Résultats de l'API > Erreurs, où vous verrez quelles annonces ont des erreurs. En cliquant sur une erreur spécifique, vous obtiendrez plus d'informations sur la cause de l'erreur. Pour plus d'informations sur la signification des erreurs, consultez cet article. En complément, vous trouverez de nombreuses informations dans le Centre d'aide de Conrad.