Modulo PrestaShop di dropshipping BTSWHOLESALER
💄 ✨ 🧴
Modulo BTSWholesaler Dropshipping
Il modulo che automatizza dalla A alla Z il tuo dropshipping di cosmetici, profumi & parafarmacia su PrestaShop
PrestaShop 1.7 → 9.x · 5 lingue · CRON 24/7 · Marchi premium
Vendi cosmetici, profumi o prodotti di parafarmacia in dropshipping? Passi le giornate a importare manualmente prodotti Vichy, La Roche-Posay, Nuxe, a copiare le schede INCI, a gestire le varianti per formato (75ml, 100ml, 200ml), a trasferire ogni ordine sul portale BTS, a verificare i tracking, a inviare le email di spedizione ai tuoi clienti?
Con il Modulo BTSWholesaler dropshipping, tutto diventa automatico. Configuri 1 volta, te ne dimentichi. Il modulo lavora 24/7 in background.
⚡ Prima vs Dopo il Modulo BTSWholesaler
| Attività |
❌ Senza il modulo |
✅ Con il modulo |
| Importazione di 1.000 prodotti profumi + cosmetici |
10h+ manuale, copia-incolla |
1 clic, ~45 min in background |
| Varianti per formato |
Creazione manuale ml/g uno a uno |
Raggruppamento automatico 75ml/100ml/200ml |
| Aggiornamento stock & prezzi |
Verifica giornaliera sul portale BTS |
Delta sync CRON ogni 2h |
| Elaborazione di un ordine |
Re-inserimento sul portale BTS, scelta corriere |
Forward auto con corriere mappato |
| Email tracking cliente |
Copia-incolla del numero |
Inviata automaticamente da PS |
| Multilingua (5 lingue UE) |
Traduzione manuale / DeepL a pagamento |
Testi nativi BTS recuperati in parallelo |
| Margini & prezzi di vendita |
Calcolo Excel prodotto per prodotto |
10 fasce % automatiche per scaglione |
| SEO & meta-description |
Redazione manuale |
Template con variabili automatiche |
👤 A chi si rivolge questo modulo?
💄
Parafarmacia online
Vendi prodotti per la cura della pelle (Vichy, La Roche-Posay, Avène, Bioderma) e vuoi moltiplicare il tuo catalogo senza gestire stock fisico.
🌸
Profumeria e-commerce
Vuoi inserire a catalogo Dior, Chanel, Calvin Klein, Hugo Boss, YSL con le loro varianti EDT/EDP 50ml/100ml in pochi clic.
📈
E-commerce in crescita
Gestisci 5.000+ referenze cosmetiche manualmente e perdi tempo nell'operativo invece che nel marketing.
🎯 Funzionalità complete del Modulo BTSWholesaler
📦 Importazione del catalogo BTS — In massa, senza timeout
- Autenticazione JWT Bearer sull'API BTS v2.1 (sicurezza bancaria)
- Importazione singola per EAN o ID BTS per test o recupero
- Importazione massiva: 50, 100, 500, 1.000 prodotti o l'intero catalogo
- Filtri avanzati: per marca, per categoria BTS, modalità limitata o completa
- Modalità leggera (light update): se un prodotto è già stato importato, si aggiorna SOLO prezzo/stock/disponibilità. Nessuna riscrittura di descrizioni, categorie o tag.
- Ripresa su errore: rilancio automatico asincrono in caso di timeout
- Adatto a hosting modesti: time-budget 60s, retry su 429 rate-limit
🧴 Raggruppamento intelligente per formato
BTSWholesaler spesso elenca lo stesso profumo in più SKU distinti per ciascun formato. Il modulo rileva automaticamente i gruppi e crea 1 prodotto PrestaShop con le sue varianti:
| SKU BTS |
Nome BTS |
Risultato in PrestaShop |
3349668010615 |
Dior Sauvage EDT 60ml |
1 prodotto "Dior Sauvage EDT"
con 3 varianti:
· 60ml · 100ml · 200ml |
3349668010622 |
Dior Sauvage EDT 100ml |
3349668010639 |
Dior Sauvage EDT 200ml |
- Rilevamento automatico dei formati: ml, g, oz, cl, l, kg, gr
- Switch on/off nei parametri: se preferisci 1 prodotto PS per SKU, la modalità è disattivabile
- Stock individuale per variante
- Riferimento PS unico per combinazione (l'EAN BTS è conservato)
🌐 Multilingua 5 lingue — Mercati europei
| ?? Francese |
?? Spagnolo |
?? Inglese |
?? Italiano |
?? Tedesco |
- Chiamate parallele via cURL multi: 1 round-trip per recuperare tutte le lingue di una pagina
- Rilevamento automatico delle lingue PS attive che hanno un equivalente BTS
- Auto-generazione di descrizioni formattate HTML quando l'API non ne fornisce per una lingua
- Riformattazione intelligente della descrizione: ogni frase diventa un <p> per la leggibilità e la SEO
- Mini-descrizione automatica per lingua (description_short PS)
- Slug pulito (link_rewrite) senza accenti né caratteri speciali
🚚 Mapping corrieri PS ↔ BTS — Massima precisione
Per ogni corriere del tuo negozio PrestaShop, associ il carrier_code BTSWholesaler corrispondente tramite una tabella di mapping dedicata:
| Corriere PS |
Codice BTS associato |
Paese |
| Colissimo Domicile |
colissimo_fr |
?? Francia |
| Mondial Relay |
mondial_relay_fr |
?? Francia |
| Chronopost |
chronopost_fr |
?? Francia |
| DHL Express |
dhl_express |
?? Europa |
| DPD |
dpd_fr |
?? Francia |
- Recupero automatico dei prezzi tramite
getShippingPrices() in base al paese di consegna
- Fallback graceful: se un corriere non è mappato, il modulo utilizza il corriere predefinito configurato
- Retry su 429 rate-limit durante il forward dell'ordine
💰 Margini configurabili — 10 fasce di default
| Modalità |
Descrizione |
Per chi? |
| Fasce |
% diversa in base alla fascia di prezzo di acquisto (es: +100% sotto 10€, +50% oltre 100€) |
⭐ Consigliato — massimizza il margine sui prezzi bassi |
| Markup fisso |
Una sola % su tutti i prodotti |
Strategia semplice, margine costante |
| Regime forfettario |
Modalità tassazione semplificata (IVA non applicabile) |
Lavoratori autonomi in franchigia IVA |
🔍 SEO & Template personalizzabili
- Meta title / meta description con variabili:
{name}, {brand}, {ean}, {capacity}
- Generazione automatica di meta_keywords a partire da titolo, marca, formato
- Filtro stop-words FR/EN integrato (le, la, les, the, of...)
- Tag PS automatici: marca, genere (Donna/Uomo/Unisex), formato
- Immagine inserita nella descrizione lunga (all'inizio o alla fine) — boost SEO on-page
- Auto-disattivazione esaurito stock oppure opzione "mantieni visibile per la SEO"
✏️ Sostituzioni di testo — Personalizza al tuo brand
Regole di sostituzione applicate sui nomi e sulle descrizioni importati. Più ambiti:
| Testo sorgente |
Testo destinazione |
Campo |
Envío rápido |
Spedizione rapida |
Descrizione |
BTSWholesaler |
Il Mio Negozio |
Tutti |
en stock |
consegna in 24h |
Descrizione |
🛒 Pipeline degli ordini 100% automatica
Lo scenario che cambia tutto:
- 👤 Un cliente ordina un profumo sul tuo negozio PrestaShop
- 💳 Paga → l'ordine passa allo stato "Pagamento accettato"
- ⚡ Il modulo inoltra automaticamente l'ordine a BTS (con corriere mappato in base al paese)
- 📨 BTS prepara e spedisce il pacco direttamente al tuo cliente (in white label)
- 🚚 Il CRON del modulo recupera il numero di tracking quando è disponibile
- 📧 PrestaShop invia automaticamente l'email di spedizione al cliente con il suo tracking
→ Non hai toccato NIENTE. L'ordine è gestito dall'inizio alla fine.
- Hook PS nativo
actionOrderStatusUpdate — attivazione istantanea al cambio di stato
- 3 modalità di pagamento BTS supportate: bonifico bancario, PayPal, carta di credito
- Indirizzo cliente convertito nel formato BTS (firstname, lastname, address, postcode, city, country, phone)
- Idempotente: non riesegue il forward di un ordine già trasmesso
- Dashboard: visualizza tutti i tuoi ordini PS e il loro stato BTS in un colpo d'occhio
- Annullamento propagato (opzionale): se annulli l'ordine PS, il modulo chiama
setCancelOrder lato BTS
⏰ CRON 24/7 — 4 azioni automatizzate
| Azione CRON |
Ruolo |
Frequenza consigliata |
full_import |
Importazione completa del catalogo (creazione o aggiornamento) |
1 volta/giorno |
delta_sync |
Sincronizzazione incrementale (solo i prodotti modificati) |
ogni 2h |
stock_check |
Aggiornamento stock + disponibilità dei prodotti già importati |
ogni ora |
tracking |
Recupera tracking + email cliente di spedizione |
ogni ora |
- Chiave sicura di 32 caratteri generata all'installazione — i tuoi URL CRON non possono essere indovinati
- Rigenerazione con 1 clic della chiave in caso di fuga
- Auto-rilancio asincrono: il modulo si richiama da solo in background se viene raggiunto il time-budget (60s) — nessun timeout Apache
- Ripresa precisa: riprende esattamente dalla pagina dove si è fermato
- Retry automatico su rate-limit / errore 429 / timeout di rete
- Stato in tempo reale nel BO: pagina corrente, creati, aggiornati, errori
- Pulsante stop: arresta in modo pulito il CRON in corso
- Limite prodotti configurabile: importare solo N prodotti per "job"
📊 Tab Analytics — Pilotaggio del tuo dropshipping
- Storico delle importazioni: chi, quando, quanti, successi/fallimenti
- Log degli errori dettagliato: errori di download immagini, varianti rifiutate, timeout API…
- Elenco dei prodotti importati con filtri (per marca, per categoria, per stato)
- Esportazione CSV dell'elenco dei prodotti BTS importati (per analisi esterna)
- Paginazione: 20, 50, 100, 500 prodotti per pagina
- Ricerca per EAN, nome, marca
🏷️️ Il catalogo BTSWholesaler — Marchi premium accessibili
BTS Wholesaler è uno dei più grandi grossisti B2B europei (con sede in Spagna) specializzato in cosmetici di grandi marche, profumi di nicchia e marchi di lusso, parafarmacia e igiene & bellezza. Panoramica non esaustiva dei marchi disponibili:
Vichy La Roche-Posay Avène Bioderma Nuxe Caudalie Eucerin L'Oréal Dior Chanel Calvin Klein Hugo Boss YSL Versace Dolce & Gabbana Garnier Nivea Sanex Yves Rocher + centinaia di altri
Categorie coperte: profumeria uomo/donna, cura del viso, cura del corpo, make-up, capelli, solari, igiene, parafarmacia, integratori alimentari, bambini & neonati.
⭐ 10 motivi per scegliere il Modulo BTSWholesaler
- 🚀 Installazione in 5 minuti: incolla il tuo token JWT, testa la connessione, sei pronto
- 🤖 100% AJAX, zero reload: interfaccia fluida, moderna, piacevole
- 📚 Documentazione integrata in 12 sezioni: nessuna connessione internet richiesta per consultarla
- 🛡️️ Compatibile PS 1.7 → 9.x: layer di compatibilità
BtsCompat che gestisce tutte le versioni
- ⚡ Ottimizzato per hosting modesti: importazione a chunk, throttle, time-budget 60s
- 🔐 Massima sicurezza: token JWT Bearer, hash_equals sulla chiave CRON, validazione lato server
- 🎨 Design custom: header con gradiente blu, tab stilizzate, palette coerente
- 🧹 Manutenzione facile: cancellazione selettiva con opzioni, pulizia degli orfani
- 💎 Nessun AdminController, nessuna Tab: non inquina il tuo menu BO, configurazione solo nella scheda del modulo
- 🌟 Autore francese: supporto in francese, aggiornamenti regolari, codice pulito & commentato
🎬 Come funziona in 4 step
1
Installa il modulo
Scarica lo ZIP, installalo dal BO. Auto-creazione di 10 tabelle, 1 fornitore, 4 URL CRON sicuri.
2
Connetti il tuo account
Incolla il tuo token JWT BTSWholesaler, scegli la lingua principale, testa la connessione (1 clic).
3
Configura i tuoi margini
10 fasce di default. Template SEO, mapping corrieri, multi-immagini, multilingua: tutto è parametrizzabile.
4
Avvia l'importazione
Filtra per marche + categorie, scegli la quantità, clicca "Avvia". Il CRON prende il sopravvento 24/7.
🔧 Compatibilità tecnica
| PrestaShop |
1.7.x → 9.x (testato su PS 9.0) |
| PHP |
7.4 minimo, raccomandato 8.1+ |
| MySQL / MariaDB |
5.7+ / 10.3+ |
| Multi-shop |
Compatibile (utilizza lo shop corrente) |
| Hook utilizzati |
actionOrderStatusUpdate |
| Override di classe |
Nessuno (preserva i tuoi altri moduli) |
| AdminController |
Nessuno |
| Tab sidebar BO |
Nessuna (non inquina il tuo menu) |
| Account BTSWholesaler |
Account B2B richiesto (su btswholesaler.com) |
| Token JWT API |
Da richiedere al tuo commerciale BTS |
❓ Domande frequenti
D: Il modulo BTSWholesaler dropshipping funziona su PrestaShop 9?
R: Sì, totalmente compatibile con PS 9.x. Il layer di compatibilità interno BtsCompat gestisce anche le versioni 1.7 e 8 senza modifiche al codice.
D: Quanti prodotti posso importare?
R: Nessun limite lato modulo. Il catalogo BTSWholesaler completo contiene decine di migliaia di referenze. Puoi importare tutto oppure mirare per marche (Vichy, La Roche-Posay…) o categorie (profumeria, cura del viso…).
D: Il mio hosting condiviso da 9 €/mese reggerà?
R: Sì, il modulo è specialmente ottimizzato per hosting modesti. CRON a chunk, time-budget 60s, auto-rilancio asincrono. Nessun rischio di timeout Apache 5xx.
D: Come funziona la modalità varianti per formato?
R: Il modulo rileva gli SKU che condividono lo stesso nome di base e raggruppa i formati in varianti di un unico prodotto PS. Switch on/off nei parametri se preferisci 1 prodotto per SKU.
D: Gli ordini vengono pagati automaticamente da BTS?
R: Il modulo supporta 3 modalità di pagamento (banktransfer, paypal, carta). A seconda dell'accordo con BTS, il pagamento può essere automatico (account prepagato) o richiedere la tua convalida dal portale. Il modulo recupera poi tracking + email cliente automaticamente.
D: Cosa succede se un'immagine BTS è corrotta?
R: Il modulo valida ogni immagine con getimagesize() prima dell'importazione. I file corrotti (TIFF mascherati da JPEG, ecc.) vengono rifiutati in modo pulito. Il prodotto viene creato senza immagine invece di far crashare l'importazione.
D: Cosa succede se BTS è temporaneamente non disponibile?
R: Il modulo rileva gli errori di rete e HTTP 429 (rate-limit), riprova automaticamente con backoff e riprende da dove si era fermato alla successiva esecuzione CRON.
D: Posso disinstallare in modo pulito?
R: Sì, ma la disinstallazione conserva volutamente i prodotti importati (perdita irreversibile evitata). Una zona "Cancellazione selettiva" nella tab Manutenzione consente una pulizia granulare con conferma.
🎯 Pronto ad automatizzare il tuo dropshipping?
Il Modulo BTSWholesaler dropshipping è lo strumento più completo per vendere i marchi premium di cosmetici, profumi e parafarmacia su PrestaShop. Una volta configurato, lavora per te 24/7.
⚡ INSTALLAZIONE 5 MIN · 📚 DOCUMENTAZIONE INTEGRATA · 🛡️ COMPATIBILE PS 1.7 → 9 · 🇫🇷 SUPPORTO FRANCESE
📋 Dettagli tecnici per sviluppatori
Tabelle DB create (10): wp_btswholesaler_margins, wp_btswholesaler_history, wp_btswholesaler_category_mapping, wp_btswholesaler_product_meta, wp_btswholesaler_combination_meta, wp_btswholesaler_text_replacements, wp_btswholesaler_seo_templates, wp_btswholesaler_import_errors, wp_btswholesaler_carrier_mapping, wp_btswholesaler_orders
Configurazioni PS: WPBTS_SETTINGS (JSON), WPBTS_CRON_KEY, WPBTS_SUPPLIER_ID, WPBTS_DESCRIPTIONS, WPBTS_IMPORT_PROGRESS, WPBTS_DELTA_PROGRESS
API BTS utilizzate: getListProducts, getListProductsMultilang (cURL multi parallelo), getCategoriesList, getProductCategories, getDictionnary, getCarriers, getShippingPrices, setOrder, setCancelOrder, getOrders, getOrder, getOrderTracking
Architettura: 4 classi PHP pulite (BtsCompat, BtsApiClient, BtsCategoryMapper, BtsProductImporter) + modulo principale. Nessun override di classe core PrestaShop. Codice commentato in francese.
Sicurezza: autenticazione JWT Bearer, hash_equals() sulla chiave CRON, pSQL() ovunque, token CSRF nativo PS sull'AJAX, throttle anti DoS, validazione formato immagini.
📦 Modulo sviluppato da WebPoint · webpoint.fr · Aggiornamenti regolari · Codice pulito & commentato
