Import grossiste Pro – importation de produits depuis XML vers PrestaShop

Sources XML et adaptation du catalogue à la boutique

• Multiples sources de données : chaque source possède son propre nom, sa configuration de connexion, son statut d’activité et l’adaptateur qui lui est attribué, c’est-à-dire le mécanisme qui lit sa structure XML.
• Paramètres généraux et individuels : certains paramètres d’import peuvent être remplacés pour une source spécifique, notamment la plage de prix, les règles de mise à jour, le téléchargement des images et la manière de traiter les produits manquants.
• Ajout de produits et mise à jour des existants : le module enregistre les liens entre les produits source et les fiches produits dans PrestaShop, puis les utilise lors des imports suivants.
• Adaptation à votre propre catalogue : les produits existants peuvent être reconnus selon le champ choisi : référence produit, EAN-13, UPC ou MPN, à condition que ce champ soit disponible dans la version de la boutique utilisée. L’efficacité de la correspondance dépend de la cohérence et du caractère univoque des identifiants.
• Mapping des catégories : les catégories source peuvent être associées aux catégories de la boutique ou créées pendant l’import. La configuration comprend la catégorie par défaut ainsi que l’activité des associations.
• Mapping des fabricants, fournisseurs, caractéristiques et attributs : des écrans distincts aident à attribuer les données source aux éléments appropriés du catalogue PrestaShop. Des opérations de correspondance automatique par nom sont également disponibles.

Import des données produit et contrôle des mises à jour

• Noms et descriptions : import du nom, de la description complète et de la description courte, avec des interrupteurs distincts pour leur mise à jour. Les données doivent être fournies par la source et prises en charge par son adaptateur.
• Identifiants et paramètres physiques : prise en charge de la référence, de l’EAN-13, de l’UPC, du MPN, du poids et des dimensions du produit, selon les données source et la disponibilité des champs dans PrestaShop.
• Prix et disponibilité : mise à jour du prix de vente, du prix d’achat, de la quantité et du statut d’activité du produit dans la mesure prise en charge par la source. Le module permet également de configurer les textes de disponibilité et les messages relatifs au délai de livraison.
• Images des produits : téléchargement des images à partir des adresses transmises dans les données, possibilité de désactiver leur téléchargement et de limiter le nombre d’images importées. La mise à jour des images peut être contrôlée séparément pour les produits importés et pour ceux mis en correspondance avec le catalogue existant.
• Caractéristiques techniques : attribution des caractéristiques aux produits et choix entre le remplacement de leur ensemble ou leur fusion. La fusion met à jour les caractéristiques présentes dans l’import et conserve les autres caractéristiques du produit.
• Déclinaisons de produits : l’import complet peut créer et mettre à jour des variantes sur la base de la structure de déclinaisons prise en charge, de leurs attributs, identifiants, quantités ainsi que de leur impact sur le prix et le poids.
• Règles distinctes pour les produits mis en correspondance : des paramètres de mise à jour différents peuvent être appliqués aux fiches créées par l’importateur, et d’autres aux produits reconnus dans le catalogue existant par identifiant.

Lors de la mise à jour des déclinaisons, le module fait correspondre les variantes selon les ensembles d’attributs, ajoute les nouvelles et peut supprimer les variantes existantes absentes de l’ensemble transmis. Une option permet également de supprimer les déclinaisons existantes lors de la première mise en correspondance du produit. Le choix de ces paramètres est important pour les boutiques qui maintiennent leurs propres variantes.

Règles de prix et sélection de l’assortiment importé

• Calcul des prix : les règles prennent en charge l’ajout et la soustraction d’un montant, la multiplication ainsi que l’augmentation ou la diminution du prix en pourcentage. Une augmentation en pourcentage signifie une majoration du prix source.
• Conditions des règles : le prix peut dépendre d’une plage de prix d’entrée, de la catégorie, du fabricant et du fournisseur. Les règles peuvent être générales ou attribuées à une source spécifique.
• Priorités : l’importateur choisit une seule règle de prix correspondante selon la priorité et, en cas de priorité égale, tient compte de la précision de ses conditions.
• Supplément et arrondi : après application de la règle, il est possible d’ajouter un montant configuré, puis d’arrondir à la fin le prix HT ou TTC à l’unité entière.
• Association des taux avec les taxes de la boutique : la configuration permet d’attribuer les taux de TVA pris en charge à partir des données source aux groupes de règles fiscales existants dans PrestaShop.
• Filtres d’import : un seuil inférieur et supérieur du prix source est disponible, ainsi que des paramètres pour importer les produits sans images et avec une quantité égale à zéro.
• Produits disparaissant du XML : après la fin d’un import complet, il est possible de les laisser inchangés, de les désactiver, de mettre la quantité du produit de base à zéro ou de combiner la désactivation avec la remise à zéro de cette quantité.

Préparation des contenus et des champs SEO des produits

• Dictionnaire des modifications textuelles : remplacement de fragments définis dans les noms, descriptions complètes et courtes ainsi que dans les champs meta title et meta description. Les règles peuvent utiliser des remplacements simples ou des expressions régulières.
• Modèles de noms : la configuration permet de construire les noms à partir des données disponibles, telles que le nom source, la référence, le fabricant, le fournisseur ou l’EAN. Le dictionnaire propose un aperçu de la transformation sur un texte d’exemple.
• Fragments personnalisés des descriptions : possibilité d’ajouter du contenu avant et après la description complète ou courte, avec des paramètres linguistiques et individuels pour la source.
• Champs SEO : prise en charge du titre et de la meta description transmis par l’adaptateur, ainsi que création du fragment d’URL convivial du produit à partir du nom. Lors de la mise à jour de produits existants, les champs SEO sont liés au paramètre de mise à jour du nom.
• Données multilingues : l’import peut utiliser les versions linguistiques fournies par la source et l’adaptateur. En leur absence, le mécanisme peut dupliquer le contenu disponible dans d’autres langues ; il n’effectue pas de traduction automatique.

Automatisation de l’import et supervision des opérations

• Import par étapes dans le panneau : opérations distinctes de téléchargement du XML, de préparation des catégories, fabricants, fournisseurs, caractéristiques et attributs, ainsi que de l’import des produits.
• Traitement par lots : nombre configurable de produits par lot et lecture des enregistrements via XMLReader. Cela permet d’adapter le déroulement de l’import aux ressources du serveur ; le temps d’exécution dépend également des images et du volume des données.
• Progression, pause et reprise : le panneau affiche la progression et les compteurs d’opérations. La pause permet de terminer le lot en cours, puis suspend les suivants ; la progression enregistrée permet de reprendre le travail.
• Ignorer les enregistrements inchangés : l’importateur compare les empreintes des données produit. Le forçage de la mise à jour permet de retraiter les enregistrements également après modification des paramètres, malgré un XML inchangé.
• Mise à jour rapide : une opération distincte récupère les données via l’adaptateur et met à jour les prix ainsi que les quantités des produits de base déjà liés à la source donnée. Elle ne crée pas de nouvelles fiches produits et ne met pas à jour les descriptions, les images ni les stocks des différentes déclinaisons.
• CRON : des URL d’appel avec clé d’accès permettent de lancer des opérations pour la source indiquée. Le planning doit être configuré sur le serveur ou dans un service externe, en tenant compte du téléchargement des données et du traitement des lots successifs.
• Historique et export des logs : enregistrement des sessions, résumés des opérations, avertissements et erreurs, filtrage des entrées et export du journal au format CSV.
• Choix des boutiques cibles : la configuration permet d’indiquer les boutiques de l’installation multistore vers lesquelles les produits doivent être envoyés. Une partie des données produit et des paramètres reste commune conformément à leur portée dans PrestaShop et dans le module.

Avantages pour la gestion de la boutique

• Moins de ressaisie manuelle : les données du catalogue, les images et la disponibilité sont intégrées aux fiches produits dans le cadre de l’import configuré.
• Contrôle sur vos propres contenus : la désactivation de la mise à jour des noms ou des descriptions permet de conserver certains contenus préparés dans la boutique lors d’un import complet.
• Règles de prix reproductibles : la même configuration de calcul des prix peut être utilisée lors des mises à jour successives de la source.
• Identification plus facile des causes des problèmes : la progression, les résumés et les logs aident à distinguer les enregistrements ajoutés, mis à jour et ignorés, et à vérifier les erreurs d’import.

Comment préparer un import XML vers PrestaShop ?

1. Préparez l’accès au XML et confirmez que sa structure ainsi que les champs nécessaires sont pris en charge par l’adaptateur de la source.
2. Créez une source, configurez la connexion et indiquez les boutiques cibles.
3. Téléchargez les données et préparez les associations de catégories, fabricants, fournisseurs, caractéristiques et attributs nécessaires pour le catalogue concerné.
4. Définissez les règles de prix, les filtres et l’étendue de l’écrasement des données, puis lancez l’import des produits.
5. Vérifiez le résultat sur les fiches produits et dans les logs, puis configurez les appels cycliques des opérations CRON appropriées.

Périmètre de fonctionnement et exigences

La structure de la source nécessite une adaptation. La seule extension XML ne signifie pas que le fichier est compatible avec l’importateur. Une autre organisation des données peut nécessiter la préparation ou la modification de l’adaptateur ; le périmètre de l’import dépend des champs réellement fournis par la source. Le module n’est pas un importateur de feuilles XLSX ni de fichiers CSV.

L’import complet et la mise à jour rapide ont des périmètres différents. Les interrupteurs d’écrasement des champs concernent le parcours complet d’import. La mise à jour rapide via l’adaptateur enregistre le prix et la quantité du produit de base indépendamment de ces interrupteurs. La prise en charge de plusieurs sources ne signifie pas l’addition automatique de leurs stocks ni la sélection de l’offre la moins chère.

Le module alimente le catalogue produits ; il ne transmet pas les commandes au grossiste et ne réserve pas la marchandise chez le fournisseur. L’actualité des données dépend de la publication du XML et de la fréquence d’exécution de l’import. Les descriptions et les champs meta sont traités selon les données et les règles, sans génération de contenu par IA.

Lien vers la démo du module :

Démo du panneau d’administration :
https://moduly-prestashop.eu/pdxmlimport/admin-dev

Démo du front-office :
https://moduly-prestashop.eu/pdxmlimport