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/NAZWA oznacza 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:
UprawnieniePo coCzy wymagane
read_ordersOdczyt zamówień (przychody)Tak - bez tego odrzucimy dane dostępowe
read_all_ordersHistoria starsza niż 60 dniMocno zalecane - synchronizujemy do 365 dni wstecz
read_shopify_payments_payoutsProwizje Shopify PaymentsOpcjonalne

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

ObjawPrzyczyna i rozwiązanie
„Nieprawidłowa domena sklepu"Wpisana własna domena - użyj adresu *.myshopify.com
„Shopify odrzucił..." przy podłączaniuZł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 historiiBrak uprawnienia read_all_orders - dodaj je w nowej wersji aplikacji i wydaj ją ponownie (Release)
Brak prowizjiSklep nie używa Shopify Payments albo brak uprawnienia read_shopify_payments_payouts

← Wszystkie poradniki