Shopify API i webhooki - kiedy własna integracja zamiast gotowej aplikacji ze sklepu

Kiedy własna integracja z Shopify API ma sens - typowe przypadki

Własna aplikacja nie jest celem samym w sobie. To narzędzie dla procesów, które wyróżniają firmę albo są zbyt specyficzne dla gotowych rozwiązań. Z naszego doświadczenia najczęściej chodzi o kilka scenariuszy:

• nietypowy system ERP lub magazynowy - bez aplikacji w Shopify App Store i bez obsługi przez integrator, z własnym API lub wymianą plików,

• własne reguły cen i dostępności - ceny liczone z kilku źródeł, rezerwacje stanów dla kanałów albo produkty składane na zamówienie,

• wymiana danych z producentem lub partnerem - przekazywanie zamówień do zewnętrznej produkcji i odbiór statusów realizacji,

• raporty i hurtownia danych - eksport zamówień i produktów do systemu analitycznego firmy,

• wiele sklepów Shopify - wspólny katalog lub stany dla kilku sklepów z różnymi rynkami.

W każdym z tych przypadków warto najpierw sprawdzić, czy połączenie gotowej aplikacji z niewielkim własnym modułem nie wystarczy. Często integrator obsługuje większość procesu, a własny kod uzupełnia tylko jeden brakujący krok. Taki model jest tańszy w utrzymaniu niż pełna integracja pisana od zera.

[#tip] Przed zamówieniem integracji spisz proces na jednej stronie: jakie zdarzenie go uruchamia, jakie dane przepływają, który system jest źródłem prawdy dla stanów, cen i statusów oraz co ma się stać, gdy drugi system nie odpowiada. Taki opis skraca wycenę i ujawnia, czy wystarczy gotowa aplikacja.

Webhooki Shopify - jak działają i co musi obsłużyć integracja

Webhook to najszybszy sposób, by system zewnętrzny dowiedział się o zmianie w sklepie. Subskrypcje webhooków definiuje się w konfiguracji aplikacji (plik shopify.app.toml) albo tworzy przez GraphQL Admin API. Opcje filter i include_fields pozwalają ograniczyć, które zdarzenia trafiają do aplikacji i jakie pola zawiera powiadomienie. Dokumentacja Shopify wymienia jednak kilka zasad, których nie wolno pominąć w projekcie:

• weryfikacja podpisu - każde powiadomienie ma nagłówek X-Shopify-Hmac-Sha256, a aplikacja powinna sprawdzić podpis HMAC, zanim użyje danych,

• duplikaty - to samo zdarzenie może przyjść więcej niż raz, więc identyfikator X-Shopify-Webhook-Id służy do pomijania powtórek,

• kolejność - Shopify nie gwarantuje kolejności powiadomień, dlatego zdarzenia porządkuje się po znaczniku czasu, np. X-Shopify-Triggered-At lub updated_at,

• czas odpowiedzi - aplikacja musi odpowiedzieć w ciągu 5 sekund, inaczej dostarczenie uznaje się za nieudane,

• ponowienia - nieudane dostarczenie Shopify ponawia do 8 razy w ciągu 4 godzin, a przy dalszych błędach usuwa subskrypcję.

Z tych zasad wynika praktyczny wzorzec: aplikacja przyjmuje powiadomienie, sprawdza podpis, zapisuje je w kolejce i od razu odpowiada, a właściwą pracę wykonuje w tle. Dokumentacja Shopify podkreśla też, że dostarczenie webhooka nie zawsze jest gwarantowane, i zaleca okresowe zadania uzgadniające, które pobierają zmienione dane przez API, np. filtrując po dacie aktualizacji. Bez nich jedna awaria serwera po stronie integracji oznacza zamówienia, które nigdy nie dotrą do ERP. Pełny przepływ obsługi powiadomienia wygląda tak:

[#chart:shf22b]

Podobne zasady obowiązują w innych platformach. Jeśli znasz webhooki z WordPressa, porównanie znajdziesz we wpisie webhooki w WooCommerce - automatyzacja procesów po zamówieniu - w Shopify wymagania co do szybkiej odpowiedzi i weryfikacji podpisu są jednak opisane bardziej rygorystycznie.

Limity Shopify API, które trzeba uwzględnić w projekcie

GraphQL Admin API nie liczy zapytań, tylko ich koszt w punktach. Każde zapytanie ma wyliczony koszt, a aplikacja dostaje dla danego sklepu pulę punktów, która odnawia się w stałym tempie zależnym od planu. Według dokumentacji pojedyncze zapytanie nie może kosztować więcej niż 1 000 punktów niezależnie od planu (stan na wrzesień 2026 - sprawdź aktualne limity w dokumentacji Shopify). Tempo odnawiania puli według planu pokazuje wykres:

[#chart:shf22c]

W praktyce oznacza to, że integracja aktualizująca tysiące produktów nie może wysyłać zapytań bez kontroli. Do pobierania dużych ilości danych dokumentacja zaleca operacje zbiorcze (bulk operations), które nie podlegają limitom kosztu pojedynczych zapytań. Drugim ograniczeniem są wersje API. Shopify wydaje nową wersję co kwartał, a każda stabilna wersja jest wspierana co najmniej 12 miesięcy. Gdy aplikacja odwołuje się do wersji wycofanej, Shopify obsługuje ją najstarszą dostępną wersją stabilną, co może zmienić działanie integracji bez ostrzeżenia.

Wersje mają też wpływ na nowe funkcje. W 2026 r. Shopify zmienił model kolekcji i zalecał aplikacjom korzystającym z kolekcji przejście na wersję API 2026-07, o czym piszemy we wpisie kolekcje w Shopify - automatyczne i ręczne. Własna integracja wymaga więc stałego budżetu na aktualizacje, nie tylko jednorazowego wdrożenia.

Uprawnienia i bezpieczeństwo własnej aplikacji Shopify

Aplikacja dostaje dostęp do sklepu w zakresie uprawnień (scopes), które zatwierdzasz przy instalacji. Zasada jest prosta: tylko tyle, ile potrzebuje proces. Integracja, która aktualizuje stany, nie potrzebuje dostępu do klientów, a raport sprzedaży nie musi zmieniać produktów. Dostęp do danych osobowych klientów podlega w Shopify dodatkowym zasadom ochrony danych i może zależeć od planu sklepu, dlatego sprawdź te wymagania w dokumentacji, zanim zaprojektujesz przepływ zamówień do ERP. Token dostępu przechowuj w bezpiecznym miejscu po stronie serwera, nigdy w kodzie motywu ani w arkuszu współdzielonym z zespołem.

Równie ważne jest to, kto zarządza aplikacją. Gdy integrację buduje zewnętrzny wykonawca, ustal na piśmie, w czyjej organizacji powstaje aplikacja, kto ma dostęp do kodu i jak przebiega przekazanie projektu przy zmianie wykonawcy. Kwestie umów i przetwarzania danych osobowych skonsultuj z prawnikiem. Przed wdrożeniem na sklep produkcyjny warto przetestować integrację na sklepie deweloperskim, co pomoc Shopify wskazuje jako jedną z zalet Dev Dashboard.

Jak zaplanować własną integrację z Shopify krok po kroku

Dobrze zaplanowana integracja ma mniej poprawek po starcie niż ta, która zaczyna się od pisania kodu. Kolejność, którą stosujemy w projektach, wygląda tak:

1. Opisz proces i zdarzenia, które go uruchamiają, oraz system nadrzędny dla każdego rodzaju danych.

2. Sprawdź, które części pokrywa gotowa aplikacja, integrator lub Shopify Flow.

3. Wybierz webhooki i zapytania GraphQL oraz minimalny zestaw uprawnień aplikacji.

4. Zaprojektuj kolejkę zdarzeń, ponowienia i zadanie uzgadniające dane.

5. Przetestuj integrację na sklepie deweloperskim, także scenariusze awarii drugiego systemu.

6. Uruchom monitoring błędów i zaplanuj przegląd wersji API co kwartał.

Ile kosztuje utrzymanie własnej integracji z Shopify?

Koszt własnej integracji to nie tylko napisanie kodu. Do budżetu trzeba doliczyć serwer lub usługę chmurową, monitoring błędów, kolejkę zdarzeń, kopie zapasowe danych pośrednich i czas programisty na aktualizacje wersji API. Gotowa aplikacja przenosi te obowiązki na producenta, w zamian za abonament i mniejszą elastyczność. Różnice zestawiamy w tabeli:

Między tymi skrajnościami jest Shopify Flow z akcją Send HTTP Request, która wysyła dane do zewnętrznego systemu bez pisania aplikacji. Pomoc Shopify podaje, że ta akcja działa tylko w planach Grow, Advanced i Plus, a Flow czeka na odpowiedź do 30 sekund (stan na wrzesień 2026 - sprawdź aktualne zasady). To dobre rozwiązanie dla prostych powiadomień, ale nie zastąpi integracji, która musi uzgadniać dane i obsługiwać błędy.

Jak Vinson pomaga z integracjami Shopify

W Vinson wdrażamy sklepy na Shopify i łączymy je z systemami, z których korzystają firmy. Jesteśmy agencją e-commerce z Bochni, działamy od 2021 r., współpracowaliśmy z ponad 500 firmami i jesteśmy certyfikowanym partnerem Base. Przy integracjach Shopify zwykle:

• spisujemy proces i sprawdzamy, czy pokryje go aplikacja, Base albo Shopify Flow,

• projektujemy przepływ danych i ustalamy system nadrzędny dla stanów, cen i statusów,

• budujemy brakujące moduły na GraphQL Admin API i webhookach,

• dodajemy weryfikację podpisów, kolejkę zdarzeń i zadania uzgadniające,

• pilnujemy aktualizacji wersji API i monitorujemy błędy po wdrożeniu.

Szczegóły współpracy znajdziesz na stronie sklep na Shopify z Vinson.

Najczęściej zadawane pytania

Czy Shopify ma API?

Tak. Podstawowym interfejsem jest GraphQL Admin API, przez który aplikacje pobierają i zmieniają produkty, stany, zamówienia i klientów. REST Admin API jest od października 2024 r. interfejsem przestarzałym, a nowe aplikacje publiczne od kwietnia 2025 r. muszą używać GraphQL.

Czym są webhooki w Shopify?

Webhooki to powiadomienia, które Shopify wysyła do innego systemu, gdy w sklepie zajdzie zdarzenie, np. powstanie zamówienie. Mogą trafiać na adres HTTPS, do Google Pub/Sub lub Amazon EventBridge. Integracja musi sprawdzić podpis, odpowiedzieć w ciągu 5 sekund i obsłużyć duplikaty.

Jak utworzyć własną aplikację w Shopify w 2026 roku?

Według changelogu Shopify od 1 stycznia 2026 r. nowych aplikacji niestandardowych nie tworzy się w panelu sklepu, tylko w Dev Dashboard. Potrzebna jest rola App developer. Aplikacje utworzone wcześniej w panelu nadal działają i można nimi zarządzać jako aplikacjami legacy.

Czy lepsza jest gotowa aplikacja czy własna integracja z Shopify?

Gotowa aplikacja lub integrator jest lepsza, gdy proces jest typowy, np. faktury, kurierzy czy marketplace'y. Własna integracja ma sens przy nietypowym ERP, specyficznych regułach cen lub wymianie danych z partnerem. Trzeba wtedy zaplanować budżet na utrzymanie i aktualizacje wersji API.

Czy Shopify Flow zastąpi integrację przez API?

Tylko w prostych przypadkach. Akcja Send HTTP Request wysyła dane do innego systemu, ale działa w planach Grow, Advanced i Plus i nie uzgadnia danych między systemami. Do pełnej synchronizacji zamówień czy stanów potrzebna jest aplikacja lub integrator.

Shopify API i webhooki dają dużą swobodę, ale własna integracja to zobowiązanie na lata, a nie jednorazowy projekt. Jeśli zastanawiasz się, czy Twój proces wymaga kodu, czy wystarczy aplikacja lub Base, sprawdź sklep na Shopify z Vinson - zaczniemy od mapy przepływu danych w Twoim sklepie.