Połącz Shopify

Uwaga: angielskie nazwy pogrubione w tekście wskazują odpowiednie przyciski i menu. Mogą być przetłumaczone zależnie od wybranego języka.

Połączenie Shopify importuje zamówienia, zwroty pieniędzy, płatności i dane realizacji. Obsługiwane ruchy magazynowe mogą pojawiać się też w przesunięciach wewnętrznych.

Zanim zaczniesz

Potrzebujesz dostępu do panelu Shopify sklepu oraz uprawnień do tworzenia i instalowania aplikacji. Jeśli nie widzisz tych opcji, poproś właściciela sklepu o pomoc.

Aplikację należy utworzyć w tej samej organizacji Shopify co sklep. Jeśli konfigurację wykonuje agencja, powinna użyć organizacji właściciela sklepu. Sam dostęp z konta agencji nie spełnia tego wymagania.

W Shopify otwórz Settings → Domains i skopiuj dokładną domenę *.myshopify.com, np. example.myshopify.com, łącznie z przedrostkami i cyframi.

Utwórz i zainstaluj aplikację Shopify

Jeśli masz już odpowiednią aplikację, otwórz ją i sprawdź uprawnienia oraz instalację.

1. Otwórz Shopify Dev Dashboard i wybierz organizację, do której należy sklep.
2. Wybierz Apps → Create app → Start from Dev Dashboard. Nadaj rozpoznawalną nazwę, np. „Połączenie Balta Labs”, i wybierz Create.
3. W Versions ustaw uprawnienia dostępu, czyli Scopes: read_orders dla zamówień i read_locations dla lokalizacji. Dodaj read_all_orders, jeśli potrzebujesz zamówień starszych niż 60 dni. Jeśli Shopify wymaga App URL, możesz użyć domyślnego adresu https://shopify.dev/apps/default-app-home.
4. Wybierz Release, aby udostępnić konfigurację do instalacji.
5. Otwórz podsumowanie aplikacji i wybierz Install app w sekcji Installs. Wybierz właściwy sklep, sprawdź żądane uprawnienia i potwierdź Install w Shopify. Samo utworzenie aplikacji nie łączy jej ze sklepem.
6. W tej samej aplikacji otwórz Settings → Credentials i skopiuj Client ID oraz Client secret. Zachowaj secret w poufności.

Do importowania przesunięć magazynowych dodaj też read_inventory, read_inventory_transfers i read_inventory_shipments. Są to osobne uprawnienia, których podstawowy test połączenia nie sprawdza. Po ich zmianie opublikuj nową wersję i zatwierdź nowy dostęp w sklepie, gdy Shopify o to poprosi.

Instrukcja konfiguracji aplikacji Shopify opisuje poszczególne ekrany.

Dodaj sklep w Balta Labs

1. Otwórz Settings → Connections → Add account → Shopify.
2. Wpisz opcjonalną nazwę Connection name, dokładną Shop domain oraz Client ID i Client secret zainstalowanej aplikacji.
3. Wybierz Save credentials, a następnie Test na karcie połączenia.
4. Po udanym teście otwórz Explore, aby sprawdzić przyznane uprawnienia. Przy imporcie historii sprawdź dostęp do starszych zamówień.
5. Wybierz Start import. Jeśli widzisz Test & start import, połączenie zostanie sprawdzone przed rozpoczęciem. Postęp pojawi się pod połączeniem.

Każdy sklep dodaj osobno. Zapisanie danych nie oznacza jeszcze sprawdzenia połączenia: Connected pojawia się po udanym teście.

Typowe problemy

Shopify informuje, że aplikacja nie jest zainstalowana

W Dev Dashboard otwórz aplikację, z której pochodzą wpisane dane. Zainstaluj ją w sklepie odpowiadającym zapisanej domenie i sprawdź, czy znajduje się na liście zainstalowanych aplikacji sklepu. Instalacja w innym sklepie nie wystarczy. Wróć do Balta Labs i ponownie wybierz Test.

Shopify odrzuca dane dostępowe

Obie wartości muszą pochodzić z Settings → Credentials tej samej zainstalowanej aplikacji. Token dostępu Admin API ani token Storefront nie zastępuje Client secret. Popraw wartości przez Manage, zapisz i ponów test. Pozostaw puste pole danych dostępowych, aby zachować jego zapisaną wartość.

Nie można znaleźć lub wybrać sklepu

Skopiuj domenę z Settings → Domains w Shopify; nie zgaduj jej na podstawie nazwy sklepu ani nie wpisuj adresu publicznej strony. Jeśli sklepu nie ma na liście instalacji, sprawdź wybraną organizację i poproś właściciela o potwierdzenie dostępu. Wymagania połączenia Shopify wyjaśniają ograniczenie dotyczące organizacji.

Test działa, ale brakuje zamówień lub przesunięć

Udany test potwierdza, że sklep jest dostępny przy użyciu podanych danych. W Explore sprawdź uprawnienia do potrzebnych danych. Starsze zamówienia wymagają read_all_orders razem z read_orders; przesunięcia wymagają dodatkowych uprawnień magazynowych wymienionych powyżej. Opublikuj zmiany, zatwierdź je w Shopify, a następnie ponów test i import. Przewodnik Shopify po uprawnieniach wyjaśnia ewentualne dodatkowe zatwierdzenia.

Połączenie nie działa, a import jest wyłączony

Test i Manage pozostają dostępne. Popraw instalację lub ustawienia i ponów test. Po udanym teście import i ponowienie stają się dostępne. Jeśli ta sama konfiguracja działała wcześniej, odczekaj chwilę i ponów Test: Shopify może być chwilowo niedostępny.