Module Velleman Dropshipping Composants Électroniques pour PrestaShop — Catalogue FTP 6 000 Références (Modules, Kits, Audio, O…

Module PrestaShop de dropshipping VELLEMAN

Vous lancez une boutique de composants électroniques, un site spécialisé Arduino / Raspberry / makers DIY, un e-commerce d'éclairage scénique ou d'audio professionnel ? Vous travaillez avec Velleman Group (grossiste belge historique fondé en 1976, référent européen sur les composants, modules, kits éducatifs, sonorisation, lumière scénique, outillage de mesure) et vous passez vos journées à recopier 6 000 fiches produit, à uploader manuellement 25 photos par produit, à recréer chaque catégorie sur 10 niveaux hiérarchiques, à parser à la main les caractéristiques techniques détaillées (Physique / Électrique / Technique / Installation), à gérer 10 paliers de prix dégressifs selon vos volumes d'achat ?

Avec le Module Velleman dropshipping composants électroniques modules kits FTP, tout devient automatique. Vous renseignez vos accès FTP Velleman (host, port, user, pass, chemin de votre fichier personnalisé), vous cliquez "Lancer l'import", et le module télécharge votre CSV 64 colonnes en Windows-1252, le convertit en UTF-8 cellule par cellule, télécharge le 2e CSV de mapping images depuis le CDN Velleman (URL hardcodée invisible côté client), et crée vos ~6 000 produits PrestaShop dans une arborescence à 10 niveaux générée à la volée, chacun avec sa fiche PREMIUM 10 sections (bandeau identité marque + EAN + statut, intro courte, points clés, cards caractéristiques techniques, dimensions, conditionnement, origine, éco-contribution, conformité GPSR UE 2024, CTA fournisseur), jusqu'à 25 images par produit, et conformité européenne GPSR alimentée par votre formulaire dédié.

⚡ Avant vs Après le Module Velleman

👤 À qui s'adresse ce module ?

🎯 Fonctionnalités complètes du Module Velleman

🌐 Connexion FTP individuelle par revendeur

Particularité Velleman. Chaque revendeur partenaire reçoit un fichier CSV personnalisé sur le serveur FTP Velleman, avec ses propres conditions tarifaires (paliers dégressifs spécifiques à votre compte). Le fichier porte un nom unique (ex : VotreFichier.csv). Les accès FTP (host, port, user, pass) ne sont jamais partagés et restent strictement individuels.

Solution adoptée par le module : 5 champs FTP dans Paramètres, jamais hardcodés, mot de passe masqué dans la BDD et dans les retours JSON. Bouton "Tester la connexion FTP" qui valide en direct l'authentification, le mode passif et l'accessibilité du fichier.

5 champs FTP :
- Host       : ftp.velleman.eu (ou variant régional)
- Port       : 21 (par défaut, modifiable)
- User       : votre identifiant Velleman B2B
- Password   : masqué dans la base, jamais affiché en clair
- Path       : /VotreFichier.csv

• Authentification + mode passif via ftp_connect + ftp_login + ftp_pasv (compatible avec la quasi-totalité des firewalls)
• Vérification taille fichier (ftp_size) avant téléchargement pour rejeter les fichiers vides/corrompus
• Téléchargement curl via URL ftp://user:pass@host:port/path — robuste et performant
• Mot de passe sécurisé : stocké chiffré, masqué dans le retour JSON (• répétés), jamais loggué

📊 CSV 64 colonnes Windows-1252 — Parsing robuste

Le CSV Velleman comporte 64 colonnes sans header (premier enregistrement = données, pas en-têtes), encodé en Windows-1252 (legacy européen) avec séparateur point-virgule. Le module gère ces particularités héritées :

• Mapping symbolique en constantes PHP : COL_SKU=0, COL_NAME=1, COL_INTRO=2, COL_RECYCLE_NAME=23, …, COL_CAT_FROM=37, COL_CAT_TO=46, COL_PACKAGING=53, COL_STOCK=58, COL_BULLETS=61, COL_TECH_DETAILS=62. Plus de magic numbers, code lisible et maintenable.
• Conversion Windows-1252 → UTF-8 cellule par cellule via mb_convert_encoding() avec détection préalable si déjà UTF-8 valide
• Parsing décimal européen : virgule → point automatique sur prix, poids, dimensions
• Fix leading dot : ".354" → "0.354" automatique (sinon cast float fait n'importe quoi)
• Streaming par fichiers JSON : 1 ligne CSV → 1 fichier uploads/state/full_import_rows/<idx>.json pour permettre la reprise précise après interruption

📸 Multi-images jusqu'à 25 par produit via CDN Velleman

Innovation propre au module Velleman : un 2e CSV de mapping image est téléchargé automatiquement depuis le CDN Velleman public (URL hardcodée dans le code, jamais visible côté client) qui associe chaque SKU à une liste d'URLs d'images de produit (jusqu'à 25 vues). Le module split, valide chaque URL, et importe toutes les images dans l'ordre.

• 1re URL = cover automatiquement
• Validation HEAD HTTP (curl NOBODY) avant téléchargement : URLs cassées rejetées sans crasher l'import
• Cache 24h : le mapping est rechargé automatiquement seulement s'il a plus de 24h, économise la bande passante
• Génération auto de toutes les tailles PS (small, medium, large, home_default…)
• Fix BO PrestaShop 9 inclus : copie 1:1 du fichier original <id>.jpg en plus des variantes (sinon image cassée dans la page édition produit BO)

🏆 Description PREMIUM auto-générée — 10 sections activables

Le module compose automatiquement une fiche produit visuellement riche, structurée en 10 sections indépendamment activables via switches dans l'onglet Options. Chaque section a son design, ses couleurs, ses icônes, son objectif SEO/conversion :

Toutes les sections sont activables/désactivables individuellement dans l'onglet Options. Vous pouvez tout activer pour des fiches très riches, ou tout couper sauf l'identité + le CTA pour un rendu épuré.

✅ Conformité GPSR UE 2024 — Formulaire dédié

Le règlement GPSR (General Product Safety Regulation) de l'Union Européenne, en vigueur depuis le 13 décembre 2024, impose à tous les e-commerçants de la zone d'afficher sur chaque fiche produit les coordonnées du fabricant (et du représentant UE si fabricant hors UE). Manquement = amende.

Solution adoptée par le module : un panneau dédié dans l'onglet Paramètres avec 5 champs tous optionnels que vous remplissez une seule fois. Les coordonnées s'affichent automatiquement dans toutes les fiches produit Velleman.

• Nom du fabricant (ex : "Velleman Group NV")
• Adresse postale complète (rue, code postal, ville, pays)
• Email de contact (rendu cliquable via mailto:)
• Téléphone (rendu cliquable via tel:)
• Représentant UE (uniquement si fabricant hors UE — laisser vide pour Velleman Belgique)

Affichage conditionnel intelligent : la section GPSR ne s'affiche dans les fiches produit que si au moins un champ est rempli. Vous pouvez démarrer sans GPSR, le module ne plante pas. Format visuel rouge clair pour rappeler son caractère réglementaire.

💰 10 paliers de prix dégressifs Velleman

Velleman propose jusqu'à 10 paliers de prix dégressifs selon les quantités d'achat (typiquement : 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Chaque palier a son propre prix HT négocié dans votre contrat B2B Velleman.

Solution adoptée par le module : un sélecteur dans Paramètres pour choisir le palier qui correspond à votre volume d'achat moyen réel. Le module utilise ce palier comme prix de revient unique pour calculer le prix de vente final selon votre mode (margins / fixed / wholesale).

• Sélecteur palier : 1 / 5 / 25 / 100 / 500 (par défaut 5, le plus courant pour PME)
• Mode margins : 6 paliers de marge configurables par tranche de prix HT
• Mode fixed : 1 markup en % appliqué uniformément (ex 50%)
• Mode wholesale : prix d'achat HT inchangé (vente B2B aux écoles, makers space, etc.)

🌳 Hiérarchie de catégories sur 10 niveaux

Le CSV Velleman fournit jusqu'à 10 colonnes "Titre catégorie 1..10" formant une hiérarchie linéaire profonde (root → enfant → petit-enfant → arrière-petit-enfant…). Chaque produit appartient à une feuille au bout d'une chaîne de catégories.

Solution adoptée par le module : création à la volée des catégories manquantes sous votre racine PrestaShop configurée. Lookup avant création (anti-doublons) avec query SQL optimisée.

Exemple :
"Composants Électroniques & Accessoires"
  → "Composants électroniques"
    → "Condensateurs"
      → "Tantale"
        → "Hauteur basse"
          → ...

• Création multilingue sous votre racine PS (toutes les langues actives reçoivent le même nom + slug)
• Lookup avant create : SELECT par nom + parent → si trouvée, on réutilise l'ID existant
• Liaison produit complète : id_category_default = feuille la plus profonde, category_product rempli avec toute la chaîne (filtres facetedsearch fonctionnent à tous les niveaux)
• Slug automatique via VlCompat::slug() (URL-safe, accents normalisés)

⚡ Architecture import temps réel + CRON 24/7

⏰ CRON 24/7 — 4 actions automatisées

• Clé secrète 32 caractères hex générée à l'install — vos URLs CRON ne peuvent pas être devinées
• Régénération à 1 clic de la clé en cas de fuite
• Auto-relance asynchrone via curl loopback : auto-rappel en arrière-plan si le time-budget est atteint (60s par défaut), survie via @ignore_user_abort(true)
• Reprise précise : reprend exactement à la ligne où il s'est arrêté
• Lock anti-concurrence via flock : pas d'exécutions parallèles
• Bouton Stop côté BO pour arrêter proprement un CRON en cours (flag file)
• Limite produits par exécution configurable (10-100 pour valider en mode test, 0 = illimité en production)
• Flash "tâche lancée en arrière-plan" immédiat sur clic Test BO — vous savez tout de suite que le serveur travaille

🏷️ Le catalogue Velleman en chiffres

Univers produits du catalogue Velleman (extrait par grandes familles) :

Marques internes Velleman : Velleman Kit (kits soudure), Velleman Modules, Vellight (éclairage), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (sécurité), Toolland (outillage), Velleman EDU (éducation).

🛠️ Maintenance — Suppression sélective

• ☐ Produits importés : détection à 2 sources (table meta + id_supplier), compatible PS9 multi-shop avec fallback wipe SQL si Product::delete() retourne false
• ☐ Catégories vides : balayage par profondeur descendante via nleft/nright, suppression seulement si zéro produit lié + zéro sous-cat (préserve les racines PS_HOME, PS_ROOT)
• ☐ Marque Velleman : supprime le manufacturer uniquement s'il n'a plus aucun produit lié (double confirmation requise)
• ☐ Journaux internes : truncate des tables history et import_errors

Confirmation simple ou double selon le périmètre, avec onglet dédié Outils → Suppression sélective. L'arborescence des catégories est préservée si vous avez des produits ailleurs (non-Velleman) qui les utilisent encore.

⭐ 12 raisons de choisir le Module Velleman

1. 🌐 Connexion FTP individuelle par revendeur (5 champs) — chaque client a son fichier numéroté, ses paliers personnels
2. 📸 Multi-images jusqu'à 25 vues/produit via 2e CSV CDN (URL hardcodée invisible client) — innovation propre Velleman
3. 🏆 Description PREMIUM 10 sections activables individuellement (bandeau, intro, points clés, cards techniques, dimensions, conditionnement, origine, éco, GPSR, CTA)
4. ✅ Conformité GPSR UE 2024 via formulaire dédié (5 champs optionnels) — affichage automatique dans toutes les fiches
5. 🌳 10 niveaux de catégories hiérarchiques créés à la volée — gestion d'arborescences profondes spécifiques composants
6. 💰 10 paliers de prix dégressifs Velleman + sélecteur prix d'achat dans Paramètres
7. 🔬 Parsing intelligent caractéristiques détaillées (col 63) : 1 section = 1 card visuelle (Physique / Électrique / Technique / Installation)
8. 🌍 Encodage Windows-1252 auto-converti en UTF-8 cellule par cellule (préserve "Métré", "Réservé", caractères techniques européens)
9. 🔢 Décimaux virgule + préfixes pointés auto-corrigés (ex : .354 → 0.354 — sinon cast float plante)
10. ⚡ Import temps réel produit-par-produit : barre live, journal console, bouton Arrêter, reprise précise
11. ⏰ CRON 24/7 sécurisé avec time-budget, auto-relance asynchrone, retry, lock, mode test, limiteur produits
12. 💎 Aucun AdminController, aucune Tab BO, aucun override : ne pollue pas votre menu, ne casse pas vos autres modules

🎬 Comment ça marche en 5 étapes

🔧 Compatibilité technique

❓ Foire aux questions

📦 Module développé par WebPoint · webpoint.fr · Mises à jour régulières · Code propre & commenté