Modul PrestaShop de dropshipping BTSWHOLESALER
💄 ✨ 🧴
Modul BTSWholesaler Dropshipping
Modulul care automatizează de la A la Z dropshipping-ul tău de cosmetice, parfumuri & parafarmacie pe PrestaShop
PrestaShop 1.7 → 9.x · 5 limbi · CRON 24/7 · Branduri premium
Vinzi cosmetice, parfumuri sau produse de parafarmacie în dropshipping? Îți petreci zilele importând manual produse Vichy, La Roche-Posay, Nuxe, copiind notițele INCI, gestionând variantele după capacitate (75ml, 100ml, 200ml), transferând fiecare comandă pe portalul BTS, verificând tracking-urile, trimițând e-mailurile de expediere clienților?
Cu Modulul BTSWholesaler dropshipping, totul devine automat. Configurezi o singură dată, apoi uiți. Modulul lucrează 24/7 în fundal.
⚡ Înainte vs După Modulul BTSWholesaler
| Sarcină |
❌ Fără modul |
✅ Cu modulul |
| Import 1 000 produse parfumuri + cosmetice |
10h+ manual, copy-paste |
1 click, ~45 min în fundal |
| Variante după capacitate |
Creare manuală ml/g unul câte unul |
Grupare automată 75ml/100ml/200ml |
| Actualizare stocuri & prețuri |
Verificare zilnică pe portalul BTS |
Delta sync CRON la fiecare 2h |
| Procesarea unei comenzi |
Reintroducere pe portalul BTS, alegere curier |
Forward automat cu curier mapat |
| E-mail tracking client |
Copy-paste numărul |
Trimis automat de PS |
| Multilingv (5 limbi UE) |
Traducere manuală / DeepL plătit |
Texte native BTS preluate în paralel |
| Marje & prețuri de vânzare |
Calcul Excel produs cu produs |
10 paliere % automate pe tranșă |
| SEO & meta-descrieri |
Redactare manuală |
Șabloane cu variabile auto |
👤 Cui se adresează acest modul?
💄
Parafarmacie online
Vinzi produse de îngrijire (Vichy, La Roche-Posay, Avène, Bioderma) și vrei să-ți extinzi catalogul fără a gestiona stoc fizic.
🌸
Parfumerie e-commerce
Vrei să listezi Dior, Chanel, Calvin Klein, Hugo Boss, YSL cu variantele lor EDT/EDP 50ml/100ml în câteva click-uri.
📈
E-commerciant care scalează
Gestionezi 5 000+ referințe cosmetice manual și pierzi timp pe operațional în loc de marketing.
🎯 Funcționalități complete ale Modulului BTSWholesaler
📦 Import catalog BTS — În masă, fără timeout
- Autentificare JWT Bearer pe API BTS v2.1 (securitate bancară)
- Import unitar după EAN sau ID BTS pentru test sau recuperare
- Import în masă: 50, 100, 500, 1 000 produse sau întregul catalog
- Filtre avansate: după brand, după categorie BTS, mod limitat sau complet
- Mod ușor (light update): dacă un produs este deja importat, se modifică DOAR prețul/stocul/disponibilitatea. Fără rescrierea descrierilor, categoriilor sau tag-urilor.
- Reluare la eroare: relansare automată asincronă în caz de timeout
- Adaptat hosting modest: time-budget 60s, retry pe 429 rate-limit
🧴 Grupare inteligentă după capacitate
BTSWholesaler listează adesea același parfum sub mai multe SKU-uri distincte pentru fiecare capacitate. Modulul detectează automat grupurile și creează 1 produs PrestaShop cu variantele sale:
| SKU BTS |
Nume BTS |
Rezultat în PrestaShop |
3349668010615 |
Dior Sauvage EDT 60ml |
1 produs "Dior Sauvage EDT"
cu 3 variante:
· 60ml · 100ml · 200ml |
3349668010622 |
Dior Sauvage EDT 100ml |
3349668010639 |
Dior Sauvage EDT 200ml |
- Detectare automată a capacităților: ml, g, oz, cl, l, kg, gr
- Switch on/off în setări: dacă preferi 1 produs PS per SKU, modul se poate dezactiva
- Stoc individual pentru fiecare variantă
- Referință PS unică pentru fiecare combinație (EAN-ul BTS este păstrat)
🌐 Multilingv 5 limbi — Piețe europene
| ?? Franceză |
?? Spaniolă |
?? Engleză |
?? Italiană |
?? Germană |
- Apeluri paralele prin cURL multi: 1 round-trip pentru a prelua toate limbile unei pagini
- Detectare automată a limbilor PS active care au un echivalent BTS
- Auto-generare descrieri formatate HTML când API-ul nu furnizează pentru o limbă
- Reformatare inteligentă a descrierii: fiecare frază devine un <p> pentru lizibilitate și SEO
- Mini-descriere automată pentru fiecare limbă (description_short PS)
- Slug curat (link_rewrite) fără diacritice sau caractere speciale
🚚 Mapare curieri PS ↔ BTS — Precizie maximă
Pentru fiecare curier al magazinului tău PrestaShop, asociezi codul carrier_code BTSWholesaler corespunzător printr-un tabel de mapare dedicat:
| Curier PS |
Cod BTS asociat |
Țară |
| Colissimo Domiciliu |
colissimo_fr |
?? Franța |
| Mondial Relay |
mondial_relay_fr |
?? Franța |
| Chronopost |
chronopost_fr |
?? Franța |
| DHL Express |
dhl_express |
?? Europa |
| DPD |
dpd_fr |
?? Franța |
- Preluare automată a prețurilor prin
getShippingPrices() în funcție de țara de livrare
- Fallback grațios: dacă un curier nu este mapat, modulul folosește curierul implicit configurat
- Retry pe 429 rate-limit la forward-ul comenzii
💰 Marje configurabile — 10 paliere implicite
| Mod |
Descriere |
Pentru cine? |
| Paliere |
% diferit în funcție de tranșa de preț de achiziție (ex: +100% sub 10€, +50% peste 100€) |
⭐ Recomandat — maximizează marja pe prețuri mici |
| Markup fix |
Un singur % aplicat tuturor produselor |
Strategie simplă, marjă constantă |
| PFA / micro-întreprindere |
Mod de taxare simplificat (TVA neaplicabil) |
Independenți în regim fără TVA |
🔍 SEO & Șabloane personalizabile
- Meta title / meta description cu variabile:
{name}, {brand}, {ean}, {capacity}
- Generare automată de meta_keywords pornind de la titlu, brand, capacitate
- Filtru stop-words FR/EN integrat (le, la, les, the, of...)
- Tag-uri PS automate: brand, gen (Femei/Bărbați/Unisex), capacitate
- Imagine inserată în descrierea lungă (la început sau la sfârșit) — boost SEO on-page
- Auto-dezactivare la stoc epuizat sau opțiunea „păstrează vizibil pentru SEO"
✏️ Înlocuiri text — Personalizează la brandul tău
Reguli de substituție aplicate pe numele și descrierile importate. Mai multe scope-uri:
| Text sursă |
Text țintă |
Câmp |
Envío rápido |
Expediere rapidă |
Descriere |
BTSWholesaler |
Magazinul Meu |
Toate |
en stock |
livrare în 24h |
Descriere |
🛒 Pipeline de comenzi 100% automat
Scenariul care schimbă totul:
- 👤 Un client comandă un parfum pe magazinul tău PrestaShop
- 💳 Plătește → comanda trece la statusul „Plată acceptată"
- ⚡ Modulul transmite automat comanda către BTS (cu curier mapat în funcție de țară)
- 📨 BTS pregătește și expediază coletul direct clientului tău (în marcă albă)
- 🚚 CRON-ul modulului preia numărul de tracking când este disponibil
- 📧 PrestaShop trimite automat e-mailul de expediere clientului cu tracking-ul său
→ Nu ai atins NIMIC. Comanda este procesată cap-coadă.
- Hook PS nativ
actionOrderStatusUpdate — declanșare instantanee la schimbarea statusului
- 3 moduri de plată BTS suportate: transfer bancar, PayPal, card bancar
- Adresă client convertită în format BTS (firstname, lastname, address, postcode, city, country, phone)
- Idempotent: nu reface forward-ul unei comenzi deja transmise
- Tablou de bord: vezi toate comenzile PS și statusul lor BTS dintr-o privire
- Anulare propagată (opțional): dacă anulezi comanda PS, modulul apelează
setCancelOrder partea BTS
⏰ CRON 24/7 — 4 acțiuni automatizate
| Acțiune CRON |
Rol |
Frecvență recomandată |
full_import |
Import complet al catalogului (creare sau actualizare) |
1×/zi |
delta_sync |
Sincronizare incrementală (doar produsele modificate) |
la fiecare 2h |
stock_check |
Actualizare stoc + disponibilitate produse deja importate |
la fiecare oră |
tracking |
Preia tracking-uri + e-mail expediere către client |
la fiecare oră |
- Cheie securizată 32 caractere generată la instalare — URL-urile CRON nu pot fi ghicite
- Regenerare cu 1 click a cheii în caz de scurgere
- Auto-relansare asincronă: modulul se reapelează singur în fundal dacă time-budget-ul este atins (60s) — fără timeout Apache
- Reluare precisă: continuă exact de la pagina la care s-a oprit
- Retry automat pe rate-limit / eroare 429 / timeout rețea
- Status în timp real în BO: pagină curentă, create, actualizate, erori
- Buton stop: oprește curat CRON-ul în execuție
- Limită produse configurabilă: importă doar N produse pe „job"
📊 Tab Analytics — Pilotarea dropshipping-ului tău
- Istoric importuri: cine, când, câte, succese/eșecuri
- Jurnal de erori detaliat: erori la descărcare imagini, variante respinse, timeout API…
- Listă produse importate cu filtre (după brand, după categorie, după status)
- Export CSV al listei de produse BTS importate (pentru analiză externă)
- Paginare: 20, 50, 100, 500 produse pe pagină
- Căutare după EAN, nume, brand
🏷️️ Catalogul BTSWholesaler — Branduri premium accesibile
BTS Wholesaler este unul dintre cei mai mari distribuitori B2B europeni (cu sediul în Spania) specializat în cosmetice de mari branduri, parfumuri de nișă și branduri de lux, parafarmacie și igienă & frumusețe. Vedere de ansamblu (neexhaustivă) a brandurilor disponibile:
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 + sute de altele
Categorii acoperite: parfumerie bărbați/femei, îngrijire facială, îngrijire corporală, machiaj, păr, solare, igienă, parafarmacie, suplimente alimentare, bebeluși & copii.
⭐ 10 motive pentru a alege Modulul BTSWholesaler
- 🚀 Instalare în 5 minute: lipești token-ul JWT, testezi conexiunea, gata
- 🤖 100% AJAX, zero reload: interfață fluidă, modernă, plăcută
- 📚 Documentație integrată în 12 secțiuni: nu este necesară conexiunea la internet pentru consultare
- 🛡️️ Compatibil PS 1.7 → 9.x: strat de compatibilitate
BtsCompat care gestionează toate versiunile
- ⚡ Optimizat pentru hosting modest: import pe chunk-uri, throttle, time-budget 60s
- 🔐 Securitate maximă: token JWT Bearer, hash_equals pe cheia CRON, validare server-side
- 🎨 Design custom: header gradient albastru, tab-uri stilizate, paletă coerentă
- 🧹 Mentenanță ușoară: ștergere selectivă cu opțiuni, curățare orfani
- 💎 Niciun AdminController, niciun Tab: nu poluează meniul BO, configurare doar din fișa modulului
- 🌟 Autor francez: suport în franceză, actualizări regulate, cod curat & comentat
🎬 Cum funcționează în 4 pași
1
Instalează modulul
Descarci ZIP-ul, instalezi prin BO. Auto-creare a 10 tabele, 1 furnizor, 4 URL-uri CRON securizate.
2
Conectează-ți contul
Lipești token-ul JWT BTSWholesaler, alegi limba principală, testezi conexiunea (1 click).
3
Configurezi marjele
10 paliere implicite. Șabloane SEO, mapare curieri, multi-imagine, multilingv: totul este parametrizabil.
4
Lansezi importul
Filtrezi după branduri + categorii, alegi cantitatea, dai click „Lansează". CRON-ul preia ștafeta 24/7.
🔧 Compatibilitate tehnică
| PrestaShop |
1.7.x → 9.x (testat pe PS 9.0) |
| PHP |
7.4 minim, recomandat 8.1+ |
| MySQL / MariaDB |
5.7+ / 10.3+ |
| Multi-shop |
Compatibil (folosește shop-ul curent) |
| Hook-uri folosite |
actionOrderStatusUpdate |
| Override de clasă |
Niciunul (păstrează celelalte module) |
| AdminController |
Niciunul |
| Tab sidebar BO |
Niciunul (nu poluează meniul) |
| Cont BTSWholesaler |
Cont B2B necesar (pe btswholesaler.com) |
| Token JWT API |
A se cere reprezentantului comercial BTS |
❓ Întrebări frecvente
Î: Modulul BTSWholesaler dropshipping funcționează pe PrestaShop 9?
R: Da, este complet compatibil cu PS 9.x. Stratul intern de compatibilitate BtsCompat gestionează și versiunile 1.7 și 8 fără modificarea codului.
Î: Câte produse pot importa?
R: Nicio limită din partea modulului. Catalogul complet BTSWholesaler conține zeci de mii de referințe. Poți importa tot sau să țintești după branduri (Vichy, La Roche-Posay…) sau categorii (parfumerie, îngrijire facială…).
Î: Hosting-ul meu shared de 9 €/lună va face față?
R: Da, modulul este special optimizat pentru hosting-uri modeste. CRON pe chunk-uri, time-budget 60s, auto-relansare asincronă. Niciun risc de timeout Apache 5xx.
Î: Cum funcționează modul de variante după capacitate?
R: Modulul detectează SKU-urile care au același nume de bază și grupează capacitățile sub forma variantelor unui singur produs PS. Switch on/off în setări dacă preferi 1 produs per SKU.
Î: Comenzile sunt plătite automat la BTS?
R: Modulul suportă 3 moduri de plată (banktransfer, paypal, card). În funcție de acordul tău cu BTS, plata poate fi automată (cont prepaid) sau să necesite validarea ta din portal. Modulul preia apoi tracking + e-mail client automat.
Î: Ce se întâmplă dacă o imagine BTS este coruptă?
R: Modulul validează fiecare imagine cu getimagesize() înainte de import. Fișierele corupte (TIFF deghizat în JPEG, etc.) sunt respinse curat. Produsul este creat fără imagine în loc să blocheze importul.
Î: Ce se întâmplă dacă BTS este temporar indisponibil?
R: Modulul detectează erorile de rețea și HTTP 429 (rate-limit), face retry automat cu backoff și reia exact de unde s-a oprit la următoarea execuție CRON.
Î: Pot dezinstala curat?
R: Da, dar dezinstalarea păstrează intenționat produsele tale importate (pierdere ireversibilă evitată). O zonă „Ștergere selectivă" în tab-ul Mentenanță permite o curățare granulară cu confirmare.
🎯 Gata să-ți automatizezi dropshipping-ul?
Modulul BTSWholesaler dropshipping este instrumentul cel mai complet pentru a vinde branduri premium de cosmetice, parfumuri și parafarmacie pe PrestaShop. Configurat o singură dată, lucrează pentru tine 24/7.
⚡ INSTALARE 5 MIN · 📚 DOCUMENTAȚIE INTEGRATĂ · 🛡️ COMPATIBIL PS 1.7 → 9 · 🇫🇷 SUPORT FRANCEZ
📋 Detalii tehnice pentru dezvoltatori
Tabele BD 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
Configurări PS: WPBTS_SETTINGS (JSON), WPBTS_CRON_KEY, WPBTS_SUPPLIER_ID, WPBTS_DESCRIPTIONS, WPBTS_IMPORT_PROGRESS, WPBTS_DELTA_PROGRESS
API BTS folosite: getListProducts, getListProductsMultilang (cURL multi paralel), getCategoriesList, getProductCategories, getDictionnary, getCarriers, getShippingPrices, setOrder, setCancelOrder, getOrders, getOrder, getOrderTracking
Arhitectură: 4 clase PHP curate (BtsCompat, BtsApiClient, BtsCategoryMapper, BtsProductImporter) + modulul principal. Niciun override de clasă core PrestaShop. Cod comentat în franceză.
Securitate: autentificare JWT Bearer, hash_equals() pe cheia CRON, pSQL() peste tot, token CSRF nativ PS pe AJAX, throttle anti-DoS, validare format imagini.
📦 Modul dezvoltat de WebPoint · webpoint.fr · Actualizări regulate · Cod curat & comentat
