Integracja BigBuy¶

Wtyczka ta łączy Wasz sklep Shopware 6 z platformą BigBuy i umożliwia w pełni automatyczne dropshipping: produkty, kategorie, zasoby magazynowe i ceny są automatycznie importowane z katalogu BigBuy, nowe zamówienia są bezpośrednio przekazywane do BigBuy, a informacje śledzenia są zwracane do Shopware – wszystko bez ręcznego wysiłku.

❓ Najczęściej zadawane pytania¶

🔧 Instalacja¶

• Wymaganie wstępne: Wtyczka CNK Foundation (od wersji 3.0.4)
• Wymaganie wstępne: Pakiet BigBuy Ecommerce z dostępem API
• Instalacja przez menedżer wtyczek Shopware lub Composer
• Aktywuj wtyczkę: bin/console plugin:install --activate CnkPlatformBigBuyIntegration
• Zarejestruj zaplanowane zadania: bin/console scheduled-task:register
• Wykonaj konfigurację w obszarze administracji Shopware

⚙️ Konfiguracja¶

Poświadczenia dostępu API¶

Klucz API znajdziesz na swoim koncie klienta BigBuy w ustawieniach API. Użyj przycisku Testuj połączenie, aby zweryfikować poświadczenia przed zapisaniem.

Synchronizacja produktów¶

Zasoby magazynowe & Ceny¶

Transfer zamówień¶

Śledzenie wysyłek¶

🔄 Synchronizacje w szczegółach¶

Import produktów¶

Import produktów odbywa się codziennie (standard: co 24 godziny) jako zaplanowane zadanie w tle:

1. Kategorie BigBuy są mapowane do kategorii Shopware pod skonfigurowaną kategorię wejścia
2. Produkty są importowane z opisami, EAN, wagą i obrazami (pierwszy obraz jest ustawiany jako obraz okładki)
3. Produkty otrzymują standardową stawkę podatku sklepu i są automatycznie tam widoczne – jeśli skonfigurowany jest kanał sprzedaży
4. Już importowane produkty są rozpoznawane po ID produktu BigBuy i aktualizowane (brak duplikatu importu); pobrane obrazy są ponownie używane przy późniejszej synchronizacji zamiast być ponownie ładowane

Zasoby magazynowe & Ceny¶

Zasoby magazynowe i ceny są aktualizowane co godzinę. Skonfigurowana marża zysku jest przeliczana i stosowana przy każdej aktualizacji:

Cena Shopware (brutto) = Cena zakupu BigBuy × (1 + Marża%) + Marża stała

Marża jest stosowana do ceny zakupu BigBuy (ceny hurtowej). Obliczona wartość jest zapisywana jako cena brutto; cena netto jest automatycznie ustalana na podstawie standardowej stawki podatku sklepu.

Transfer zamówień¶

Zamówienia zawierające wyłącznie produkty BigBuy są automatycznie przesyłane do BigBuy zaraz po ustawieniu statusu « W przetwarzaniu ». Identyfikator zamówienia zwrócony przez BigBuy jest przechowywany w polu niestandardowym bigbuy_order_id zamówienia Shopware, aby uniknąć duplikatów transferów. Po pomyślnym transferze zamówienie jest automatycznie ustawiane na status zamówienia wybrany w Status po transferze (obsługiwane są również niestandardowe statusy zamówień).

Śledzenie wysyłek¶

Co godzinę wszystkie zamówienia Shopware z ustawionym polem bigbuy_order_id są zapytywane w BigBuy. Gdy tylko BigBuy zwróci numer śledzenia, jest on wprowadzany w odpowiedniej wysyłce Shopware i jest dostępny dla e-maili klientów i szczegółów zamówień.

⏱️ Zaplanowane zadania (Cronjobs)¶

Wtyczka rejestruje cztery zaplanowane zadania:

Interwały można regulować w obszarze administracji Shopware w Ustawienia → System → Zaplanowane zadania. Wykonanie wymaga aktywnej usługi Shopware Message Worker:

bin/console messenger:consume async

Ręczne uruchomienie zadania (CLI)¶

Każde zadanie można uruchomić bezpośrednio w terminalu do testowania lub jednorazowego wykonania. Polecenia wykonują tę samą logikę co zaplanowane zadania i generują podsumowanie wyników:

bin/console cnk:bigbuy:product-sync        # Import produktów & kategorii
bin/console cnk:bigbuy:stock-price-sync    # Aktualizacja zasobów & cen
bin/console cnk:bigbuy:order-transfer      # Transfer oczekujących zamówień
bin/console cnk:bigbuy:tracking-sync       # Pobranie numerów śledzenia

🛒 Typowe przypadki użycia¶

Czysty dropshipping¶

Sklep sprzedaje wyłącznie produkty BigBuy. Produkty, zasoby magazynowe i ceny są synchronizowane w pełni automatycznie. Zamówienia są natychmiast przesyłane do BigBuy, który wysyła bezpośrednio do klienta końcowego.

Sklep hybrydowy¶

Sklep oferuje swoje własne produkty i produkty BigBuy równolegle. Wtyczka synchronizuje tylko produkty połączone z ID produktu BigBuy. Twoje własne produkty pozostają bez zmian.

Ustalanie cen z marżą¶

Korzystając z konfigurowalnej marży zysku, operatorzy sklepów mogą celowo zarządzać swoją marżą bez konieczności ręcznego dostosowywania cen.

⭐ Korzyści dla operatorów sklepów¶

• Brak ręcznego wysiłku w utrzymaniu produktów – katalog BigBuy pozostaje automatycznie aktualny
• Brak magazynowania – BigBuy obsługuje wysyłkę bezpośrednio do klienta końcowego
• Dane zasobów w czasie rzeczywistym zmniejszają przesprzedaż
• Centralna konfiguracja wszystkich parametrów synchronizacji w panelu administracyjnym Shopware
• Pełna śledziwość poprzez identyfikatory zamówień BigBuy w Shopware
• Numery śledzenia trafiają automatycznie do Shopware – mniej zapytań klientów

🧩 Zakres funkcjonalności¶

• Import kategorii i produktów BigBuy wraz z obrazami i wielojęzycznymi tekstami
• Synchronizacja zasobów i cen w czasie rzeczywistym
• Konfigurowalna marża zysku (procent i/lub stała kwota)
• Automatyczne przesyłanie zamówień do BigBuy przy zmianie statusu
• Zadanie cron z powrotem dla oczekujących transferów zamówień
• Automatyczne importowanie numerów śledzenia do wysyłek Shopware
• Cztery niezależnie konfigurowalne zaplanowane zadania
• Tryb sandbox do testowania bez ryzyka
• Rejestrowanie błędów poprzez rejestrowanie Shopware

📚 Dokumentacja¶

Dodatkowa zawartość dokumentacji i zrzuty ekranu będą dostępne w kolejnych wersjach wtyczki.

Dokumentacja techniczna API BigBuy: https://api.bigbuy.eu/rest/doc

📬 Support¶

W przypadku pytań, sugestii dotyczących ulepszeń lub dostosowań, prosimy o kontakt za pośrednictwem poczty elektronicznej na adres support@cnk-plugins.de.