Vérifié le 09/09/2026

This guide is currently available in French. An English translation has not been published yet.

Résoudre une erreur d’import catalogue

Lire le rapport avant de corriger

Depuis Commerce → Catalogue, ouvrez « Voir le dernier rapport » de la source, ou « Voir le rapport d’import » après un fichier. Vérifiez le nom, la date et le format. Les compteurs donnent les lignes analysées, acceptées et rejetées, ainsi que les ajouts, mises à jour et archivages. Les lignes acceptées ne sont pas nécessairement autant de produits : plusieurs variantes peuvent être regroupées.

« Correspondances retenues » montre les colonnes réellement utilisées. « Avertissements » signale des données incomplètes. « Lignes rejetées » indique une référence, un numéro et un ou plusieurs motifs. Le détail est limité aux 200 premiers rejets : le compteur total peut être supérieur. Les numéros sont des repères de données ; avec du XML ou des cellules CSV multilignes, ne les assimilez pas systématiquement à un numéro de ligne dans l’éditeur de texte. Cherchez aussi l’identifiant.

« Aucune ligne rejetée » n’atteste pas la présence d’images prêtes, la disponibilité en stock ou la possibilité de publier. Vérifiez aussi que le total de lignes est supérieur à zéro.

Corriger les données

Message ou observation	Action concrète	Vérification après correction
Ajoute un fichier CSV ou XML / catalogue vide	Sélectionner un fichier non vide et vérifier qu’il contient des lignes après l’en-tête	Total de lignes supérieur à zéro
Catalogue trop volumineux / trop de lignes	Pour un fichier, rester sous 5 000 000 octets et 5 000 lignes ; préparer un jeu réduit uniquement pour une nouvelle source de démonstration	Le parsing démarre sans erreur de taille
Colonnes absentes ou dupliquées	Donner à chaque colonne un nom non vide et unique ; supprimer les colonnes vides, vérifier le séparateur	Les correspondances retenues sont correctes
Valeur CSV entre guillemets non fermée	Fermer la cellule et doubler les guillemets littéraux ; réexporter en UTF-8	Le fichier est analysé
Aucun produit `<item>` ou `<entry>`	Exporter un flux XML avec ces éléments, puis choisir XML	Des lignes sont reconnues
DTD ou entités XML refusées	Exporter un XML sans `DOCTYPE` ni déclaration `ENTITY`	L’analyse n’est plus bloquée par la structure
Champ id/title/price non identifié	Renommer les colonnes ou renseigner le mapping attendu → colonne exacte	Ces trois correspondances apparaissent dans le rapport
Mapping JSON invalide	Utiliser un objet JSON avec guillemets doubles, valeurs texte, sans virgule finale	Le formulaire accepte le mapping
Identifiant manquant	Renseigner un `id` stable et distinct pour la variante	La référence n’est plus rejetée
Titre manquant	Renseigner `title` pour chaque ligne	Le titre apparaît dans le catalogue
Prix ou devise invalide	Utiliser par exemple `24.90` et `EUR`, sans prix négatif ni texte libre	Le prix attendu figure sur la variante
URL d’image invalide	Remplacer par une URL HTTP(S) valide et accessible ; ou vider ce champ facultatif pour un essai sans image	Plus de rejet URL ; vérifier séparément la préparation de l’image
Stock absent ou invalide	Fournir un entier positif ou zéro et corriger la correspondance `stock_quantity`	Le compteur de stocks manquants diminue
Stock zéro	Vérifier si la rupture est voulue ; sinon corriger le stock réel dans la source	La disponibilité correspond au stock attendu
Plusieurs devises	Préparer une sélection cohérente avec une seule devise avant publication	Les produits destinés à une boutique partagent la devise attendue
Aucune image mais ligne acceptée	Ajouter une image dans la source, puis contrôler sa récupération ; la ligne seule ne certifie pas une photo prête	L’image réellement préparée est visible
Même référence répétée / règle serveur refuse le catalogue	Donner un identifiant unique à chaque variante, garder le groupe commun et vérifier les devises ; tester le petit jeu valide du guide	Rapport terminé et références sans conflit

Corriger un problème de synchronisation

Symptôme	Action concrète
URL non HTTPS	Fournir l’adresse HTTPS réelle du feed lors de la création
Feed inaccessible, protégé ou réponse HTML	Ouvrir l’URL pour vérifier qu’elle livre le flux attendu ; faire corriger l’accès public et le type de réponse chez l’hébergeur, sans ajouter de secret dans l’URL
Feed trop gros pour le droit accordé	Vérifier les limites de la formule avec l’administrateur ; réduire le feed complet de manière maîtrisée ou obtenir la capacité nécessaire avant relance
File en attente / traitement en cours	Actualiser le suivi ; si la date attendue est dépassée durablement, transmettre nom de source, heure et dernier message au responsable du projet
Synchronisation en pause pour abonnement	Faire rétablir les droits éligibles ; actualiser puis relancer lorsque disponible
Cette session ne peut pas modifier ce projet	Vérifier le projet actif et demander à son administrateur un rôle autorisé ; ne pas répéter l’import sous le même accès refusé
Configuration Commerce ou synchronisation indisponible	Faire finaliser la configuration technique par le responsable du projet ; un nouvel import ne corrige pas cette configuration
« This page couldn’t load » / erreur serveur à l’ouverture du rapport	Recharger une fois ; si l’erreur persiste, conserver son code et le lien du rapport pour le responsable technique. Le succès de l’import peut être confirmé dans la carte source, mais ne prouve pas que le détail du rapport est accessible
Rapport introuvable	Revenir à la source dans le bon projet et ouvrir son dernier rapport actualisé ; conserver le lien en erreur pour le référent si le problème persiste

Après correction d’un feed URL, synchronisez la même source et comparez le nouveau rapport. Pour un fichier, le formulaire crée une nouvelle source : vérifiez la stratégie avec le responsable du catalogue avant de le renvoyer. Ne tronquez pas un feed existant pour « réessayer les seules erreurs » : des produits absents du nouveau feed peuvent être retirés.

Exercice de rejet contrôlé

Dans un projet de démonstration, ce CSV produit une ligne acceptée et deux rejetées au parsing :

id,title,price,currency,stock_quantity
DEMO-OK,Carnet valide,9.50,EUR,3
DEMO-SANS-TITRE,,9.50,EUR,3
DEMO-PRIX,Carnet prix invalide,-2,EUR,3

Corrigez le titre de DEMO-SANS-TITRE et remplacez -2 par 9.50. Le parsing corrigé doit accepter les trois lignes. Ne mélangez pas cet exercice avec une source marchande existante.