Comment importer des produits dans Magento 2 dans 2026: Le guide de travail pour 2.4.8 - FR

Adobe a livré Magento 2.4.8 en avril 8, 2025, et la manière dont les gros catalogues circulent sur la plateforme a finalement rattrapé 2026. Les points de terminaison d’importation REST natifs (/V1/importation/csv et /V1/importation/json) accepte désormais les charges utiles codées en base64 et la compression gzip. Cela tue le vieux “divisez votre CSV en 500 rangées et prier” routine. L'importateur CSV administrateur sur lequel la plupart des magasins s'appuient encore? Même outil, surtout. Mais la façon dont il se brise a changé, et les correctifs aussi. Ce guide couvre les deux chemins, et les erreurs qui rongent un week-end quand tu les manques.

Réponse rapide: Pour les catalogues sous 5,000 SKU, utilisez l'importateur CSV d'administration sous Système > Transfert de données > Importation. Pour tout ce qui est plus grand ou automatisé, frapper le REST /V1/import/point de terminaison csv ajouté dans 2.4.8. Conserver les fichiers UTF-8 sans BOM, déposer des images dans var/importation/images, et je cours toujours “Vérifier les données” avant de s'engager.

Dernière révision: avril 2026. Points de terminaison, numéros de version, et comportements d'importation vérifiés par rapport à Adobe Commerce 2.4.8 notes de version et documentation Experience League.

Avant de commencer: Ce qui a changé 2.4.8

Si vous avez importé des produits sur Magento 2.4.5 ou plus tôt, quelques défauts rattrapés par la réalité. Nouveau 2.4.8 les installations sont livrées avec les indexeurs dans Mise à jour par calendrier mode, afin que les importations en masse ne bloquent plus le frontend pendant la réindexation. La sortie est close 497 bogues principaux (plusieurs sur l'importateur lui-même) et ajouté les points de terminaison d'importation REST qui contournent le plafond de téléchargement administrateur de 2 Mo.

Voici ce dont vous avez besoin avant de toucher l’importateur:

• Magento 2.4.8 ou plus tard. En cours d'exécution 2.4.5 ou plus? Mettez à niveau d'abord. L'ancien importateur fonctionne toujours, mais les corrections de bugs ne sont pas rétroportées.
• PHP 8.3 le minimum, 8.4 conseillé. 2.4.8 livré avec PHP natif 8.4 soutien. Boutiques sur PHP 8.1 importera, mais la gestion des erreurs est plus bruyante.
• MySQL 8.0 ou MariaDB 10.6/11.4. 2.4.9-la version bêta 1 abandonne MySQL 8.0 et MariaDB 10.6, donc si vous effectuez une nouvelle configuration, aller 11.4.
• Un répertoire var/import/images accessible en écriture. Autorisations: 775 pour les répertoires, 664 pour les fichiers, appartenant à votre utilisateur Web.
• Limites PHP suffisantes. Pour les catalogues supérieurs 10,000 SKU, limite_mémoire 2G et max_execution_time 1800 dans php.ini. Des valeurs plus faibles tueront silencieusement les importations à mi-chemin.

Un avertissement rapide: Adobe Commerce (le niveau payant) et Magento Open Source partagent le code de l'importateur. Les clients cloud n'ont pas besoin de toucher à php.ini car la pile est pré-réglée, mais les règles et comportements CSV ci-dessous s'appliquent de manière identique.

Ce que vous pouvez réellement importer

Magento 2 a six types de produits, et les règles CSV changent en fonction de celle que vous déplacez. La version courte:

• Produits simples. Un SKU, une variante. Le modèle utilisé par chaque tutoriel. Importez-les d’abord si vous apprenez.
• Produits configurables. Un SKU parent avec des simples enfants attachés via variantes_configurables. Les t-shirts de taille et de couleur sont l'exemple classique. Les enfants doivent exister avant la ligne d'importation parent, ou le lien échoue.
• Produits virtuels. Prestations de service, abonnements, couverture de garantie. Pas de calcul d'expédition, aucune colonne de poids n'est nécessaire.
• Produits groupés. Un wrapper qui montre plusieurs simples sur une seule page (pense “ensemble de couteaux de cuisine, acheter individuellement”). Les usages skus_associés dans le CSV.
• Produits groupés. Créez vos propres combos où le client choisit les options. Le format est délicat et utilise bundle_values avec des champs séparés par des tuyaux.
• Produits téléchargeables. Des dossiers, licences de logiciels, ebooks. Besoins liens_téléchargeables configuré.

La commande d’importation est importante. Les simples d'abord, puis les configurables qui les référencent, puis regroupés et regroupés en dernier. L'importation d'un configurable dont les SKU enfants n'existent pas encore est l'erreur auto-infligée la plus courante, et le validateur ne l'attrapera pas toujours avant l'exécution de l'importation.

Importation CSV: La procédure pas à pas de l'administrateur

L'importateur CSV d'administration gère les catalogues jusqu'à environ 5,000 SKU sans plainte. A savoir même si vous prévoyez de passer à l'API plus tard, car les règles de colonnes qui suivent s'appliquent aux deux chemins.

Étape 1: Exporter un exemple de fichier (Ne sautez pas ça)

Aller à Système > Transfert de données > Importation. Ensemble Type d'entité à Des produits, puis clique Télécharger un exemple de fichier. L'exemple correspond exactement à votre installation Magento, y compris tous les attributs personnalisés que votre boutique a ajoutés. L'utilisation d'un modèle CSV générique à partir d'un article de blog est la façon dont les erreurs de non-concordance de colonnes commencent.

Enregistrez l'échantillon, ouvrez-le dans Notepad++ ou VS Code. N'utilisez pas Microsoft Excel. Excel ajoute une marque d'ordre d'octet aux fichiers UTF-8, et l'importateur rejette les fichiers préfixés par la nomenclature sans message d'erreur clair. Si Excel est votre seule option, exporter en tant que “CSVUTF-8” et exécutez le fichier via un outil de suppression de nomenclature, ou passez à Google Sheets (Fichier > Télécharger > CSV, qui enregistre un UTF-8 propre).

Étape 2: Remplissez vos lignes de produits

Colonnes obligatoires pour un produit simple: sku, store_view_code, attribut_set_code, type_produit, catégories, produits_websites, Nom, la description, prix, quantité, poids, produit_en ligne, nom_classe_taxe, visibilité.

Conservez les descriptions sous ~255 caractères par ligne si vous êtes sur l'importateur admin. Les descriptions HTML plus longues fonctionnent, mais ils gonflent rapidement la taille du fichier et rapprochent la limite par défaut de 2 Mo.. Les catégories utilisent des barres obliques pour construire une hiérarchie: Catégorie par défaut/Vêtements/T-shirts. Le séparateur est une barre oblique, pas une barre oblique inverse. Un soulagement: Magento crée automatiquement des chemins de catégories qui n'existent pas encore, vous n'avez donc pas besoin de pré-construire chaque catégorie avant l'importation.

Pour les configurables, le variantes_configurables la colonne porte une chaîne délimitée par des barres comme:
sku=CHEMISE-ROUGE-S,taille = S,couleur = Rouge|sku=CHEMISE-ROUGE-M,taille = M,couleur = Rouge

Délicat, Oui. Épargnez-vous la douleur en exportant d'abord un configurable construit à la main, puis utilisez cette ligne comme modèle pour le prochain 5,000.

Étape 3: Configurer le comportement d'importation

Que se passe-t-il lorsqu'un SKU de votre CSV existe déjà dans le catalogue ?? Trois options de comportement décident, et choisir le mauvais peut effacer les données:

• Ajouter/Mettre à jour. La valeur par défaut et le choix sûr. Ajoute de nouveaux SKU, mises à jour correspondant à celles, laisse les produits non répertoriés tranquilles.
• Remplacer. Supprime d'abord les SKU correspondants, puis les recrée à partir du CSV. Efface les URL, Commentaires, et l'historique des mouvements de stock sur ces produits. Utiliser rarement.
• Supprimer des entités. Supprime les SKU correspondants du catalogue. Irréversible sans restauration de la base de données.

Également défini Séparateur de champs à la virgule, Séparateur de valeurs multiples à la virgule, et vérifie Nombre d'erreurs autorisées. La valeur par défaut est 10. Augmentez-le à un nombre plus élevé si vous vous attendez à ce que certaines lignes échouent et que vous souhaitez que l'importateur continue plutôt que d'abandonner..

Étape 4: Validez avant d'importer

Téléchargez votre CSV, Cliquez sur Vérifier les données, et attends. Cela exécute la même validation que l'importation réelle, mais sans écrire dans la base de données. La sortie répertorie chaque erreur de ligne par numéro avec la colonne spécifique qui a échoué. Corriger le CSV, ré-télécharger, revérifier. Rincer jusqu'à ce qu'il soit vert.

Si la validation dit “Le fichier est valide” mais certains avertissements apparaissent, lis-les quand même. Les avertissements manquent souvent de chemins de catégorie ou de vues de magasin que Magento ignorera silencieusement, créer des produits avec des arborescences de catégories incomplètes.

Étape 5: Exécutez l'importation

Cliquez sur Importation. La barre de progression est honnête pour les petits fichiers et optimiste pour les gros. Ne fermez pas l'onglet du navigateur. Ne pas actualiser. L'importateur exécute un seul long processus PHP, et sur un hébergement plus lent, la fermeture de l'onglet en cours d'écriture rend le processus orphelin et laisse des données partielles derrière. Montre var/log/import.log via SSH si vous voulez des progrès en direct, ou vérifiez Système > Historique d'importation une fois terminé.

Images et médias

Les images confondent plus les importations que tout autre champ. La règle est simple une fois qu'on l'a vue une fois.

FTP ou SFTP vos fichiers image dans <Racine Magento>/var/importation/images. Les sous-dossiers sont autorisés: var/import/images/2026-printemps œuvres. Dans le CSV, référencer chaque image par son chemin par rapport à var/importation/images:

• base_image colonne: image principale du produit (affiché sur la page produit)
• petite_image colonne: vignette pour les pages de catégorie
• image_vignette colonne: miniatures du panier et de la commande
• images_supplémentaires colonne: galerie d'images, séparés par des virgules

Une ligne important un produit avec quatre photos de galerie pourrait ressembler à ceci :: /2026-printemps/tshirt-rouge-main.jpg dans base_image, puis /2026-printemps/tshirt-red-back.jpg,/2026-printemps/tshirt-rouge-detail.jpg,/2026-printemps/tshirt-rouge-tissu.jpg dans images_supplémentaires.

Regardez le nom du fichier. Gâteries Magento Chemise.jpg et chemise.jpg comme différents fichiers sur les hôtes Linux, et l'importateur ne corrige pas automatiquement le cas. Compressez sur WebP avant de télécharger si vous le pouvez; les clichés de héros de 300 à 400 Ko JPEG augmenteront vos Core Web Vitals dès que le trafic réel arrivera. Notre Livre de jeu de vitesse Magento couvre la conversion WebP et AVIF pour les catalogues existants.

Importation d'API REST: le 2.4.8 Chemin pour les grands catalogues

L'importateur administrateur se termine rapidement. Une fois que tu es passé 10,000 SKU ou vous avez besoin de synchronisations automatisées à partir d'un ERP, les points de terminaison REST fournis par Adobe 2.4.8 sont le bon outil. Deux points finaux comptent:

• POST /repos/<code_magasin>/V1/importation/csv pour les charges utiles CSV
• POST /repos/<code_magasin>/V1/importation/json pour les charges utiles JSON

Les deux acceptent une chaîne codée en base64 dans le corps de la requête. Pour CSV, la règle est: Encodez votre fichier en UTF-8, gzip-compressez-le (facultatif mais intelligent pour tout ce qui dépasse 1 Mo), puis base64 le résultat. La réponse renvoie le nombre d'entités importées. Masse asynchrone via /V1/vrac/ fonctionne aussi si vous voulez tirer et oublier.

Le flux, en ordre:

• Authentifiez-vous avec un jeton d'administrateur (POSTER sur /V1/intégration/admin/jeton)
• Gzippez vos produits.csv, encodez-le en base64, insérez-le dans une charge utile JSON avec la source, entité: “catalogue_produit”, et comportement: “ajouter”
• POST sur le point de terminaison d'importation avec le jeton dans l'en-tête d'autorisation
• Sondage /V1/vrac/{Uuid en vrac}/statut si tu es devenu asynchrone

Les documents de développement d'Adobe contiennent la forme exacte de la charge utile et la mise à jour par version, alors tirez à partir de là plutôt que de copier les anciens threads StackOverflow. le 2.4.8 payer: le chemin asynchrone ne contient pas de requête PHP ouverte jusqu'à 30 minutes comme le fait l'importateur admin. Votre chargement de 50 000 lignes s'exécute en arrière-plan, et la vitrine reste réactive aux acheteurs réels.

Erreurs d'importation courantes et ce qui les corrige réellement

Ce sont les échecs qui font perdre le plus de temps. Chacun a une cause fondamentale spécifique qui n’est pas toujours évidente dans le texte d’erreur.

“Taille de mémoire autorisée de X octets épuisée”

PHP a manqué de mémoire à mi-importation. Augmenter limite_mémoire en php.ini en 2G, redémarrer PHP-FPM, réessayer. Si vous ne pouvez pas toucher à php.ini (Hébergement partagé), diviser le CSV en fichiers de 1,000-5,000 lignes chacune et importer séquentiellement. Les extensions tierces comme Firebear et Amasty ajoutent un “Importer sans limite de mémoire” basculer, mais c'est une fonctionnalité d'extension, pas natif de Magento.

“Temps d'exécution maximum de 30 secondes dépassées”

Votre PHP max_execution_time est trop bas. Se diriger vers 1800 secondes. Sur Nginx, vous devrez également augmenter fastcgi_read_timeout correspondre, sinon Nginx tue l'amont avant la fin de PHP.

“Mauvaise séquence de colonnes” ou “L'en-tête comporte des colonnes non valides”

Marque d’ordre des octets. Votre CSV a été enregistré à partir d'Excel, qui ajoute une nomenclature aux fichiers UTF-8 que l'importateur lit comme une première colonne tronquée. Réexportez depuis Google Sheets ou réenregistrez via Notepad++ au format UTF-8 sans BOM. Si vous ne vérifiez qu'une chose avant de lancer l'importation, vérifie ça.

“Ensemble d'attributs non valide” ou “Valeur d'attribut non valide pour X”

Votre CSV fait référence à un ensemble d'attributs ou à une valeur déroulante qui n'existe pas dans cette installation Magento. Vérifier Magasins > Attributs. Les valeurs déroulantes sont sensibles à la casse et aux espaces. “Rouge ” avec un espace à la fin n'est pas “Rouge”.

Importation “termine” mais les produits n'apparaissent pas sur le frontend

La réindexation n'a pas fonctionné, ou le cache est obsolète. Connectez-vous en SSH et exécutez indexeur bin/magento:réindexer suivie par cache bin/magento:flush. Sur 2.4.8 avec les indexeurs Update by Schedule, c'est plus rare, mais cela arrive toujours avec les URL de produits et les indexeurs boursiers.

“La clé URL du magasin spécifié existe déjà”

Vous importez un produit dont clé_url entre en collision avec un existant. Modifiez la clé URL dans votre CSV ou définissez le comportement sur “Ajouter/Mettre à jour” plutôt qu'un nouveau “Ajouter des données complexes” courir.

Exigences d'hébergement pour les grandes importations

L'hébergement partagé tue plus d'importations Magento que les mauvais CSV. Si vous dirigez une production 2.4.8 boutique, l'étage honnête est 4 Go de RAM et 2-4 vCPU; vrais catalogues (10k+ SKU, réimportations fréquentes) besoin 8-16 GB. Le disque doit être un SSD NVMe, ne fait pas tourner les disques ou les anciens SSD SATA, parce que les opérations de réindexation et de redimensionnement d'image martèlent les E/S aléatoires.

Choses spécifiques qu'un hébergeur compatible Magento devrait vous permettre de faire:

• Modifier le fichier php.ini (ou équivalent par domaine) pour augmenter la limite de mémoire et le temps d'exécution
• Installer et exécuter cron (L'importation groupée asynchrone de Magento utilise la file d'attente des consommateurs)
• Accès SSH pour poubelle/magento Commandes CLI
• Assez d'espace disque pour que var/importation/images peut contenir votre plus gros lot deux fois (Copies Magento, ne bouge pas)

Si votre hébergeur actuel ne peut pas les livrer, l'importateur n'est pas votre vrai problème. Notre Résumé de l'hébergement Magento VPS détaille les fournisseurs qui expédient une pile prête pour la version 2.4.8 sans suppléments, et le outil de recherche d'hébergement filtres par version PHP, RAM, et panneau de contrôle si vous souhaitez comparer les plans côte à côte. Pour les commerçants exécutant WooCommerce avec Magento (ça arrive plus que tu ne le penses), le Guide d'hébergement de commerce électronique WordPress couvre la pile de croisement.

Questions fréquemment posées

Quelle est la taille maximale du fichier CSV que je peux importer dans Magento 2.4.8?

L'importateur administrateur limite les téléchargements à 2Mo par défaut, contrôlé par PHP upload_max_filesize et post_max_size. Augmentez les deux à 64 Mo dans php.ini pour les fichiers plus volumineux. Pour tout ce qui dépasse 50 Mo compressé, passer au REST /V1/importation/csv point final, qui gère les charges utiles gzip et ne gêne pas le téléchargement dans le navigateur.

Puis-je importer des produits dans Magento 2 sans utiliser CSV?

Oui. L'API REST de Magento 2.4.8 accepte à la fois CSV et JSON via /V1/importation/json. Extensions tierces (Ours de feu, Amastie, Magmi pour les anciennes installations) prend en charge XML, Synchronisation Google Sheets, et connecteurs ERP directs. L'administrateur natif nécessite toujours CSV, alors choisissez votre chemin en fonction des besoins d'automatisation.

Combien de temps prend une importation de 10 000 produits?

À l'écoute 2.4.8 empiler (8 Go de RAM, NVMe, PHP 8.4, MariaDB 11.4), attendre 15-25 minutes pour une importation de 10 000 lignes avec des images. L'hébergement partagé pousse cela vers 60+ minutes si cela se termine du tout. Le chemin de masse asynchrone REST s'exécute en arrière-plan, afin que les pages destinées aux acheteurs restent réactives pendant l'importation.

Pourquoi mon importation réussit-elle mais affiche des prix ou des stocks erronés?

Deux causes habituelles. Première, votre CSV comporte des espaces de fin ou un formatage virgule-décimal européen (1,99 au lieu de 1.99) dans la colonne prix; Magento les analyse comme invalides et conserve l'ancienne valeur. Deuxième, inventaire multi-sources (MSI) dans 2.4.8 stocke la quantité par source, pas par produit à l'échelle mondiale, donc tu as besoin du code_source ou l'import met à jour uniquement la source par défaut.

Dois-je désactiver le catalogue plat Magento avant d'importer?

Le catalogue simple est obsolète depuis 2.3 et supprimé des flux de travail par défaut par 2.4.5. Si votre magasin l'a toujours activé, désactivez-le sous Magasins > Configuration > Catalogue > Vitrine avant les grandes importations. Il s'agissait toujours d'une responsabilité en matière de performance et 2.4.8 rend cela explicite dans l'administrateur.

Puis-je automatiser les importations de produits depuis un ERP ou un PIM?

C'est exactement ce que 2.4.8 Les points de terminaison REST sont destinés. Des outils comme Akeneo, Pimcore, et Salsify ont Magento natif 2 connecteurs. Pour les constructions personnalisées, cron un script qui extrait votre flux ERP, se transforme en CSV, gzips, et des POST à /V1/importation/csv. Planifier les heures creuses si l'importation est lourde.

Notes finales

Deux règles déterminent si votre prochaine importation fonctionne. Un: enregistrer le CSV au format UTF-8 sans BOM. Toujours. Deux: augmenter PHP limite_mémoire et max_execution_time avant de commencer, pas après le premier crash. Tout le reste est détail.

Par le chemin, l'appel est simple. Sous 5,000 SKU et importations en cours occasionnellement? Utilisez l'outil CSV d'administration. Passé 10,000 SKU ou synchronisation depuis un ERP la nuit? Utilisez le REPOS /V1/importation/csv point de terminaison ajouté dans 2.4.8 et arrête de surveiller le processus. Sauvegardez la base de données avant toute exécution de remplacement ou de suppression. Ne fermez jamais l’onglet du navigateur en cours d’importation. Et si la pile en dessous ne peut pas tenir le coup, aucune tactique d'importateur ne le sauve. Réparez d'abord l'hôte.

Pour une lecture connexe: le Résumé des thèmes Magento couvre les performances du frontend après le chargement de votre catalogue, le playbook de vitesse lié ci-dessus gère la pile de mise en cache, et les guides d'hébergement expliquent sur quoi tout exécuter. Les choix d'infrastructure ennuyeux s'aggravent plus rapidement que n'importe quel indicateur de fonctionnalité unique.