BETA
Funkcje Analityka Cennik Kontakt Jak zacząć Zapisz się →
Jak zacząć

Pierwsze kroki z SZOPly

Przewodniki konfiguracji, instrukcje podłączenia sklepu i odpowiedzi na pytania techniczne.

Pierwsze kroki
🛍️ Podłącz sklep Shoper 🟢 Podłącz WooCommerce
Platformy
Shoper WooCommerce PrestaShop (wkrótce) BaseLinker (wkrótce)
Pytania techniczne
Często zadawane pytania
🛍️ Shoper

Konfiguracja Shopera

Jak podłączyć sklep oparty na platformie Shoper do SZOPly — krok po kroku. Cały proces zajmuje około 5 minut i nie wymaga żadnych zmian w Twoim sklepie.

Zanim zaczniesz

Potrzebujesz:

  • Dostępu do panelu administracyjnego swojego sklepu Shoper
  • Konta w SZOPly (możesz je założyć razem z podłączeniem sklepu)
  • Uprawnień administratora w sklepie Shoper

Krok po kroku

1
Zaloguj się do panelu Shopera

Wejdź na adres twojsklep.shoper.pl/admin (podstaw domenę swojego sklepu) i zaloguj się jako administrator.

2
Przejdź do ustawień WebAPI

W menu panelu: Sklep → Ustawienia zaawansowane → WebAPI. Możesz też wpisać "webapi" w wyszukiwarce na górze panelu. Kliknij zakładkę Użytkownicy WebAPI.

3
Dodaj nowego użytkownika WebAPI

Kliknij "Dodaj użytkownika WebAPI". W polu nazwa wpisz np. SZOPly — żeby łatwo rozpoznać do czego służy konto.

4
Ustaw uprawnienia — WYŁĄCZNIE odczyt

To najważniejszy krok. SZOPly potrzebuje jedynie uprawnień do odczytu danych — nigdy edycji ani usuwania. Zaznacz uprawnienia zgodnie z tabelą poniżej i nie zaznaczaj niczego więcej.

⚠️ Ważne — tylko odczyt: SZOPly wyłącznie odczytuje dane z Twojego sklepu i nigdy nic nie modyfikuje. Skonfigurowane poniżej uprawnienia gwarantują, że SZOPly nie może zmienić ani usunąć żadnych danych w Twoim sklepie.
Zasób API Odczyt (list / get) Edycja (put / post) Usuwanie (delete)
Klienci (users) ✓ zaznacz ✗ zostaw puste ✗ zostaw puste
Adresy klientów (user-addresses) ✓ zaznacz ✗ zostaw puste ✗ zostaw puste
Zamówienia (orders) ✓ zaznacz ✗ zostaw puste ✗ zostaw puste
Produkty (products) ✓ zaznacz ✗ zostaw puste ✗ zostaw puste
Statusy zamówień (order-statuses) ✓ zaznacz ✗ zostaw puste ✗ zostaw puste
Pozostałe zasoby Zostaw puste — SZOPly ich nie potrzebuje
5
Zapisz i skopiuj login oraz hasło

Kliknij "Zapisz". Shoper wyświetli login i hasło dla nowego użytkownika WebAPI. Skopiuj oba i zachowaj w bezpiecznym miejscu — hasło jest widoczne tylko raz bezpośrednio po utworzeniu konta.

6
Podłącz sklep w panelu SZOPly

Zaloguj się do panelu SZOPly i przejdź do Sklepy → Dodaj sklep. Wypełnij trzy pola dokładnie tak jak widnieją w formularzu:

URL sklepu: twojsklep.shoper.pl (bez https://)
Login WebAPI: skopiowany z panelu Shopera
Hasło WebAPI: skopiowane z panelu Shopera

Gotowe! Po podłączeniu SZOPly automatycznie uruchomi pierwszą synchronizację. Zależnie od liczby zamówień w sklepie, dane pojawią się w panelu w ciągu od kilku do kilkunastu minut. Kolejne synchronizacje uruchamiają się automatycznie zgodnie z wybranym planem.
🟢 WooCommerce

Konfiguracja WooCommerce

Jak podłączyć sklep oparty na WooCommerce do SZOPly za pomocą REST API — krok po kroku. Cały proces zajmuje około 7 minut i nie wymaga żadnych zmian w Twoim sklepie.

Zanim zaczniesz

Potrzebujesz:

  • WooCommerce w wersji 6.0 lub nowszej (sprawdź w: WP Admin → Wtyczki)
  • Dostępu do panelu administracyjnego WordPress z uprawnieniami administratora
  • Włączonego protokołu HTTPS na sklepie (wymagane przez WooCommerce REST API)
  • Konta w SZOPly

Krok po kroku

1
Zaloguj się do panelu WordPress

Wejdź na twojsklep.pl/wp-admin i zaloguj się jako administrator.

2
Przejdź do ustawień REST API WooCommerce

W menu: WooCommerce → Ustawienia → Zaawansowane → REST API. Jeśli nie widzisz tej zakładki, upewnij się że WooCommerce jest zaktualizowany do wersji 6.0+.

3
Dodaj nowy klucz API

Kliknij "Dodaj klucz" (lub "Add key"). Wypełnij pola:

  • Opis: wpisz SZOPly
  • Użytkownik: wybierz administratora
  • Uprawnienia: wybierz Odczyt (Read)
⚠️ Ważne — tylko odczyt: SZOPly wyłącznie odczytuje dane z Twojego sklepu i nigdy nic nie modyfikuje. Uprawnienie "Odczyt" (Read) jest wystarczające i zalecane ze względów bezpieczeństwa.
4
Skopiuj Consumer Key i Consumer Secret

Po kliknięciu "Generuj klucz API" WooCommerce wyświetli Consumer Key (zaczyna się od ck_) i Consumer Secret (zaczyna się od cs_). Skopiuj oba — są widoczne tylko raz!

5
Dodaj sklep w SZOPly

W panelu SZOPly: Sklepy → Dodaj sklep, wybierz platformę WooCommerce i wypełnij:

URL sklepu: https://twojsklep.pl (pełny adres z https://)
Consumer Key: skopiowane z WooCommerce (ck_...)
Consumer Secret: skopiowane z WooCommerce (cs_...)
6
Przetestuj połączenie i uruchom sync

SZOPly automatycznie zweryfikuje klucze API. Po potwierdzeniu połączenia kliknij "Synchronizuj". Dane pojawią się w panelu po kilku-kilkunastu minutach (zależnie od liczby zamówień).

Gotowe! SZOPly obsługuje WooCommerce 6.0+ z włączonym REST API. Upewnij się że Twój sklep działa na HTTPS — WooCommerce REST API nie działa na HTTP.

Najczęstsze problemy z WooCommerce

401 Unauthorized: Sprawdź czy Consumer Key i Secret są poprawnie skopiowane (bez spacji). Upewnij się że URL zaczyna się od https://.

REST API niedostępne: Wejdź w WP Admin → Ustawienia → Bezpośrednie odnośniki i kliknij "Zapisz" (to odświeża reguły permalink, wymagane przez WooCommerce REST API).

Klucze nie generują się: Upewnij się że WooCommerce jest w wersji 6.0+ i że jesteś zalogowany jako administrator WordPress (nie tylko WooCommerce).

Problem się utrzymuje? Napisz do nas →

Często zadawane pytania

Czy SZOPly może modyfikować dane w moim sklepie?

Nie. SZOPly używa wyłącznie odczytu API. Skonfigurowane zgodnie z instrukcją powyżej uprawnienia fizycznie uniemożliwiają jakiekolwiek modyfikacje. Twój sklep jest w pełni bezpieczny.

Gdzie dokładnie w panelu Shopera znajdę ustawienia Webapi?

Ścieżka: Sklep → Ustawienia zaawansowane → Webapi. Jeśli nie widzisz tej opcji, upewnij się że jesteś zalogowany jako administrator z pełnymi uprawnieniami. Możesz też wpisać "webapi" w wewnętrznej wyszukiwarce panelu Shopera (ikonka lupy na górze).

Zgubiłem hasło WebAPI — co teraz?

Wróć do panelu Shopera → Sklep → Ustawienia zaawansowane → WebAPI → Użytkownicy WebAPI, znajdź użytkownika SZOPly i usuń go, a następnie dodaj nowego. Nowy login i hasło wpisz w SZOPly w ustawieniach sklepu (Sklepy → edytuj sklep). Hasła nie da się odzyskać — można je tylko zastąpić nowym kontem.

Mam kilka sklepów — czy mogę podłączyć wszystkie?

Tak. W panelu SZOPly możesz podłączyć wiele sklepów — limit zależy od wybranego planu (Free/Standard: 1, Premium: 5, Enterprise: bez limitu). Każdy sklep konfiguruje się osobno, dokładnie według tej samej instrukcji.

Jak często SZOPly synchronizuje dane?

Zależy od planu: Standard — raz na dobę, Premium — co godzinę, Enterprise — co godzinę z możliwością konfiguracji. Możesz też uruchomić synchronizację ręcznie w dowolnym momencie bezpośrednio z panelu.

Co oznaczają fazy synchronizacji widoczne w panelu?

SZOPly synchronizuje dane etapami: najpierw zlicza dane, pobiera klientów, adresy, zamówienia, produkty, a na końcu przelicza segmentację RFM i wskaźniki. Cały pasek postępu widoczny jest w czasie rzeczywistym podczas synchronizacji.

Synchronizacja nie działa — co sprawdzić?

Sprawdź kolejno: (1) czy Login WebAPI i Hasło WebAPI są poprawnie skopiowane (bez spacji na początku i końcu), (2) czy uprawnienia odczytu są zaznaczone dla Klientów, Zamówień i Produktów, (3) czy URL sklepu jest w formacie twojsklep.shoper.pl bez https://, (4) czy sklep jest aktywny i dostępny. Jeśli problem się utrzymuje — napisz do nas przez formularz kontaktowy.

Nie znalazłeś odpowiedzi? Napisz do nas → — odpowiadamy w ciągu 24 godzin.