Important : Toutes les APIs CDiscount doivent être migrées vers la V2 avant le 31 mars 2025.
Dans le cadre de la transition de CDiscount vers Octopia, toutes les APIs CDiscount doivent être migrées vers CDiscount V2 avant le 31 mars. Cette migration est nécessaire car les APIs CDiscount existantes cesseront de fonctionner après cette date.
La nouvelle API Octopia offre une meilleure vitesse et une meilleure stabilité. Elle fournit également des messages d'erreur plus détaillés pour les offres et les produits.
Table des matières :
- Étape 1 : Trouver et noter mes identifiants vendeur
- Étape 2 : Trouver et noter mon ID vendeur
- Étape 3 : Créer une nouvelle connexion
- Étape 4 : Migrer mon API
- Étape 5 : Mapper les catégories
- Étape 6 : Remplir les attributs
- Étape 7 : Activer mon API et résoudre les erreurs
Avant de commencer
Vous aurez besoin de :
- Un compte vendeur Octopia
Étape 1 : Trouver et noter mes identifiants vendeur
- Connectez-vous à votre compte vendeur Octopia.
- Ouvrez la page API Credentials Management.
- Cliquez sur I’m using a Feed aggregator’ > My aggregator requires a clientId, clientSecret and SellerId.
- Définissez un ID client et une adresse email valide.
- Cliquez sur la case à cocher pour accepter les conditions générales.
- Cliquez sur Confirm ID and email.
- Notez votre Client ID et votre ClientSecret, vous en aurez besoin plus tard.
- Cochez la case pour confirmer que vous avez sauvegardé vos informations d'identification et cliquez sur Proceed with seller authentication.
- Cliquez sur Yes, continue lorsque l'on vous demande d’autoriser l'accès à votre compte.
Étape 2 : Trouver et noter mon ID vendeur
- Dans votre compte vendeur, cliquez sur Paramètres. Notez votre ID vendeur, car vous en aurez besoin plus tard.
Étape 3 : Créer une nouvelle connexion
- Accédez à [Votre projet] > APIs.
- Cliquez sur + Ajouter nouvelle API. Vous serez redirigé(e) vers la page des connexions de votre compte.
- Sur la page des connexions, sélectionnez + Ajouter une nouvelle connexion.
- Recherchez la connexion “CDiscount V2” et sélectionnez-la.
- Remplissez les informations de cette nouvelle connexion.
- Pour Nom, choisissez le nom de votre connexion (par exemple CDiscount V2).
- Pour Client ID, indiquez votre Client ID obtenu à l'étape 1.
- Pour Client secret, indiquez votre ClientSecret obtenu à l'étape 1.
- Pour l'ID du Vendeur, indiquez l'ID Vendeur que vous avez noté à l'étape 2.
- Cliquez sur Se connecter avec Cdiscount V2.
Étape 4 : Migrer mon API
- Dans [Votre projet], allez dans APIs et sélectionnez [Votre API CDiscount].
- Dans [Votre API CDiscount], allez à l'étape Paramètres et cliquez sur ⚠ Migrez votre API.
- Dans le menu latéral, retournez sur API. Vous devriez voir votre nouvelle API CDiscount V2.
Étape 5 : Mapper les catégories
- Dans votre nouvelle API V2, allez à l'étape Catégories.
- Catégorisez manuellement les produits qui n'ont pas été migrés automatiquement.
- Cliquez sur Sauvegarder.
Étape 6 : Remplir les attributs
- Passez à l'étape Construire.
- Dans l'onglet “Attributs partagés”, assurez-vous que tous les champs marqués comme obligatoires par la marketplace sont liés avec le champ approprié de vos données.
- Si vous téléchargez de nouvelles données produits qui n'existent pas sur CDiscount, remplissez les champs marqués comme recommandés.
- Dans la section Informations d'expédition, cliquez sur + Livraison.
- Pour Type de livraison, choisissez votre type de livraison. Vous devez au minimum avoir ajouté le type de livraison Suivi.
- Dans la section Frais de port, indiquez la valeur correspondante ou sélectionnez un champ approprié. Vous pouvez également en créer un s'il n'existe pas encore.
- Cliquez sur Sauvegarder.
- Allez dans l'onglet “Attributs par catégorie” et remplissez tous les champs obligatoires.
- Passez à l'étape Qualité.
- Examinez et corrigez tous les produits contenant des erreurs.
Étape 7 : Activez mon API et résoudre les erreurs
- Lorsque vous êtes prêt(e) à démarrer, revenez à l'étape Paramètres et cliquez sur Activer l'API.
- Cliquez sur Exécuter pour envoyer vos annonces produits à CDiscount.
- Passez à l'étape Résultat pour vérifier si des produits présentent des erreurs. Vous pouvez cliquer sur une erreur pour en obtenir un aperçu.
Depuis les Attributs, survolez les “?” pour en savoir plus sur les valeurs acceptées, ou cliquez sur le champ et sélectionnez Valeurs statiques pour afficher une liste des valeurs autorisées.
Étape 8 : Migrer votre connexion de commande
Si vous avez une connexion de commande CDiscount, elle devra aussi être migrée.
Voici comment procéder :
- Allez dans Installation > Commandes. Dans votre connexion de commande CDiscount, cliquez sur Paramètres.
- Cliquez sur Mettez à niveau votre Connexion commande.
- Sélectionnez la même connexion V2 que vous avez utilisée à l'étape 3 et cliquez sur Migrer.