Przewodnik konfiguracji WebAPI krok po kroku — cały proces zajmuje około 5 minut.
SZOPly → Jak zacząć → Poradnik Shoper
SZOPly łączy się ze sklepem Shoper przez wbudowany moduł WebAPI. Nie wymaga to instalowania żadnych wtyczek ani zmian w kodzie sklepu — wystarczy wygenerować konto WebAPI z uprawnieniami tylko do odczytu.
Potrzebujesz:
Wejdź na adres twojsklep.shoper.pl/admin (podstaw domenę swojego sklepu) i zaloguj się jako administrator.
W menu panelu: Sklep → Ustawienia zaawansowane → WebAPI. Możesz też wpisać webapi w wyszukiwarce na górze panelu. Kliknij zakładkę Użytkownicy WebAPI.
Kliknij "Dodaj użytkownika WebAPI". W polu nazwa wpisz np. SZOPly — żeby łatwo rozpoznać do czego służy konto.
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.
| 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 | ||
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.
Zaloguj się do panelu SZOPly i przejdź do Sklepy → Dodaj sklep. Wypełnij trzy pola:
twojsklep.shoper.pl (bez https://)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.
Ś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).
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.
Tak. W panelu SZOPly możesz podłączyć wiele sklepów — limit zależy od planu (Free/Standard: 1 sklep, Premium: 5 sklepów, Enterprise: bez limitu). Każdy sklep konfiguruje się osobno według tej samej instrukcji.
Sprawdź kolejno: (1) czy login i hasło WebAPI są poprawnie skopiowane (bez spacji), (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.
Standard — raz na dobę, Premium — co 6 godzin, Enterprise — co godzinę. Możesz też uruchomić synchronizację ręcznie z poziomu panelu w dowolnym momencie.
Nie znalazłeś odpowiedzi? Napisz do nas → — odpowiadamy w ciągu 24 godzin.
Po pierwszej synchronizacji odkryjesz pełną moc analityki SZOPly: segmentację klientów RFM, raporty AI, prognozy sprzedaży i rekomendacje "Zrób to teraz".