Shopify: dostęp Admin API i synchronizacja sklepu

Do czego to służy

Konektor Shopify pobiera zamówienia z Twojego sklepu, wysyła stany (i opcjonalnie ceny), pozwala zmapować produkty i przekazuje numery przesyłek jako realizację zamówienia. Korzysta z Admin API w technice GraphQL. Domyślna wersja API to 2026-10 i można ją zmienić ustawieniem kanału „apiVersion”.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Shopify”, a w kanale zakładka „Połączenie”. Pola: „Domena sklepu Shopify”, „Token dostępu Admin API”, „Client ID (aplikacja z Dev Dashboard)”, „Client secret (aplikacja z Dev Dashboard)” i „ID lokalizacji magazynowej (opcjonalnie)”.

Skąd wziąć klucze

1. W panelu Shopify wejdź w Ustawienia, Aplikacje i kanały sprzedaży, „Opracuj aplikacje”.
2. Utwórz aplikację niestandardową. Od 1 stycznia 2026 nowe aplikacje niestandardowe tworzy się w Dev Dashboard (dev.shopify.com), a po instalacji w sklepie podaje się Client ID i Client secret zamiast tokenu. Aplikacja musi należeć do tej samej organizacji co sklep.
3. W konfiguracji Admin API nadaj zakresy: read_orders, read_products, write_products (ceny), read_inventory, write_inventory, read_locations, read_merchant_managed_fulfillment_orders i write_merchant_managed_fulfillment_orders (numery przesyłek).
4. Zamówienia starsze niż 60 dni wymagają dodatkowo zakresu read_all_orders, który Shopify przyznaje na wniosek.
5. Zainstaluj aplikację w sklepie i skopiuj token Admin API (zaczyna się od shpat_, pokazywany tylko raz) albo Client ID i Client secret.
6. W Zaksio wpisz domenę sklepu w postaci nazwa.myshopify.com i dane dostępowe, kliknij „Zapisz poświadczenia”, a potem „Sprawdź połączenie”.

Nazwy menu i sposób tworzenia aplikacji Shopify zmieniają się dość często, dlatego sprawdź aktualną instrukcję na shopify.dev (sekcja o uwierzytelnianiu i grancie „client credentials”).

Wymagania i ważne uwagi

• Domena musi mieć postać nazwa.myshopify.com. Własna domena sklepu nie jest przyjmowana.
• Podajesz albo token Admin API, albo parę Client ID i Client secret. Przy parze Zaksio samo pobiera token (ważny 24 godziny) i odnawia go w razie potrzeby.
• Dane kupujących (e-mail, telefon, adresy) wymagają zgody na dostęp do danych chronionych klientów dla aplikacji. Bez niej Shopify nie zwróci tych pól. Zasady są po stronie Shopify, a dane osobowe traktuj zgodnie z regułami ochrony danych w Twojej firmie.
• „ID lokalizacji magazynowej”: lokalizacja, w której ustawiamy stany. Puste oznacza pierwszą aktywną lokalizację sklepu.

Co synchronizuje

• Zamówienia: z filtrowaniem po czasie zmiany. Zamówienia testowe są pomijane, a pozycje bez wariantu trafiają do mapowania po SKU lub nazwie.
• Oferty: warianty produktów.
• Stany: ilość sprzedawalna ustawiana w jednej lokalizacji.
• Ceny: tylko po włączeniu ustawienia kanału „syncPrices”, w sklepach z cenami zawierającymi podatek, w walucie sklepu.
• Numer przesyłki: tworzy realizację zamówienia z numerem śledzenia.

Czego jeszcze nie ma

• Zwrotów z Shopify: rejestruj je w Zaksio ręcznie.
• Przepływu OAuth dla aplikacji z innej organizacji niż sklep.
• Zapamiętywania tokenu po restarcie serwera: jest trzymany w pamięci procesu i pobierany od nowa.
• Weryfikacji na żywym sklepie. Niepewne są m.in. składnia filtra czasu, kształt odpowiedzi przy przekroczeniu limitu, nazwy przewoźników i wykrywanie paczkomatów.