Importer et mettre à jour des produits avec une feuille de calcul#

Téléchargez un modèle de catégorie, renseignez vos produits et envoyez-le dans le Catalogue. Ce processus ne nécessite ni code ni identifiants d’API.

Avant de commencer#

Sélectionnez la bonne boutique dans le Tableau de bord. Vous devez disposer de l’autorisation de modifier son catalogue. Si le bouton Télécharger la feuille de calcul des produits n’apparaît pas, vérifiez la boutique sélectionnée, vos droits d’écriture dans le catalogue et si votre compte est en lecture seule.

Télécharger le modèle de catégorie#

1. Ouvrez Tableau de bord → Catalogue.
2. Cliquez sur Télécharger la feuille de calcul des produits pour ouvrir la boîte de dialogue Importer des produits.
3. Sous Choisir la catégorie de produit, sélectionnez la catégorie à importer. Les options dépendent de la configuration de votre boutique.
4. Cliquez sur Télécharger le modèle Excel. Utilisez un modèle et un envoi distincts pour chaque catégorie.

Téléchargez un nouveau modèle à chaque nouvelle importation afin que ses colonnes correspondent aux exigences actuelles de la catégorie. Le classeur téléchargé est un modèle, et non un export de votre catalogue existant.

Remplir le classeur#

Utilisez les feuilles du classeur comme suit :

Chaque ligne de produit doit contenir sku, name, image_url et product_url, ainsi que les dimensions obligatoires de sa catégorie. Respectez les indications de champs obligatoires et les instructions du modèle téléchargé. Ne traduisez pas les noms des champs et n’ajoutez pas de colonnes inconnues ou en double.

• Conservez les cellules SKU au format texte pour éviter que le tableur ne supprime les zéros initiaux ou ne modifie les identifiants longs. Utilisez une ligne par SKU ; les doublons dans un même fichier sont rejetés, y compris les valeurs qui ne diffèrent que par la casse.
• Pour image_url, utilisez une adresse d’image directe en HTTP ou HTTPS, accessible publiquement sans connexion, cookies ni en-têtes de requête personnalisés. Indiquez l’adresse de la fiche produit dans product_url.
• Indiquez les dimensions et les unités en suivant les instructions du modèle. Si aucune unité n’est précisée dans une dimension ou dans dimension_unit, la valeur par défaut est in.
• Choisissez status parmi les valeurs acceptées dans Enums. Si ce champ reste vide, sa valeur par défaut est active ; renseignez-le explicitement lors des mises à jour de produits.

Enregistrez le fichier au format .xlsx (recommandé). Le format .csv est également accepté s’il contient uniquement la ligne d’en-tête des produits et les données. Les anciens fichiers .xls ne sont pas pris en charge. Chaque fichier peut contenir jusqu’à 50,000 lignes de produits non vides et ne doit pas dépasser 50 MB.

Envoyer le fichier et vérifier le résultat#

1. Revenez à la boîte de dialogue d’importation et sélectionnez la même catégorie que celle du modèle.
2. Sous Complétez et téléchargez, choisissez le fichier enregistré, puis cliquez sur Début de l'importation.
3. Consultez Importations récentes pour vérifier le nom du fichier, l’état du traitement et le nombre de lignes réussies ou en échec. L’envoi confirme l’acceptation du fichier ; le traitement se poursuit en arrière-plan.
4. Attendez la fin du traitement et vérifiez les lignes en échec même si la tâche affiche Terminé. Revenez au Catalogue pour vérifier les données importées et si les produits sont prêts pour la visualisation.

Si des lignes échouent, cliquez sur Fichier d'échec, consultez les messages d’erreur, corrigez les données produit et envoyez le fichier corrigé avec la même catégorie. Le classeur d’échec téléchargé contient les lignes en échec et des colonnes de diagnostic ; ces colonnes de diagnostic sont ignorées lors d’un nouvel envoi.

En cas d’échec temporaire du traitement, utilisez Réessayer si cette option est proposée. Relancer la même tâche ne corrige pas les données produit invalides. Si l’interface indique que des lignes doivent être examinées par l’assistance, utilisez Contact support ; ces lignes ne sont pas relancées automatiquement.

Mettre à jour des produits existants#

Pour mettre à jour des produits, utilisez le même modèle de catégorie et conservez le SKU existant de chaque produit. Renseignez tous les champs obligatoires de chaque ligne incluse, modifiez les valeurs souhaitées et envoyez à nouveau le fichier.

• Le même SKU dans la même boutique met à jour le produit existant. Un SKU qui n’existe pas encore crée un nouveau produit. Modifier un SKU dans la feuille de calcul ne renomme pas le produit d’origine.
• Vous pouvez envoyer uniquement les lignes des produits à mettre à jour. Les produits absents du fichier ne sont ni supprimés, ni désactivés, ni dépubliés.
• Il ne s’agit pas d’une mise à jour partielle des champs : les champs obligatoires doivent toujours être renseignés. Ne supposez pas qu’une cellule facultative vide conserve la valeur précédente. En particulier, un status vide prend la valeur par défaut active, et les unités de dimension manquantes prennent la valeur par défaut in.
• Conservez votre propre classeur rempli pour les futures mises à jour. Le modèle téléchargé ne contient pas vos données produit actuelles.

Une fois la tâche terminée, vérifiez les produits concernés dans le Catalogue. Une importation réussie ne garantit pas à elle seule leur visibilité dans la boutique en ligne ; vérifiez leur état de préparation et la liste de vérification avant lancement du SDK.

Automatiser les importations#

Pour une synchronisation récurrente côté serveur, utilisez la Product Import API. Ses champs de requête, ses limites et son comportement de mise à jour partielle sont documentés séparément de ce processus par feuille de calcul.