Velleman Dropshipping Modul Elektronische Bauteile für PrestaShop — FTP-Katalog 6.000 Artikel (Module, Kits, Audio, Beleuchtung)

PrestaShop Dropshipping-Modul VELLEMAN

Sie eröffnen einen Shop für elektronische Bauteile, eine Spezialseite für Arduino / Raspberry / DIY-Maker, einen Online-Shop für Bühnenbeleuchtung oder Profi-Audio? Sie arbeiten mit Velleman Group (belgischer Traditionsgrosshändler, gegründet 1976, europäische Referenz für Bauteile, Module, Lernkits, Beschallung, Bühnenlicht, Messwerkzeuge) und verbringen Ihre Tage damit, 6.000 Produktdatenblätter abzutippen, manuell 25 Fotos pro Produkt hochzuladen, jede Kategorie über 10 hierarchische Ebenen neu anzulegen, die ausführlichen technischen Merkmale (Physisch / Elektrisch / Technisch / Installation) von Hand zu zerlegen und 10 Mengenrabattstufen je nach Einkaufsvolumen zu verwalten?

Mit dem Velleman Dropshipping Modul Elektronische Bauteile Module Kits FTP wird alles automatisch. Sie hinterlegen Ihre Velleman-FTP-Zugangsdaten (Host, Port, Benutzer, Passwort, Pfad zu Ihrer personalisierten Datei), klicken auf „Import starten", und das Modul lädt Ihre 64-spaltige CSV-Datei in Windows-1252 herunter, konvertiert sie Zelle für Zelle nach UTF-8, lädt die zweite CSV mit der Bildzuordnung vom Velleman-CDN (hartkodierte URL, clientseitig unsichtbar) und legt Ihre ~6.000 PrestaShop-Produkte in einer im Vorgang erzeugten 10-stufigen Baumstruktur an, jedes mit einem PREMIUM-Datenblatt aus 10 Abschnitten (Marken-Banner mit Identität + EAN + Status, kurze Einleitung, Highlights, Cards mit technischen Merkmalen, Abmessungen, Verpackung, Herkunft, Umweltbeitrag, GPSR EU 2024, Lieferanten-CTA), bis zu 25 Bildern pro Produkt und europäischer GPSR-Konformität, gespeist aus Ihrem dedizierten Formular.

⚡ Vorher vs. Nachher mit dem Velleman-Modul

👤 Für wen ist dieses Modul?

🎯 Vollständige Funktionen des Velleman-Moduls

🌐 Individuelle FTP-Verbindung pro Wiederverkäufer

Velleman-Besonderheit. Jeder Partner-Wiederverkäufer erhält auf dem Velleman-FTP-Server eine personalisierte CSV-Datei mit eigenen Tarifkonditionen (kontospezifische Mengenrabatte). Die Datei trägt einen eindeutigen Namen (z. B. IhreDatei.csv). Die FTP-Zugangsdaten (Host, Port, Benutzer, Passwort) werden niemals geteilt und bleiben strikt individuell.

Lösungsansatz des Moduls: 5 FTP-Felder in den Einstellungen, niemals hartkodiert, Passwort in der Datenbank und in JSON-Antworten maskiert. Schaltfläche „FTP-Verbindung testen", die Authentifizierung, Passive-Modus und Dateiverfügbarkeit live prüft.

5 FTP-Felder:
- Host       : ftp.velleman.eu (oder regionale Variante)
- Port       : 21 (Standard, anpassbar)
- Benutzer   : Ihre Velleman-B2B-Kennung
- Passwort   : maskiert in der Datenbank, nie im Klartext angezeigt
- Pfad       : /IhreDatei.csv

• Authentifizierung + Passive-Modus via ftp_connect + ftp_login + ftp_pasv (kompatibel mit nahezu allen Firewalls)
• Dateigrößenprüfung (ftp_size) vor dem Download, um leere/beschädigte Dateien abzuweisen
• cURL-Download über URL ftp://user:pass@host:port/path – robust und performant
• Sicheres Passwort: verschlüsselt gespeichert, im JSON-Rückgabewert maskiert (• wiederholt), niemals geloggt

📊 CSV mit 64 Spalten in Windows-1252 — Robustes Parsing

Die Velleman-CSV besitzt 64 Spalten ohne Header (erster Datensatz = Daten, keine Kopfzeilen), kodiert in Windows-1252 (Legacy-Europa) mit Semikolon als Trennzeichen. Das Modul beherrscht diese Alteigenheiten:

• Symbolisches Mapping als PHP-Konstanten: 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. Keine Magic Numbers mehr, lesbarer und wartbarer Code.
• Konvertierung Windows-1252 → UTF-8 Zelle für Zelle via mb_convert_encoding() mit vorheriger Erkennung, falls bereits gültiges UTF-8
• Europäisches Dezimalparsing: Komma → Punkt automatisch bei Preisen, Gewichten, Abmessungen
• Leading-Dot-Fix: „.354" → „0.354" automatisch (sonst macht der Float-Cast Unfug)
• Streaming in JSON-Dateien: 1 CSV-Zeile → 1 Datei uploads/state/full_import_rows/<idx>.json, um eine punktgenaue Wiederaufnahme nach Unterbrechung zu ermöglichen

📸 Bis zu 25 Bilder pro Produkt über Velleman-CDN

Eine Innovation, die nur das Velleman-Modul bietet: Eine zweite CSV mit Bild-Mapping wird automatisch vom öffentlichen Velleman-CDN heruntergeladen (URL hartkodiert im Code, niemals clientseitig sichtbar) und ordnet jede SKU einer Liste von Produktbild-URLs zu (bis zu 25 Ansichten). Das Modul splittet, validiert jede URL und importiert alle Bilder in der Reihenfolge.

• 1. URL = Cover automatisch
• HTTP-HEAD-Validierung (cURL NOBODY) vor dem Download: ungültige URLs werden verworfen, ohne den Import abzubrechen
• Cache 24 Std.: Das Mapping wird nur erneut geladen, wenn es älter als 24 Std. ist – schont die Bandbreite
• Automatische Erzeugung aller PS-Bildgrößen (small, medium, large, home_default…)
• Inkl. Fix für PrestaShop 9 BO: 1:1-Kopie der Originaldatei <id>.jpg zusätzlich zu den Varianten (sonst defektes Bild auf der BO-Produktbearbeitungsseite)

🏆 PREMIUM-Beschreibung automatisch erzeugt — 10 aktivierbare Abschnitte

Das Modul erstellt automatisch ein optisch ansprechendes Produktdatenblatt, gegliedert in 10 unabhängig aktivierbare Abschnitte über Schalter im Reiter „Optionen". Jeder Abschnitt hat sein eigenes Design, seine Farben, seine Icons und sein SEO-/Conversion-Ziel:

Alle Abschnitte lassen sich individuell im Reiter Optionen aktivieren/deaktivieren. Sie können alles aktivieren für besonders reichhaltige Datenblätter, oder alles ausschalten bis auf Identität + CTA für eine schlanke Darstellung.

✅ GPSR-Konformität EU 2024 — Dediziertes Formular

Die GPSR-Verordnung (General Product Safety Regulation) der Europäischen Union, in Kraft seit dem 13. Dezember 2024, verpflichtet alle E-Commerce-Händler im EU-Raum, auf jedem Produktdatenblatt die Kontaktdaten des Herstellers anzugeben (sowie des EU-Vertreters, falls Hersteller außerhalb der EU). Verstöße werden mit Bußgeldern geahndet.

Lösungsansatz des Moduls: Ein eigenes Panel im Reiter Einstellungen mit 5 komplett optionalen Feldern, die Sie einmalig ausfüllen. Die Kontaktdaten werden automatisch in allen Velleman-Produktdatenblättern angezeigt.

• Herstellername (z. B. „Velleman Group NV")
• Vollständige Postanschrift (Straße, PLZ, Stadt, Land)
• Kontakt-E-Mail (klickbar via mailto:)
• Telefon (klickbar via tel:)
• EU-Vertreter (nur falls Hersteller außerhalb der EU – für Velleman Belgien leer lassen)

Intelligente bedingte Anzeige: Der GPSR-Abschnitt erscheint im Produktdatenblatt nur, wenn mindestens ein Feld ausgefüllt ist. Sie können ohne GPSR starten, ohne dass das Modul abstürzt. Hellrote Optik unterstreicht den regulatorischen Charakter.

💰 10 Mengenrabattstufen Velleman

Velleman bietet bis zu 10 Mengenrabattstufen je Einkaufsmenge (typisch: 1, 5, 10, 25, 50, 100, 250, 500, 1.000, 5.000+). Jede Stufe hat ihren eigenen, in Ihrem B2B-Vertrag mit Velleman verhandelten Netto-Einkaufspreis.

Lösungsansatz des Moduls: Ein Selektor in den Einstellungen, mit dem Sie die Stufe wählen, die Ihrem tatsächlichen durchschnittlichen Einkaufsvolumen entspricht. Das Modul nutzt diese Stufe als einheitlichen Einkaufspreis, um den endgültigen Verkaufspreis nach Ihrem Modus (margins / fixed / wholesale) zu berechnen.

• Stufenwahl: 1 / 5 / 25 / 100 / 500 (Standard 5, der gängigste für KMU)
• Modus margins: 6 konfigurierbare Margenstufen je Netto-Preisspanne
• Modus fixed: 1 Aufschlag in % einheitlich angewandt (z. B. 50 %)
• Modus wholesale: Netto-Einkaufspreis unverändert (B2B-Verkauf an Schulen, Maker Spaces usw.)

🌳 Kategoriehierarchie über 10 Ebenen

Die Velleman-CSV liefert bis zu 10 Spalten „Kategorie-Titel 1..10", die eine tiefe lineare Hierarchie bilden (Wurzel → Kind → Enkel → Urenkel…). Jedes Produkt gehört zu einem Blatt am Ende einer Kategorienkette.

Lösungsansatz des Moduls: „On-the-fly"-Anlage der fehlenden Kategorien unter Ihrer konfigurierten PrestaShop-Wurzel. Lookup vor Anlage (Doppelvermeidung) per optimierter SQL-Query.

Beispiel:
„Elektronische Bauteile & Zubehör"
  → „Elektronische Bauteile"
    → „Kondensatoren"
      → „Tantal"
        → „Niedrige Bauhöhe"
          → ...

• Mehrsprachige Anlage unter Ihrer PS-Wurzel (alle aktiven Sprachen erhalten denselben Namen + Slug)
• Lookup vor Create: SELECT nach Name + Eltern → wenn gefunden, wird die bestehende ID wiederverwendet
• Komplette Produktverknüpfung: id_category_default = tiefstes Blatt, category_product mit der vollständigen Kette gefüllt (Faceted-Search-Filter funktionieren auf allen Ebenen)
• Automatischer Slug via VlCompat::slug() (URL-sicher, normalisierte Akzente)

⚡ Echtzeit-Import-Architektur + CRON 24/7

⏰ CRON 24/7 — 4 automatisierte Aktionen

• 32-stelliger Hex-Geheimschlüssel, generiert bei der Installation – Ihre CRON-URLs sind nicht erratbar
• Schlüsselneugenerierung mit 1 Klick bei einem Leak
• Asynchroner Auto-Restart via cURL-Loopback: Selbstaufruf im Hintergrund, wenn das Zeitbudget erreicht ist (60 s Standard), Überleben dank @ignore_user_abort(true)
• Punktgenaue Wiederaufnahme: setzt exakt an der Zeile fort, an der der Vorgang stoppte
• Anti-Konkurrenz-Lock via flock: keine parallelen Ausführungen
• Stopp-Schaltfläche im BO, um einen laufenden CRON sauber zu beenden (Flag-Datei)
• Konfigurierbares Produkt-Limit pro Lauf (10-100 zur Validierung im Testmodus, 0 = unbegrenzt in Produktion)
• Sofortiger „Aufgabe im Hintergrund gestartet"-Flash beim BO-Test-Klick – Sie wissen sofort, dass der Server arbeitet

🏷️ Der Velleman-Katalog in Zahlen

Produktwelten des Velleman-Katalogs (Auszug nach Hauptfamilien):

Eigenmarken Velleman: Velleman Kit (Lötkits), Velleman Modules, Vellight (Beleuchtung), HQ Power (Profi-Audio), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (Sicherheit), Toolland (Werkzeug), Velleman EDU (Bildung).

🛠️ Wartung — Selektive Löschung

• ☐ Importierte Produkte: Erkennung über 2 Quellen (Meta-Tabelle + id_supplier), kompatibel mit PS9 Multi-Shop, Fallback per SQL-Wipe, falls Product::delete() false zurückgibt
• ☐ Leere Kategorien: Durchlauf in absteigender Tiefe via nleft/nright, Löschung nur bei null verknüpften Produkten + null Unterkategorien (PS_HOME-/PS_ROOT-Wurzeln bleiben erhalten)
• ☐ Marke Velleman: Hersteller wird nur entfernt, wenn keine Produkte mehr verknüpft sind (Doppelbestätigung erforderlich)
• ☐ Interne Journale: Truncate der Tabellen history und import_errors

Einfache oder doppelte Bestätigung je nach Umfang, mit eigenem Tab Werkzeuge → Selektive Löschung. Die Kategoriestruktur bleibt erhalten, wenn andere Produkte (nicht-Velleman) sie noch verwenden.

⭐ 12 Gründe, das Velleman-Modul zu wählen

1. 🌐 Individuelle FTP-Verbindung pro Wiederverkäufer (5 Felder) – jeder Kunde hat seine nummerierte Datei und seine persönlichen Stufen
2. 📸 Bis zu 25 Bilder pro Produkt über zweite CDN-CSV (URL hartkodiert, clientseitig unsichtbar) – eine Velleman-spezifische Innovation
3. 🏆 PREMIUM-Beschreibung mit 10 Abschnitten, individuell aktivierbar (Banner, Einleitung, Highlights, Technik-Cards, Abmessungen, Verpackung, Herkunft, Umwelt, GPSR, CTA)
4. ✅ GPSR-Konformität EU 2024 über dediziertes Formular (5 optionale Felder) – automatische Anzeige in allen Datenblättern
5. 🌳 10 Kategorieebenen hierarchisch „on-the-fly" angelegt – Verwaltung tiefer, bauteilspezifischer Strukturen
6. 💰 10 Mengenrabattstufen Velleman + Einkaufspreis-Selektor in den Einstellungen
7. 🔬 Intelligentes Parsen der Detailmerkmale (Sp. 63): 1 Abschnitt = 1 visuelle Card (Physisch / Elektrisch / Technisch / Installation)
8. 🌍 Windows-1252 automatisch konvertiert nach UTF-8 Zelle für Zelle (bewahrt „Métré", „Réservé", europäische Sonderzeichen)
9. 🔢 Komma-Dezimalen + Punktpräfixe automatisch korrigiert (z. B. .354 → 0.354 – sonst hängt der Float-Cast)
10. ⚡ Echtzeit-Import Produkt für Produkt: Live-Balken, Konsolen-Journal, Stopp-Schaltfläche, punktgenaue Wiederaufnahme
11. ⏰ Sicherer CRON 24/7 mit Zeitbudget, asynchronem Auto-Restart, Retry, Lock, Testmodus, Produktbegrenzer
12. 💎 Kein AdminController, kein BO-Tab, kein Override: verschmutzt Ihr Menü nicht, bricht Ihre anderen Module nicht

🎬 So funktioniert es in 5 Schritten

🔧 Technische Kompatibilität

❓ Häufig gestellte Fragen

📦 Modul entwickelt von WebPoint · webpoint.fr · Regelmäßige Updates · Sauberer & kommentierter Code