BTSWholesaler import kosmetyków PrestaShop: importuje katalog, stany i produkty dostawcy dla sklepu szybszego, zautomatyzowanego i czytelnego.
Moduł PrestaShop do dropshippingu BTSWHOLESALER
💄 ✨ 🧴
Moduł BTSWholesaler Dropshipping
Moduł, który automatyzuje od A do Z Twój dropshipping kosmetyków, perfum i parafarmaceutyków w PrestaShop
PrestaShop 1.7 → 9.x · 5 języków · CRON 24/7 · Marki premium
Sprzedajesz kosmetyki, perfumy lub parafarmaceutyki w modelu dropshipping? Spędzasz całe dnie ręcznie importując produkty Vichy, La Roche-Posay, Nuxe, kopiując informacje INCI, zarządzając wariantami pojemności (75 ml, 100 ml, 200 ml), przenosząc każde zamówienie na portal BTS, sprawdzając numery śledzenia, wysyłając e-maile o wysyłce do klientów?
Z Modułem BTSWholesaler dropshipping wszystko staje się automatyczne. Konfigurujesz raz, zapominasz. Moduł pracuje 24/7 w tle.
⚡ Przed vs Po wdrożeniu Modułu BTSWholesaler
| Zadanie |
❌ Bez modułu |
✅ Z modułem |
| Import 1 000 produktów perfumeryjnych i kosmetycznych |
10h+ ręcznie, kopiuj-wklej |
1 kliknięcie, ~45 min w tle |
| Warianty według pojemności |
Ręczne tworzenie ml/g jeden po drugim |
Automatyczne grupowanie 75 ml/100 ml/200 ml |
| Aktualizacja stanów i cen |
Codzienna kontrola na portalu BTS |
Synchronizacja delta CRON co 2h |
| Obsługa zamówienia |
Ponowne wpisywanie na portalu BTS, wybór przewoźnika |
Automatyczne przekazanie z mapowanym przewoźnikiem |
| E-mail o śledzeniu do klienta |
Kopiuj-wklej numer |
Wysyłany automatycznie przez PS |
| Wielojęzyczność (5 języków UE) |
Tłumaczenie ręczne / płatny DeepL |
Natywne teksty BTS pobierane równolegle |
| Marże i ceny sprzedaży |
Obliczenia w Excelu produkt po produkcie |
10 progów % automatycznie wg przedziału |
| SEO i meta opisy |
Ręczne pisanie |
Szablony ze zmiennymi automatycznymi |
👤 Do kogo skierowany jest ten moduł?
💄
Parafarmacja online
Sprzedajesz pielęgnację (Vichy, La Roche-Posay, Avène, Bioderma) i chcesz wielokrotnie zwiększyć katalog bez zarządzania fizycznym magazynem.
🌸
Perfumeria e-commerce
Chcesz wprowadzić Dior, Chanel, Calvin Klein, Hugo Boss, YSL z ich wariantami EDT/EDP 50 ml/100 ml w kilka kliknięć.
📈
E-sprzedawca, który skaluje
Zarządzasz ręcznie 5 000+ referencjami kosmetyków i tracisz czas na operacje zamiast na marketing.
🎯 Pełne funkcje Modułu BTSWholesaler
📦 Import katalogu BTS — masowo, bez timeoutu
- Uwierzytelnianie JWT Bearer w API BTS v2.1 (bezpieczeństwo bankowe)
- Import pojedynczy po EAN lub ID BTS — do testów lub uzupełnień
- Import masowy: 50, 100, 500, 1 000 produktów lub cały katalog
- Filtry zaawansowane: po marce, po kategorii BTS, tryb ograniczony lub pełny
- Tryb lekki (light update): jeśli produkt jest już zaimportowany, aktualizujemy WYŁĄCZNIE cenę/stan/dostępność. Brak nadpisywania opisów, kategorii lub tagów.
- Wznowienie po błędzie: automatyczne asynchroniczne ponowienie po timeoucie
- Dostosowane do skromnego hostingu: budżet czasowy 60 s, retry przy 429 rate-limit
🧴 Inteligentne grupowanie według pojemności
BTSWholesaler często wystawia te same perfumy w kilku różnych SKU dla każdej pojemności. Moduł automatycznie wykrywa grupy i tworzy 1 produkt PrestaShop z jego wariantami:
| SKU BTS |
Nazwa BTS |
Wynik w PrestaShop |
3349668010615 |
Dior Sauvage EDT 60ml |
1 produkt "Dior Sauvage EDT"
z 3 wariantami:
· 60 ml · 100 ml · 200 ml |
3349668010622 |
Dior Sauvage EDT 100ml |
3349668010639 |
Dior Sauvage EDT 200ml |
- Automatyczne wykrywanie pojemności: ml, g, oz, cl, l, kg, gr
- Przełącznik on/off w ustawieniach: jeśli wolisz 1 produkt PS na SKU, tryb można wyłączyć
- Indywidualny stan magazynowy dla każdego wariantu
- Unikalna referencja PS dla każdej kombinacji (EAN BTS jest zachowany)
🌐 Wielojęzyczność 5 języków — rynki europejskie
| ?? Francuski |
?? Hiszpański |
?? Angielski |
?? Włoski |
?? Niemiecki |
- Wywołania równoległe przez cURL multi: 1 round-trip do pobrania wszystkich języków strony
- Automatyczne wykrywanie aktywnych języków PS, które mają odpowiednik BTS
- Automatyczne generowanie opisów sformatowanych w HTML, gdy API nie dostarcza ich dla danego języka
- Inteligentne reformatowanie opisu: każde zdanie staje się <p> dla czytelności i SEO
- Automatyczny mini-opis dla każdego języka (description_short PS)
- Czysty slug (link_rewrite) bez akcentów i znaków specjalnych
🚚 Mapowanie przewoźników PS ↔ BTS — maksymalna precyzja
Dla każdego przewoźnika w Twoim sklepie PrestaShop kojarzysz odpowiadający mu carrier_code BTSWholesaler poprzez dedykowaną tabelę mapowania:
| Przewoźnik PS |
Powiązany kod BTS |
Kraj |
| Colissimo Domicile |
colissimo_fr |
?? Francja |
| Mondial Relay |
mondial_relay_fr |
?? Francja |
| Chronopost |
chronopost_fr |
?? Francja |
| DHL Express |
dhl_express |
?? Europa |
| DPD |
dpd_fr |
?? Francja |
- Automatyczne pobieranie cen przez
getShippingPrices() w zależności od kraju dostawy
- Łagodny fallback: jeśli przewoźnik nie jest zmapowany, moduł używa skonfigurowanego domyślnego przewoźnika
- Retry przy 429 rate-limit podczas przekazywania zamówienia
💰 Konfigurowalne marże — 10 progów domyślnie
| Tryb |
Opis |
Dla kogo? |
| Progi |
Inny % w zależności od przedziału ceny zakupu (np. +100% poniżej 10 €, +50% powyżej 100 €) |
⭐ Zalecane — maksymalizuje marżę przy niskich cenach |
| Stały narzut |
Jeden % do wszystkich produktów |
Prosta strategia, stała marża |
| Samozatrudnienie |
Tryb uproszczonego podatku (VAT nie ma zastosowania) |
Niezależni w zwolnieniu z VAT |
🔍 SEO i konfigurowalne szablony
- Meta title / meta description ze zmiennymi:
{name}, {brand}, {ean}, {capacity}
- Automatyczne generowanie meta_keywords z tytułu, marki, pojemności
- Filtr stop-words FR/EN wbudowany (le, la, les, the, of...)
- Automatyczne tagi PS: marka, płeć (Damska/Męska/Unisex), pojemność
- Obraz wstawiany w długim opisie (na początku lub na końcu) — boost SEO on-page
- Automatyczna dezaktywacja przy braku stanu lub opcja "zachowaj widoczność dla SEO"
✏️ Zamiana tekstu — dostosuj do swojej marki
Reguły zamiany stosowane na importowanych nazwach i opisach. Kilka zakresów:
| Tekst źródłowy |
Tekst docelowy |
Pole |
Envío rápido |
Szybka wysyłka |
Opis |
BTSWholesaler |
Mój Sklep |
Wszystkie |
en stock |
dostawa w 24h |
Opis |
🛒 Pipeline zamówień w 100% automatyczny
Scenariusz, który zmienia wszystko:
- 👤 Klient zamawia perfumy w Twoim sklepie PrestaShop
- 💳 Płaci → zamówienie przechodzi w status "Płatność zaakceptowana"
- ⚡ Moduł automatycznie przekazuje zamówienie do BTS (z przewoźnikiem zmapowanym według kraju)
- 📨 BTS przygotowuje i wysyła paczkę bezpośrednio do Twojego klienta (w białej etykiecie)
- 🚚 CRON modułu pobiera numer śledzenia, gdy jest dostępny
- 📧 PrestaShop automatycznie wysyła e-mail o wysyłce do klienta z numerem śledzenia
→ Nie zrobiłeś NIC. Zamówienie zostało obsłużone od początku do końca.
- Natywny hook PS
actionOrderStatusUpdate — natychmiastowe wyzwolenie przy zmianie statusu
- 3 tryby płatności BTS obsługiwane: przelew bankowy, PayPal, karta płatnicza
- Adres klienta konwertowany do formatu BTS (firstname, lastname, address, postcode, city, country, phone)
- Idempotentny: nie wykonuje ponownie przekazania już przekazanego zamówienia
- Pulpit: zobacz wszystkie swoje zamówienia PS i ich status BTS jednym rzutem oka
- Anulowanie propagowane (opcjonalnie): jeśli anulujesz zamówienie PS, moduł wywołuje
setCancelOrder po stronie BTS
⏰ CRON 24/7 — 4 zautomatyzowane akcje
| Akcja CRON |
Rola |
Zalecana częstotliwość |
full_import |
Pełny import katalogu (tworzenie lub aktualizacja) |
1×/dzień |
delta_sync |
Synchronizacja przyrostowa (tylko zmodyfikowane produkty) |
co 2h |
stock_check |
Aktualizacja stanu i dostępności już zaimportowanych produktów |
co godzinę |
tracking |
Pobiera numery śledzenia + e-mail wysyłki do klienta |
co godzinę |
- Bezpieczny klucz 32 znaków generowany przy instalacji — Twoich URL-i CRON nie da się odgadnąć
- Regeneracja klucza jednym kliknięciem w razie wycieku
- Asynchroniczne automatyczne ponawianie: moduł sam się ponownie wywołuje w tle, jeśli osiągnie budżet czasowy (60 s) — żadnego timeoutu Apache
- Precyzyjne wznowienie: kontynuuje dokładnie od strony, na której się zatrzymał
- Automatyczne ponowienie przy rate-limit / błędzie 429 / timeoucie sieci
- Status w czasie rzeczywistym w BO: aktualna strona, utworzone, zaktualizowane, błędy
- Przycisk stop: czysto zatrzymuje aktualnie działający CRON
- Konfigurowalny limit produktów: import tylko N produktów na "job"
📊 Zakładka Analytics — sterowanie Twoim dropshippingiem
- Historia importów: kto, kiedy, ile, sukcesy/porażki
- Szczegółowy dziennik błędów: błędy pobierania obrazu, odrzucone warianty, timeout API…
- Lista zaimportowanych produktów z filtrami (po marce, kategorii, statusie)
- Eksport CSV listy zaimportowanych produktów BTS (do analizy zewnętrznej)
- Paginacja: 20, 50, 100, 500 produktów na stronę
- Wyszukiwanie po EAN, nazwie, marce
🏷️️ Katalog BTSWholesaler — dostępne marki premium
BTS Wholesaler jest jednym z największych europejskich hurtowników B2B (z siedzibą w Hiszpanii) wyspecjalizowanym w kosmetykach znanych marek, perfumach niszowych i markach luksusowych, parafarmaceutykach oraz higienie i urodzie. Niewyczerpujący przegląd dostępnych marek:
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 + setki innych
Obejmowane kategorie: perfumeria męska/damska, pielęgnacja twarzy, pielęgnacja ciała, makijaż, włosy, opalanie/ochrona przeciwsłoneczna, higiena, parafarmacja, suplementy diety, dla dzieci i niemowląt.
⭐ 10 powodów, by wybrać Moduł BTSWholesaler
- 🚀 Instalacja w 5 minut: wklej swój token JWT, przetestuj połączenie i gotowe
- 🤖 100% AJAX, zero przeładowań: interfejs płynny, nowoczesny, przyjemny
- 📚 Wbudowana dokumentacja, 12 sekcji: brak konieczności połączenia z internetem do przeglądania
- 🛡️️ Kompatybilny z PS 1.7 → 9.x: warstwa kompatybilności
BtsCompat, która obsługuje wszystkie wersje
- ⚡ Zoptymalizowany pod skromny hosting: import w fragmentach, throttle, budżet czasowy 60 s
- 🔐 Maksymalne bezpieczeństwo: JWT Bearer token, hash_equals na kluczu CRON, walidacja po stronie serwera
- 🎨 Dedykowany design: niebieski gradient nagłówka, stylizowane zakładki, spójna paleta
- 🧹 Łatwa konserwacja: selektywne usuwanie z opcjami, czyszczenie sierot
- 💎 Brak AdminController, brak Tab: nie zaśmieca menu BO, konfiguracja wyłącznie w karcie modułu
- 🌟 Francuski autor: wsparcie po francusku, regularne aktualizacje, czysty i komentowany kod
🎬 Jak to działa w 4 krokach
1
Zainstaluj moduł
Pobierz plik ZIP, zainstaluj przez BO. Automatyczne tworzenie 10 tabel, 1 dostawcy, 4 bezpiecznych URL CRON.
2
Połącz swoje konto
Wklej token JWT BTSWholesaler, wybierz język główny, przetestuj połączenie (1 kliknięcie).
3
Skonfiguruj marże
10 progów domyślnie. Szablony SEO, mapowanie przewoźników, multi-obrazy, wielojęzyczność: wszystko jest konfigurowalne.
4
Uruchom import
Filtruj według marek i kategorii, wybierz ilość, kliknij "Uruchom". CRON przejmuje 24/7.
🔧 Kompatybilność techniczna
| PrestaShop |
1.7.x → 9.x (testowane na PS 9.0) |
| PHP |
7.4 minimum, zalecane 8.1+ |
| MySQL / MariaDB |
5.7+ / 10.3+ |
| Multi-shop |
Kompatybilny (używa bieżącego sklepu) |
| Wykorzystywane hooki |
actionOrderStatusUpdate |
| Override klas |
Brak (zachowuje pozostałe moduły) |
| AdminController |
Brak |
| Zakładka w bocznym menu BO |
Brak (nie zaśmieca menu) |
| Konto BTSWholesaler |
Wymagane konto B2B (na btswholesaler.com) |
| Token JWT API |
Do uzyskania od handlowca BTS |
❓ Najczęstsze pytania
P: Czy moduł BTSWholesaler dropshipping działa na PrestaShop 9?
O: Tak, w pełni kompatybilny z PS 9.x. Wewnętrzna warstwa kompatybilności BtsCompat obsługuje również wersje 1.7 i 8 bez modyfikacji kodu.
P: Ile produktów mogę zaimportować?
O: Brak limitu po stronie modułu. Pełny katalog BTSWholesaler zawiera dziesiątki tysięcy referencji. Możesz zaimportować wszystko lub kierować się markami (Vichy, La Roche-Posay…) albo kategoriami (perfumeria, pielęgnacja twarzy…).
P: Czy mój hosting współdzielony za 9 €/mies. wytrzyma?
O: Tak, moduł jest specjalnie zoptymalizowany pod skromne hostingi. CRON we fragmentach, budżet czasowy 60 s, asynchroniczne automatyczne ponawianie. Brak ryzyka timeoutu Apache 5xx.
P: Jak działa tryb wariantów według pojemności?
O: Moduł wykrywa SKU dzielące tę samą nazwę bazową i grupuje pojemności w warianty jednego produktu PS. Przełącznik on/off w ustawieniach, jeśli wolisz 1 produkt na SKU.
P: Czy zamówienia są automatycznie opłacane u BTS?
O: Moduł obsługuje 3 tryby płatności (banktransfer, paypal, karta). W zależności od umowy z BTS, płatność może być automatyczna (konto przedpłacone) lub wymagać Twojej walidacji z portalu. Następnie moduł automatycznie pobiera tracking + e-mail klienta.
P: Co się stanie, jeśli obraz BTS jest uszkodzony?
O: Moduł sprawdza każdy obraz przez getimagesize() przed importem. Uszkodzone pliki (TIFF udający JPEG itp.) są poprawnie odrzucane. Produkt jest tworzony bez obrazu zamiast wywalać import.
P: Co się stanie, jeśli BTS jest tymczasowo niedostępny?
O: Moduł wykrywa błędy sieciowe i HTTP 429 (rate-limit), automatycznie ponawia z backoffem i wznawia w miejscu, w którym się zatrzymał, przy następnym uruchomieniu CRON.
P: Czy mogę porządnie odinstalować?
O: Tak, ale uninstall celowo zachowuje zaimportowane produkty (uniknięcie nieodwracalnej straty). Strefa "Selektywne usuwanie" w zakładce Konserwacja umożliwia szczegółowe czyszczenie z potwierdzeniem.
🎯 Gotów zautomatyzować swój dropshipping?
Moduł BTSWholesaler dropshipping jest najbardziej kompletnym narzędziem do sprzedaży marek premium kosmetyków, perfum i parafarmaceutyków w PrestaShop. Skonfigurowany raz, pracuje dla Ciebie 24/7.
⚡ INSTALACJA 5 MIN · 📚 WBUDOWANA DOKUMENTACJA · 🛡️ KOMPATYBILNY Z PS 1.7 → 9 · 🇫🇷 WSPARCIE FRANCUSKIE
📋 Szczegóły techniczne dla deweloperów
Utworzone tabele BDD (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
Konfiguracje PS: WPBTS_SETTINGS (JSON), WPBTS_CRON_KEY, WPBTS_SUPPLIER_ID, WPBTS_DESCRIPTIONS, WPBTS_IMPORT_PROGRESS, WPBTS_DELTA_PROGRESS
Wykorzystywane API BTS: getListProducts, getListProductsMultilang (cURL multi równoległy), getCategoriesList, getProductCategories, getDictionnary, getCarriers, getShippingPrices, setOrder, setCancelOrder, getOrders, getOrder, getOrderTracking
Architektura: 4 czyste klasy PHP (BtsCompat, BtsApiClient, BtsCategoryMapper, BtsProductImporter) + moduł główny. Brak override klas core PrestaShop. Kod komentowany po francusku.
Bezpieczeństwo: uwierzytelnianie JWT Bearer, hash_equals() na kluczu CRON, pSQL() wszędzie, natywny token CSRF PS na AJAX, throttle anty-DoS, walidacja formatu obrazów.
📦 Moduł stworzony przez WebPoint · webpoint.fr · Regularne aktualizacje · Kod czysty i komentowany
