Import CSV PrestaShop : erreur, causes et corrections
Une erreur d'import CSV PrestaShop ne s'affiche pas toujours. Dans le code de PrestaShop 8.2, un prix « 1 299 » devient 1, un « non » active le produit et une valeur refusée sur la fiche écarte la ligne sans message. Voici ce que l'importeur lit, valeur par valeur, et comment compter ce qui est entré.
Par Support Suricate Concept · · 11 min de lecture

À retenir en 30 secondes
- La barre peut afficher « 100 % imported » alors que des lignes manquent : comptez les produits avant et après.
- Un prix s'écrit en chiffres avec un point : « 1299.00 ». L'espace de milliers coupe le nombre, sans erreur.
- Dans la colonne « actif », seuls 0 et la cellule vide désactivent. « non » et « false » activent.
- Une cellule vide n'est pas neutre : un prix vide met le prix à 0, une description vide efface la description.
- Un identifiant de catégorie inconnu crée une catégorie, une ligne sans identifiant crée un doublon.
- Testez sur trois lignes, après une sauvegarde de la base.
Quatre réglages à vérifier avant l'envoi
Ils portent sur le fichier, pas sur vos produits. Si vous importez pour changer des prix, la méthode complète est dans le guide sur les prix en masse.
Le téléversement refuse d'abord les extensions inconnues : seuls csv, xls, xlsx, xlst, ods et ots passent, et le message réclame un fichier « .csv ». La taille compte aussi. Un fichier plus gros que la limite du serveur déclenche un message qui cite la directive upload_max_filesize ou post_max_size de la configuration PHP. Deux issues : découper le fichier, ou demander à votre hébergeur de relever la limite.
L'encodage vient ensuite. La documentation demande de l'UTF-8 et, à défaut, de l'ISO-8859-1. Le code de PrestaShop 8.2 va plus loin : si le fichier n'est pas de l'UTF-8 valide, chaque cellule est convertie comme de l'ISO-8859-1. Les caractères propres à Windows-1252, le signe euro ou le « œ », n'existent pas dans cette table : ils risquent de ressortir abîmés. C'est une déduction de ce que fait le code, pas un cas que nous avons testé. Rouvrez le fichier dans un éditeur de texte avant l'envoi et vérifiez les accents.
Le séparateur, ensuite. La documentation recommande le point-virgule. Un texte qui en contient (une description, par exemple) oblige à les retirer ou à choisir un autre séparateur. Si l'écran de correspondance range toutes vos données dans la première colonne, le séparateur choisi n'est pas celui du fichier. Avec un tableur .xls ou .xlsx, vous ne choisissez aucun séparateur.
Dernier réglage : la ligne de titres. Le champ « Rows to skip » doit valoir 1 si la première ligne contient les intitulés. Chaque ligne doit compter le même nombre de colonnes, et les lignes entièrement vides sont ignorées avec un avertissement.
Ce que l'importeur fait de chaque valeur
PrestaShop traite le fichier deux fois. La fenêtre de progression annonce « 100 % validated » puis « 100 % imported ». La conversion des valeurs, elle, est écrite dans le code, et elle surprend. Le tableau relève ce que fait PrestaShop 8.2 de quelques valeurs courantes.
| Colonne | Valeur dans le fichier | Ce que PrestaShop en fait |
|---|---|---|
| Prix HT, prix TTC, prix d'achat | 12,90 | 12.9 : la virgule devient un point |
| idem | 12,90 € | 12.9 : la lecture s'arrête au premier caractère qui ne peut pas faire partie d'un nombre |
| idem | €12,90 | 0, sans erreur : la lecture ne trouve aucun nombre au début |
| idem | 1 299 | 1, sans erreur : la lecture s'arrête à l'espace |
| idem | 1,299 ou 1.299,00 | 1.299, sans erreur : lecture du premier nombre |
| Actif (0/1) | non, false, oui | actif dans les trois cas : seuls « 0 » et la cellule vide sont faux |
| En promotion, disponible à la commande, afficher le prix | oui, TRUE | valeur refusée : la ligne n'est pas enregistrée |
| EAN-13 | 3,76E+12 ou plus de 13 chiffres | valeur refusée : la ligne n'est pas enregistrée |
| Nom | Chaise #3 | refusé : les caractères < > ; = # { } sont interdits |
| Référence | REF;12 | refusée : les caractères < > ; = { } sont interdits |
| Prix, prix d'achat, actif (colonne mappée) | cellule vide | prix mis à 0, ou produit désactivé : le traitement renvoie 0 ou faux, et ces valeurs sont écrites |
| Nom, descriptions, meta (champs par langue) | cellule vide | la valeur existante est remplacée par du vide dans la langue du fichier, et possiblement dans les autres langues de la boutique |
| Référence, EAN, catégorie | cellule vide | la valeur existante du produit n'est pas modifiée |
Les premières lignes montrent la mécanique. Pour les prix, PrestaShop remplace la virgule par un point, retire le signe %, puis convertit en nombre. PHP lit alors le nombre qui ouvre la chaîne et ignore le reste ; sans nombre au début, il donne zéro. C'est le comportement documenté de la conversion d'une chaîne en nombre. Un prix « 1 299 » entre donc à 1 euro, et l'importeur n'affiche aucun avertissement. Le même mécanisme traite la colonne « actif » : tout texte non vide autre que « 0 » est vrai pour PHP.
Pour le reste, PrestaShop applique les règles de sa fiche produit. Une valeur qui les enfreint fait échouer la ligne. Reste à savoir ce que vous voyez à l'écran. Dans le gestionnaire d'import des produits de la branche 8.2.x, le bloc qui enregistre la ligne ne s'exécute que si les champs du produit sont valides. Dans le cas contraire, aucun message n'est ajouté. Nous n'avons pas rejoué l'import sur une boutique 8.2 et la lecture d'un code ne remplace pas un test. Elle est cohérente avec des lignes absentes sans explication. L'ancien importeur, toujours présent dans le même dépôt, ajoutait un message qui nommait le champ fautif, sous la forme « Property Product->ean13 is not valid ».
Des messages existent dans d'autres cas : un fabricant, un fournisseur ou une catégorie qui ne peut pas être créé, ou un enregistrement qui échoue en base. Ils ressemblent à « Nom (ID: 12) cannot be saved », suivi du détail. Dans « No Name (ID: No ID) cannot be saved », « No ID » est banal : c'est ce qu'affiche une création sans colonne d'identifiant. « No Name » peut en revanche signaler des colonnes décalées dans l'écran de correspondance (hypothèse).
Les erreurs d'import CSV PrestaShop qui ne disent rien
Comptez d'abord. Après un import, le nombre de produits du catalogue doit égaler l'ancien total plus le nombre de lignes de création (une mise à jour n'en ajoute pas), la ligne de titres exclue. Un écart désigne des lignes écartées ; triez le fichier par colonne pour retrouver celles qui portent un EAN, un nom ou une référence suspects.
La catégorie fantôme est la deuxième surprise. Quand une cellule de catégorie contient un nombre qui ne correspond à aucune catégorie, PrestaShop ne refuse pas la ligne. Il crée une catégorie qui porte ce nombre comme nom, sous la catégorie d'accueil. Une faute de frappe sur un identifiant (45 au lieu de 54) laisse donc une catégorie « 45 » dans le catalogue, et le produit dedans. Le même code semble créer la catégorie quand la cellule contient un nom : vérifiez l'orthographe de chacun. Après l'import, ouvrez Catalogue > Catégories et repérez les entrées que vous n'avez pas créées. Pour en défaire une, déplacez ses produits vers la bonne catégorie, puis supprimez-la.
Le doublon vient d'une ligne sans identifiant. L'importeur met à jour un produit quand la ligne porte un identifiant existant ou, si l'option « Use product reference as key » est cochée, une référence existante. Sinon il en crée un nouveau. Réimportez le fichier sans identifiant ni option, et chaque produit existe deux fois. La documentation précise que l'option de référence suppose une référence sur toutes les lignes. À l'inverse, ne recopiez pas la colonne d'identifiants d'une autre boutique : un identifiant rempli désigne le produit à modifier.
L'option « Delete all before import » efface tous les enregistrements existants du type importé, pour repartir d'une base vide. La page de documentation ne décrit ni retour arrière ni sauvegarde.
Le tableur, enfin. Excel retire les zéros initiaux d'un code (00123 devient 123) et affiche les longs nombres en notation scientifique, avec une précision de 15 chiffres. Une référence ou un EAN qui passe par une cellule de format Nombre arrive abîmé dans le fichier. Un EAN dont le zéro initial a disparu compte 12 chiffres : il passe la validation sans bruit, avec une valeur fausse. Mettez ces colonnes au format Texte avant de saisir ou de coller les données.
Un avertissement, lui, apparaît : un identifiant de règle de taxe inconnu donne « Unknown tax rule group ID. You need to create a group with this ID first. ». C'est un avertissement, pas une erreur : la ligne passe. Relisez les prix TTC de ces produits.
Les images : le produit entre, la photo parfois non
L'échec d'une image n'arrête pas la ligne. Le produit est enregistré, puis PrestaShop tente de copier chaque image. En cas d'échec, il supprime l'entrée d'image et ajoute un avertissement : « Error copying image: » suivi de l'adresse, ou « Product #12: the picture (adresse) cannot be saved ». Un import peut donc afficher « 100 % imported » et laisser des fiches sans photo.
Trois causes à vérifier. L'adresse doit être absolue, c'est-à-dire complète, avec son https:// : celle qu'on peut coller dans un navigateur. Elle doit aussi s'ouvrir sans mot de passe, car le serveur de la boutique n'en saisit pas (déduction). Enfin, depuis les correctifs publiés le 18 août 2026 (versions 8.2.8 et 9.1.5), l'importeur télécharge les images par une voie durcie. Seuls http, https, ftp et ftps passent. Le nom de domaine doit pointer vers une adresse publique, et chaque redirection est revérifiée. Une image servie par une adresse privée est donc refusée. C'est le cas d'un serveur de préproduction placé sur un réseau interne. Ce point vient de la lecture de la branche 8.2.x : sur une version plus ancienne, le comportement peut différer.
D'après le code, l'option « Skip thumbnails regeneration » évite à PrestaShop de régénérer les vignettes pendant l'import. La documentation la décrit de façon ambiguë. Si vous la cochez, régénérez les vignettes plus tard.
Tester sur trois lignes, avec une sauvegarde
Un import qui mélange tout (créations, mises à jour, images) se vérifie mal. Voici l'ordre qui limite les dégâts :
- Faites une sauvegarde de la base de données. La documentation d'import n'en parle pas et ne décrit aucun retour arrière.
- Partez du fichier d'exemple que PrestaShop propose au téléchargement sur la page d'import. Son en-tête commence par
Product ID;Active (0/1);Name *;Categories (x,y,z...);Price tax excluded. Il contient aussi des colonnes « Meta title » et « Meta description » : pour leur contenu, voir où régler la meta description. - Importez trois lignes : un produit à créer, un à mettre à jour, un avec image. Ouvrez les trois fiches et relisez-les comme le ferait un client, avec la méthode de relecture d'une fiche produit.
- Enregistrez la correspondance de colonnes sous un nom : PrestaShop sait la sauvegarder et la recharger.
- Pour le fichier complet, activez la notification par e-mail de fin d'import. Comptez ensuite les produits, comme décrit plus haut.
Une dernière précaution touche à la sécurité. L'avis GHSA-xrwj-pq6w-f8m4, publié le 18 août 2026, porte sur les adresses d'images de l'import CSV. Il demande de passer à la version 8.2.8 ou 9.1.5 et, en attendant, de retirer la permission d'import aux profils du back-office qui n'en ont pas besoin. Le guide pour sécuriser une boutique PrestaShop replace cette alerte dans une démarche d'ensemble.
Se faire aider sur un fichier de fournisseur
PrestaShop Copilot est un logiciel d'agents IA pour boutiques PrestaShop. Sur ce sujet, on lui joint un fichier CSV ou Excel et il fait correspondre les colonnes. Avant toute écriture, il montre ce qui sera créé ou modifié, et attend votre accord. Chaque ligne qu'il ne peut pas traiter, d'après ce que la boutique expose, est refusée et listée avec son motif, par exemple « nombre attendu, reçu « 12,90 € » » ou « valeur booléenne attendue (0 ou 1), reçu « oui » ». Les champs que le fichier ne contient pas sont relus sur la boutique et conservés. Une fois le lot écrit, il relit les fiches et permet de défaire tout ou une partie du lot.

L'import fait partie des formules Pro et Studio. Au-delà de 50 lignes, Copilot demande de confirmer que vous disposez d'une sauvegarde récente de la base. Essayer gratuitement, sans carte bancaire, pour lire un fichier de fournisseur sans rien écrire.
Questions fréquentes
Quel séparateur choisir pour un CSV PrestaShop ?
Le point-virgule, que la documentation recommande, avec la virgule comme séparateur de valeurs multiples. Le choix doit correspondre à votre fichier : l'écran d'import le demande explicitement.
Peut-on annuler un import CSV PrestaShop ?
La page de documentation de l'import ne décrit aucun retour arrière. La seule protection que nous ayons trouvée est la sauvegarde de la base, d'où l'étape de test sur trois lignes.
Pourquoi mes produits sont-ils importés en double ?
Parce que les lignes n'avaient ni identifiant ni référence reconnue : PrestaShop crée alors un nouveau produit. Cochez « Use product reference as key » et vérifiez que chaque ligne porte sa référence.
Pourquoi des produits manquent-ils alors que l'import affiche « 100 % imported » ?
Une ligne dont une valeur enfreint les règles de la fiche produit n'est pas enregistrée. D'après le code de la version 8.2.x, aucun message ne lui est associé. Des messages existent pour d'autres cas : catégorie, fabricant, fournisseur, taxe, image. Nous n'avons pas rejoué l'import pour le confirmer. Cherchez dans le fichier les EAN en notation scientifique, les noms avec un caractère interdit et les booléens écrits en toutes lettres.
Sources
- PrestaShop 9, documentation : page d'import.
- PrestaShop 8.2, code : ProductImportHandler.php, AbstractImportHandler.php, ImportDataFormatter.php, Product.php, CsvFileReader.php, Validate.php, Tools.php, FileUploader.php.
- PHP, manuel : chaînes numériques et booléens et nombres à virgule.
- Microsoft, Keeping leading zeros and large numbers.
Méthode : article préparé avec des outils d'IA à partir des sources ci-dessus et d'une lecture du code de PrestaShop 8.2 (branche 8.2.x), relevés le 30 octobre 2026. Nous n'avons pas rejoué chaque import sur une boutique : le comportement décrit vient du code publié et des manuels de PHP.
Questions fréquentes
Quel séparateur choisir pour un CSV PrestaShop ?
Le point-virgule, que la documentation recommande, avec la virgule comme séparateur de valeurs multiples. Le choix doit correspondre à votre fichier : l'écran d'import le demande explicitement.
Peut-on annuler un import CSV PrestaShop ?
La page de documentation de l'import ne décrit aucun retour arrière. La seule protection que nous ayons trouvée est la sauvegarde de la base, d'où l'étape de test sur trois lignes.
Pourquoi mes produits sont-ils importés en double ?
Parce que les lignes n'avaient ni identifiant ni référence reconnue : PrestaShop crée alors un nouveau produit. Cochez « Use product reference as key » et vérifiez que chaque ligne porte sa référence.
Pourquoi des produits manquent-ils alors que l'import affiche « 100 % imported » ?
Une ligne dont une valeur enfreint les règles de la fiche produit n'est pas enregistrée. D'après le code de la version 8.2.x, aucun message ne lui est associé. Des messages existent pour d'autres cas : catégorie, fabricant, fournisseur, taxe, image. Nous n'avons pas rejoué l'import pour le confirmer. Cherchez dans le fichier les EAN en notation scientifique, les noms avec un caractère interdit et les booléens écrits en toutes lettres.

