Velleman import elettronica PrestaShop - catalogo fornitore automatizzato

Modulo PrestaShop di dropshipping VELLEMAN

Stai lanciando un negozio di componenti elettronici, un sito specializzato Arduino / Raspberry / maker DIY, un e-commerce di illuminazione scenica o di audio professionale? Lavori con Velleman Group (grossista belga storico fondato nel 1976, riferimento europeo per componenti, moduli, kit didattici, sonorizzazione, luci sceniche, strumenti di misura) e passi le giornate a ricopiare 6 000 schede prodotto, a caricare manualmente 25 foto per prodotto, a ricreare ogni categoria su 10 livelli gerarchici, ad analizzare a mano le caratteristiche tecniche dettagliate (Fisica / Elettrica / Tecnica / Installazione), a gestire 10 fasce di prezzo decrescenti in base ai tuoi volumi d'acquisto?

Con il Modulo Velleman dropshipping componenti elettronici moduli kit FTP, tutto diventa automatico. Inserisci i tuoi accessi FTP Velleman (host, porta, user, pass, percorso del tuo file personalizzato), clicchi "Avvia import", e il modulo scarica il tuo CSV a 64 colonne in Windows-1252, lo converte in UTF-8 cella per cella, scarica il 2° CSV di mappatura immagini dal CDN Velleman (URL hardcoded invisibile lato cliente), e crea i tuoi ~6 000 prodotti PrestaShop in un albero a 10 livelli generato al volo, ciascuno con la sua scheda PREMIUM a 10 sezioni (banner identità marca + EAN + stato, intro breve, punti chiave, card caratteristiche tecniche, dimensioni, confezionamento, origine, eco-contributo, conformità GPSR UE 2024, CTA fornitore), fino a 25 immagini per prodotto, e conformità europea GPSR alimentata dal tuo modulo dedicato.

⚡ Prima vs Dopo il Modulo Velleman

👤 A chi si rivolge questo modulo?

🎯 Funzionalità complete del Modulo Velleman

🌐 Connessione FTP individuale per rivenditore

Particolarità Velleman. Ogni rivenditore partner riceve un file CSV personalizzato sul server FTP Velleman, con le proprie condizioni tariffarie (fasce decrescenti specifiche del tuo account). Il file ha un nome univoco (es: TuoFile.csv). Gli accessi FTP (host, porta, user, pass) non sono mai condivisi e restano strettamente individuali.

Soluzione adottata dal modulo: 5 campi FTP nelle Impostazioni, mai hardcoded, password mascherata nel DB e nei ritorni JSON. Pulsante "Testa la connessione FTP" che valida in diretta l'autenticazione, la modalità passiva e l'accessibilità del file.

5 campi FTP:
- Host       : ftp.velleman.eu (o variante regionale)
- Porta      : 21 (predefinita, modificabile)
- User       : il tuo identificativo Velleman B2B
- Password   : mascherata nel DB, mai mostrata in chiaro
- Path       : /TuoFile.csv

• Autenticazione + modalità passiva tramite ftp_connect + ftp_login + ftp_pasv (compatibile con la quasi totalità dei firewall)
• Verifica dimensione file (ftp_size) prima del download per rifiutare file vuoti/corrotti
• Download curl tramite URL ftp://user:pass@host:port/path — robusto e performante
• Password sicura: archiviata cifrata, mascherata nel ritorno JSON (• ripetuti), mai loggata

📊 CSV 64 colonne Windows-1252 — Parsing robusto

Il CSV Velleman ha 64 colonne senza header (primo record = dati, non intestazioni), codificato in Windows-1252 (legacy europeo) con separatore punto e virgola. Il modulo gestisce queste particolarità ereditate:

• Mapping simbolico in costanti 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. Niente più magic numbers, codice leggibile e manutenibile.
• Conversione Windows-1252 → UTF-8 cella per cella tramite mb_convert_encoding() con rilevamento preliminare se già UTF-8 valido
• Parsing decimale europeo: virgola → punto automatico su prezzi, pesi, dimensioni
• Fix leading dot: ".354" → "0.354" automatico (altrimenti il cast float fa cose strane)
• Streaming per file JSON: 1 riga CSV → 1 file uploads/state/full_import_rows/<idx>.json per consentire la ripresa precisa dopo un'interruzione

📸 Multi-immagini fino a 25 per prodotto tramite CDN Velleman

Innovazione esclusiva del modulo Velleman: un 2° CSV di mapping immagini viene scaricato automaticamente dal CDN Velleman pubblico (URL hardcoded nel codice, mai visibile lato cliente) che associa ogni SKU a una lista di URL di immagini di prodotto (fino a 25 viste). Il modulo split, valida ogni URL, e importa tutte le immagini nell'ordine.

• 1° URL = cover automaticamente
• Validazione HEAD HTTP (curl NOBODY) prima del download: URL rotti rifiutati senza far crashare l'import
• Cache 24h: il mapping viene ricaricato automaticamente solo se ha più di 24h, risparmiando banda
• Generazione automatica di tutte le dimensioni PS (small, medium, large, home_default…)
• Fix BO PrestaShop 9 incluso: copia 1:1 del file originale <id>.jpg oltre alle varianti (altrimenti immagine rotta nella pagina di modifica prodotto BO)

🏆 Descrizione PREMIUM auto-generata — 10 sezioni attivabili

Il modulo compone automaticamente una scheda prodotto visivamente ricca, strutturata in 10 sezioni attivabili indipendentemente tramite switch nella scheda Opzioni. Ogni sezione ha il suo design, i suoi colori, le sue icone, il suo obiettivo SEO/conversione:

Tutte le sezioni sono attivabili/disattivabili individualmente nella scheda Opzioni. Puoi attivare tutto per schede molto ricche, o spegnere tutto tranne identità + CTA per una resa essenziale.

✅ Conformità GPSR UE 2024 — Modulo dedicato

Il regolamento GPSR (General Product Safety Regulation) dell'Unione Europea, in vigore dal 13 dicembre 2024, impone a tutti gli e-commerce dell'area di mostrare in ogni scheda prodotto i dati del fabbricante (e del rappresentante UE se il fabbricante è extra UE). Inadempienza = sanzione.

Soluzione adottata dal modulo: un pannello dedicato nella scheda Impostazioni con 5 campi tutti opzionali da compilare una sola volta. I dati vengono mostrati automaticamente in tutte le schede prodotto Velleman.

• Nome del fabbricante (es: "Velleman Group NV")
• Indirizzo postale completo (via, CAP, città, paese)
• Email di contatto (resa cliccabile tramite mailto:)
• Telefono (reso cliccabile tramite tel:)
• Rappresentante UE (solo se fabbricante extra UE — lasciare vuoto per Velleman Belgio)

Visualizzazione condizionale intelligente: la sezione GPSR appare nelle schede prodotto solo se almeno un campo è compilato. Puoi partire senza GPSR, il modulo non va in crash. Formato visivo rosso chiaro per ricordare il suo carattere normativo.

💰 10 fasce di prezzo decrescenti Velleman

Velleman propone fino a 10 fasce di prezzo decrescenti in base alle quantità d'acquisto (tipicamente: 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Ogni fascia ha il proprio prezzo netto negoziato nel tuo contratto B2B Velleman.

Soluzione adottata dal modulo: un selettore nelle Impostazioni per scegliere la fascia che corrisponde al tuo volume d'acquisto medio reale. Il modulo usa questa fascia come prezzo di costo unico per calcolare il prezzo di vendita finale secondo la tua modalità (margins / fixed / wholesale).

• Selettore fascia: 1 / 5 / 25 / 100 / 500 (default 5, il più comune per PMI)
• Modalità margins: 6 fasce di margine configurabili per scaglione di prezzo netto
• Modalità fixed: 1 markup in % applicato uniformemente (es. 50%)
• Modalità wholesale: prezzo d'acquisto netto invariato (vendita B2B a scuole, maker space, ecc.)

🌳 Gerarchia di categorie su 10 livelli

Il CSV Velleman fornisce fino a 10 colonne "Titolo categoria 1..10" formando una gerarchia lineare profonda (root → figlio → nipote → pronipote…). Ogni prodotto appartiene a una foglia in fondo a una catena di categorie.

Soluzione adottata dal modulo: creazione al volo delle categorie mancanti sotto la radice PrestaShop configurata. Lookup prima della creazione (anti-duplicati) con query SQL ottimizzata.

Esempio:
"Componenti Elettronici e Accessori"
  → "Componenti elettronici"
    → "Condensatori"
      → "Tantalio"
        → "Bassa altezza"
          → ...

• Creazione multilingua sotto la tua radice PS (tutte le lingue attive ricevono lo stesso nome + slug)
• Lookup prima del create: SELECT per nome + parent → se trovata, si riusa l'ID esistente
• Collegamento prodotto completo: id_category_default = foglia più profonda, category_product compilato con tutta la catena (i filtri facetedsearch funzionano a tutti i livelli)
• Slug automatico tramite VlCompat::slug() (URL-safe, accenti normalizzati)

⚡ Architettura import in tempo reale + CRON 24/7

⏰ CRON 24/7 — 4 azioni automatizzate

• Chiave segreta 32 caratteri hex generata all'install — i tuoi URL CRON non sono indovinabili
• Rigenerazione a 1 clic della chiave in caso di leak
• Auto-rilancio asincrono tramite curl loopback: auto-richiamo in background se il time-budget è raggiunto (60s di default), sopravvivenza tramite @ignore_user_abort(true)
• Ripresa precisa: riparte esattamente dalla riga in cui si è fermato
• Lock anti-concorrenza tramite flock: nessuna esecuzione parallela
• Pulsante Stop lato BO per fermare in modo pulito un CRON in corso (flag file)
• Limite prodotti per esecuzione configurabile (10-100 per validare in modalità test, 0 = illimitato in produzione)
• Flash "task lanciato in background" immediato al clic Test BO — sai subito che il server sta lavorando

🏷️ Il catalogo Velleman in cifre

Universo prodotti del catalogo Velleman (estratto per grandi famiglie):

Marchi interni Velleman: Velleman Kit (kit saldatura), Velleman Modules, Vellight (illuminazione), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (sicurezza), Toolland (utensili), Velleman EDU (didattica).

🛠️ Manutenzione — Eliminazione selettiva

• ☐ Prodotti importati: rilevamento da 2 fonti (tabella meta + id_supplier), compatibile PS9 multi-shop con fallback wipe SQL se Product::delete() ritorna false
• ☐ Categorie vuote: scansione per profondità discendente tramite nleft/nright, eliminazione solo se zero prodotti collegati + zero sotto-categorie (preserva le radici PS_HOME, PS_ROOT)
• ☐ Marca Velleman: elimina il manufacturer solo se non ha più alcun prodotto collegato (doppia conferma richiesta)
• ☐ Log interni: truncate delle tabelle history e import_errors

Conferma semplice o doppia secondo il perimetro, con scheda dedicata Strumenti → Eliminazione selettiva. L'albero delle categorie viene preservato se hai prodotti altrove (non-Velleman) che le usano ancora.

⭐ 12 motivi per scegliere il Modulo Velleman

1. 🌐 Connessione FTP individuale per rivenditore (5 campi) — ogni cliente ha il suo file numerato, le sue fasce personali
2. 📸 Multi-immagini fino a 25 viste/prodotto tramite 2° CSV CDN (URL hardcoded invisibile cliente) — innovazione esclusiva Velleman
3. 🏆 Descrizione PREMIUM 10 sezioni attivabili individualmente (banner, intro, punti chiave, card tecniche, dimensioni, confezionamento, origine, eco, GPSR, CTA)
4. ✅ Conformità GPSR UE 2024 tramite modulo dedicato (5 campi opzionali) — visualizzazione automatica in tutte le schede
5. 🌳 10 livelli di categorie gerarchiche create al volo — gestione di alberi profondi specifici componenti
6. 💰 10 fasce di prezzo decrescenti Velleman + selettore prezzo d'acquisto nelle Impostazioni
7. 🔬 Parsing intelligente caratteristiche dettagliate (col 63): 1 sezione = 1 card visiva (Fisica / Elettrica / Tecnica / Installazione)
8. 🌍 Codifica Windows-1252 auto-convertita in UTF-8 cella per cella (preserva "Métré", "Réservé", caratteri tecnici europei)
9. 🔢 Decimali virgola + prefissi puntati auto-corretti (es: .354 → 0.354 — altrimenti il cast float va in crash)
10. ⚡ Import in tempo reale prodotto-per-prodotto: barra live, log console, pulsante Stop, ripresa precisa
11. ⏰ CRON 24/7 sicuro con time-budget, auto-rilancio asincrono, retry, lock, modalità test, limitatore prodotti
12. 💎 Nessun AdminController, nessuna Tab BO, nessun override: non inquina il menu, non rompe gli altri moduli

🎬 Come funziona in 5 passi

🔧 Compatibilità tecnica

❓ Domande frequenti

📦 Modulo sviluppato da WebPoint · webpoint.fr · Aggiornamenti regolari · Codice pulito e commentato