Jak podłączyć sklep Shopify do SeeProfit
Poradnik krok po kroku - tworzenie aplikacji w Shopify Dev Dashboard, właściwe uprawnienia, instalacja na sklepie i wklejenie Client ID + Client secret w SeeProfit.
Integracja z Shopify działa przez własną aplikację, którą tworzysz w Shopify Dev Dashboard i instalujesz na swoim sklepie. Nie instalujesz nic ze sklepu z aplikacjami, a dostęp jest tylko do odczytu - SeeProfit fizycznie nie może nic zmienić w Twoim sklepie.
Ważne: od 1 stycznia 2026 Shopify nie pozwala już tworzyć „starych" aplikacji prywatnych w adminie sklepu (Ustawienia → Aplikacje → Develop apps). Jeśli masz taką aplikację z wcześniej wygenerowanym tokenem shpat_, ona nadal działa - zobacz sekcję na końcu. Nowe integracje robi się przez Dev Dashboard, jak niżej.
Czego potrzebujesz
- Konta z dostępem właściciela sklepu.
- Domeny sklepu w formacie
twoj-sklep.myshopify.com. Własna domena (np. mojsklep.pl) nie zadziała. Domenę znajdziesz w adresie panelu:admin.shopify.com/store/NAZWAoznacza domenęNAZWA.myshopify.com(albo sprawdź w Ustawienia → Domeny).
Krok 1. Wejdź do Dev Dashboard
Otwórz dev.shopify.com/dashboard i zaloguj się tym samym kontem, którym zarządzasz sklepem (możesz też wejść z panelu sklepu: kliknij nazwę sklepu → Dev Dashboard). Przy pierwszym wejściu Shopify może poprosić o utworzenie organizacji deweloperskiej - przejdź przez kreator.
Krok 2. Utwórz aplikację
W sekcji Apps kliknij Create app (prawy górny róg), wybierz Start from Dev Dashboard (bez CLI), nadaj nazwę (np. „SeeProfit") i kliknij Create.
Krok 3. Skonfiguruj wersję i uprawnienia
Aplikacja musi mieć wydaną wersję, żeby dało się ją zainstalować. W zakładce Versions:
- App URL: jeśli aplikacja nie ma własnego panelu (nasza nie potrzebuje), wpisz domyślny adres
https://shopify.dev/apps/default-app-home, - Webhooks API version: wybierz najnowszą,
- Scopes - zaznacz uprawnienia tylko do odczytu:
| Uprawnienie | Po co | Czy wymagane |
|---|---|---|
read_orders | Odczyt zamówień (przychody) | Tak - bez tego odrzucimy dane dostępowe |
read_all_orders | Historia starsza niż 60 dni | Mocno zalecane - synchronizujemy do 365 dni wstecz |
read_shopify_payments_payouts | Prowizje Shopify Payments | Opcjonalne |
Na koniec kliknij Release, żeby wydać wersję.
Ważne: bez read_all_orders API Shopify zwraca tylko zamówienia z ostatnich 60 dni. Uprawnienie read_shopify_payments_payouts ma sens tylko, gdy sklep używa Shopify Payments - przy zewnętrznej bramce (PayU, Przelewy24, Stripe) prowizji z tego źródła po prostu nie ma i zobaczysz same przychody.
Krok 4. Zainstaluj aplikację na sklepie
W aplikacji przejdź do zakładki Home, przewiń w dół i kliknij Install app. Wybierz swój sklep z listy i potwierdź przyciskiem Install. Bez instalacji dane dostępowe nie zadziałają.
Krok 5. Skopiuj Client ID i Client secret
W aplikacji wejdź w Settings i skopiuj Client ID oraz Client secret.
W przeciwieństwie do starych aplikacji nie kopiujesz tu stałego tokenu - token dostępu jest ważny 24 godziny, a SeeProfit odnawia go automatycznie. Ty podajesz tylko Client ID i Client secret raz.
Krok 6. Wklej dane w SeeProfit
Wróć do SeeProfit: Integracje → Shopify, zostaw zaznaczoną opcję „Aplikacja z Dev Dashboard", wpisz domenę twoj-sklep.myshopify.com, wklej Client ID i Client secret, po czym kliknij Podłącz Shopify. Od razu sprawdzimy dostęp i uruchomimy pierwszą synchronizację - kolejne dzieją się automatycznie, gdy korzystasz z panelu.
Co dokładnie zaciągamy
- Przychody: kwota każdego opłaconego zamówienia, z datą realizacji płatności. Zamówienia testowe pomijamy automatycznie.
- Prowizje: opłaty Shopify Payments (jeśli sklep ich używa i aplikacja ma odpowiednie uprawnienie).
Client ID i Client secret przechowujemy zaszyfrowane i nigdy nie wyświetlamy ich ponownie. Nie pobieramy danych osobowych klientów - tylko kwoty, waluty i daty zamówień.
Masz starszą aplikację z tokenem shpat_?
Aplikacje prywatne utworzone w adminie sklepu przed 2026 działają bez zmian. W formularzu w SeeProfit przełącz się na opcję „Starsza aplikacja (token shpat_)" i wklej swój token. Pamiętaj tylko, że nowej takiej aplikacji już nie utworzysz - gdy kiedyś usuniesz starą, wróć do tego poradnika.
Najczęstsze problemy
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| „Nieprawidłowa domena sklepu" | Wpisana własna domena - użyj adresu *.myshopify.com |
| „Shopify odrzucił..." przy podłączaniu | Zły Client ID/secret, aplikacja niezainstalowana na sklepie (krok 4) albo sklep należy do innej organizacji niż aplikacja |
| Błąd o „protected customer data" / „not approved to access the Order object" | W ustawieniach aplikacji w Dev Dashboard znajdź sekcję API access → Protected customer data access, zaznacz dostęp do danych zamówień (powód: funkcjonalność aplikacji) i zapisz - dla aplikacji na własnym sklepie nie wymaga to recenzji Shopify |
| Widzę tylko ~2 miesiące historii | Brak uprawnienia read_all_orders - dodaj je w nowej wersji aplikacji i wydaj ją ponownie (Release) |
| Brak prowizji | Sklep nie używa Shopify Payments albo brak uprawnienia read_shopify_payments_payouts |