Planifiez le transfert maîtrisé de votre catalogue Trendyol vers une boutique que vous gérez, en couvrant le mapping des champs, les variantes, les prix, les stocks, les médias et la validation.
Transférer des produits de Trendyol vers un canal e-commerce que vous gérez ne consiste pas à copier des intitulés et des prix d’un fichier à un autre. Une migration fiable rapproche l’identité des produits, les attributs de catégorie, les liens entre variantes, les stocks, la fiscalité, les droits sur les médias et les opérations après commande au sein d’un même modèle de données. L’objectif n’est pas d’arrêter les ventes sur la marketplace, mais d’ouvrir un canal supplémentaire dans lequel la marque maîtrise son catalogue.
La documentation officielle des développeurs Trendyol présente V2 comme l’espace d’intégration actuel. Les points de terminaison et les champs requis peuvent évoluer : la mise en œuvre doit donc toujours suivre la documentation V2 en vigueur et les autorisations attribuées au compte marchand. Le scraping d’écran, la copie automatisée depuis l’interface destinée aux consommateurs ou l’extraction non autorisée de données ne sont pas des méthodes d’intégration pérennes.
Déterminez d’abord ce qui peut être transféré
Séparez les données en trois catégories :
- Données de référence de la marque : le SKU propre à la marque, le code-barres, le nom du produit, sa description, son coût, son taux de taxe et les médias pour lesquels elle détient des droits d’utilisation.
- Données du canal : les identifiants de produit ou de marchand Trendyol, le mapping des catégories, le prix sur le canal et les codes de statut propres à la marketplace.
- Données susceptibles d’appartenir à la plateforme ou à des tiers : les avis clients, les notes, les badges, la mise en page des pages et les éléments produits par la plateforme.
Construisez la nouvelle boutique à partir de la première catégorie. Ne conservez la deuxième qu’à des fins de mapping et de rapprochement. Vérifiez explicitement les droits avant de transférer des éléments de la troisième catégorie. En particulier, ne partez pas du principe que les notes et les avis clients sont des contenus de catalogue que la marque peut reproduire librement.
Créez un dictionnaire de mapping source-cible
Avant la migration, préparez un dictionnaire de données validé par toutes les parties prenantes :
| Concept source | Champ cible | Règle de transformation | Comportement en cas d’erreur |
|---|---|---|---|
| merchantSku | canonicalSku | Supprimer les espaces superflus ; respecter la casse | Mettre en quarantaine si le champ est absent |
| barcode | barcode | Conserver au format texte et préserver les zéros initiaux | Bloquer en cas de doublon |
| productMainId | productGroupKey | Regrouper les variantes sous un même produit | Signaler les variantes orphelines |
| categoryId | targetCategoryId | Utiliser une table de mapping approuvée | Conserver en brouillon si aucune correspondance n’est trouvée |
| attributes | attributes | Normaliser le code, la valeur et l’unité | Ne pas publier si des données obligatoires manquent |
| salePrice | channelPrice | Appliquer les règles de taxe et de marge | Demander une approbation sous le seuil |
| quantity | sourceInventory | Déduire le stock de sécurité ; ramener le résultat à zéro au minimum | Déclencher une alerte d’anomalie |
| imageUrls | mediaAssets | Vérifier l’accès HTTPS, le format et les droits | Ne pas publier les médias qui échouent aux vérifications |
Même un intitulé de produit demande du discernement. Un titre de marketplace surchargé de mots-clés peut ne pas convenir au ton éditorial de la boutique. Conservez un nom neutre dans le catalogue de référence et générez des intitulés propres à chaque canal. Appliquez le même principe aux descriptions, aux textes SEO et aux promesses de livraison.
Le modèle des variantes est le point essentiel
Les choix de couleur, de taille et de volume peuvent apparaître sous forme de lignes de produits distinctes dans la source, alors que la boutique cible les présente comme des options sur une seule fiche produit. Préservez le lien entre chaque variante et son SKU, son code-barres, son stock, son prix et ses médias.
Réduire, par exemple, une variante « Noir / 38 » à « 38 » crée un risque de préparation et d’expédition du mauvais article. Une clé de variante peut être une combinaison déterministe des codes couleur et taille, mais elle doit rester stable. Testez le produit parent et la matrice des variantes pour vérifier les points suivants :
- Deux variantes d’un même groupe ont-elles la même combinaison d’options ?
- Un même code-barres est-il associé à plusieurs SKU actifs ?
- Chaque variante a-t-elle un stock vendable et un prix ?
- Une image appartient-elle au produit parent ou à une couleur particulière ?
- Une variante inactive dans la source est-elle réactivée par erreur dans la cible ?
Une architecture d’intégration plus sûre
Un pipeline direct « lire depuis Trendyol, écrire dans la boutique en ligne » est fragile. Ajoutez une couche de préproduction observable :
Connexion à la source autorisée → zone de données brutes → transformation/mapping → validation → catalogue de référence → publication dans la boutique
Une réponse brute horodatée facilite l’analyse des incidents, mais les données personnelles ou secrètes inutiles ne doivent pas être conservées et l’accès doit être restreint. Les transformations doivent pouvoir être répétées : traiter deux fois la même version source ne doit pas créer de doublons de produits. Une combinaison de l’identité du marchand source, du SKU et de la version des données peut servir de clé d’idempotence.
Le connecteur doit respecter les limites officielles, réessayer les erreurs transitoires en augmentant progressivement le délai et éviter de réessayer indéfiniment les erreurs 4xx permanentes. Les identifiants ne doivent pas figurer dans le code ni dans l’URL d’un flux ; conservez-les dans un système de gestion des secrets et accordez le minimum de privilèges. Le compte marchand qui utilise l’intégration doit y être explicitement autorisé.
Distinguez la migration initiale de la synchronisation continue
Le premier transfert du catalogue est un projet ; les mises à jour des stocks et des prix sont des opérations continues.
- Chargement initial : importer les données produit, les variantes, les attributs et les médias sous forme de brouillons.
- Synchronisation des stocks : mettre à jour les quantités vendables à intervalles rapprochés et appliquer une marge de sécurité propre au canal.
- Synchronisation des prix : désigner une source de prix approuvée par la finance ; les modifications automatisées ne doivent pas faire passer la marge sous son seuil minimal.
- Synchronisation des contenus : placer les changements dans une file de révision au lieu d’écraser automatiquement les contenus enrichis de la boutique.
- Désactivation : ne pas supprimer un article lorsqu’il disparaît de la source ou que sa vente y est interrompue ; le rendre inactif tout en conservant les liens vers les commandes en cours et les rapports.
Lorsque les deux canaux vendent le même stock physique, la « dernière quantité connue » ne suffit pas. Il faut gérer la réservation entre l’ajout au panier et le paiement, la remise en stock après annulation et une politique de gestion des ventes excédentaires. Pour les produits critiques, la protection la plus simple consiste à répartir les stocks par canal ou à appliquer une marge de sécurité.
Trois étapes de validation
Étape 1 — schéma : champs obligatoires, types, longueurs, valeurs autorisées, unicité et relations entre références.
Étape 2 — commercial : TVA, prix catalogue/prix de vente, marge contributive minimale, stocks, éligibilité à la vente et droits sur les médias.
Étape 3 — expérience : affichage sur mobile, sélection des variantes, ajout au panier, recherche/filtres, informations de livraison et passage en caisse.
Le rapport automatisé de rapprochement doit au minimum indiquer le nombre de produits source par rapport aux lignes importées ; le nombre de SKU et de codes-barres uniques ; le total des produits parents et des variantes ; les produits publiés, en brouillon et en quarantaine ; les images inaccessibles ; ainsi que les anomalies de prix ou de stock. Ajoutez un échantillonnage humain par catégorie.
Exemple concret de migration
Prenons une marque d’articles pour la maison qui compte 600 lignes de produits sur Trendyol. L’analyse révèle qu’elles correspondent à 420 produits parents et 180 variantes. La première vague se limite à 80 produits parents ayant enregistré des ventes au cours des 90 derniers jours et disposant d’un stock fiable. Son mapping de catégories définit 12 catégories cibles, 46 attributs obligatoires et sept conversions d’unités. Les produits sont importés dans une boutique en brouillon ; 11 codes-barres manquants, huit SKU en doublon et 17 images inaccessibles sont mis en quarantaine. Rien n’est publié tant que ces problèmes ne sont pas résolus. Après approbation, 10 produits sont d’abord ouverts à la vente, puis les 80 ; 20 commandes de test vérifient de bout en bout les stocks, l’expédition et les retours.
RACI : qui est responsable de chaque décision de migration ?
| Chantier | Réalisateur | Responsable final | Consultés | Informés |
|---|---|---|---|---|
| Connexion officielle et sécurité | Équipe intégration/technologie | Responsable technologie | Responsable du compte Trendyol | E-commerce |
| Mapping des champs et catégories | Opérations catalogue | Responsable e-commerce | Produit, SEO | Support |
| Prix et taxes | Finance | Responsable finance | E-commerce | Direction |
| Droits sur les médias et les textes | Marque/contenu | Responsable de marque | Juridique | Équipe catalogue |
| Stocks et commandes | Opérations | Responsable des opérations | Technologie, finance | Support |
| Décision de mise en ligne | Chef de projet | Responsable e-commerce | Responsables de tous les chantiers | Entreprise |
Liste de contrôle avant mise en ligne
- La documentation officielle V2 en vigueur et les autorisations du compte ont-elles été confirmées ?
- L’identité de la source et le SKU de la marque sont-ils distincts et traçables ?
- Les mappings de catégories et d’attributs sont-ils versionnés et approuvés ?
- La matrice des variantes, l’unicité des codes-barres et le lien avec les médias ont-ils été validés ?
- Les règles de prix, de taxe, de marge minimale et de sécurité des stocks ont-elles été testées ?
- L’intégration peut-elle être relancée sans générer de doublons de produits ?
- Une personne est-elle désignée pour gérer la file d’erreurs, les alertes, les nouvelles tentatives et les corrections manuelles ?
- Au moins un scénario d’annulation, de retour et de rupture de stock a-t-il été testé avec une commande réaliste ?
Une fois la migration du catalogue stabilisée, ne vous contentez pas de mettre les produits en ligne dans la nouvelle boutique. Associez certaines collections à des vitrines de créateurs afin de stimuler la demande pour ce nouveau canal. Consultez le guide des flux de produits pour les vitrines de créateurs pour passer à l’étape suivante.
Commencer l’inscription en tant que vendeur e-commerce ou créer un compte de marque pour intégrer votre catalogue à un canal que vous gérez et à un réseau de vente par influenceurs dans le cadre d’un processus maîtrisé.