Integracja Elbuz z Shopify pobiera katalog i zamówienia sklepu przez API, bez plików, i trzyma produkty w katalogu bazowym obok innych kanałów sprzedaży.
Kiedy to się przyda:
- Chcesz szybko obejrzeć katalog w Elbuz — wystarczy adres sklepu, klucz nie jest potrzebny.
- Shopify to tylko jeden z Twoich kanałów — produkt edytujesz w Elbuz, a ceny i stany wracają eksportem do sklepu.
- Katalog i stany mają nadążać za sklepem — szablon w harmonogramie sam aktualizuje ceny, ilości i aktywność.
- Zamówienia trzeba widzieć od razu — webhook zakłada dokument w chwili, gdy klient złożył zamówienie.
Od czego zacząć: wpisz adres sklepu, a dla trybu pełnego — otwórz dostęp do API.
Co potrafi połączenie z Shopify
- Działa w dwóch trybach — bez klucza, po adresie sklepu, albo w pełni przez Admin .
- Przenosi produkt do karty — nazwę, opis, producenta, SKU, kod kreskowy, cenę, starą cenę, stan, tagi, kategorię i zdjęcia.
- Rozkłada warianty — każdy rozmiar czy kolor staje się osobną kartą, a wszystkie łączą się w rodzinę.
- Przenosi stan produktu — wersje robocze i zarchiwizowane produkty przychodzą wyłączone.
- Pobiera zamówienia według harmonogramu lub przez webhook i zakłada je jako dokument „Zamówienie klienta”.
- Aktualizuje się według harmonogramu i zapisuje w dzienniku, ile produktów i zamówień odczytano.
Czego potrzeba od Shopify: adres sklepu albo dostęp do API
Do trybu szybkiego wystarczy adres sklepu. Tryb pełny (cały katalog i zamówienia) wymaga dostępu do Admin API — daje go jedna z dwóch dróg:
| Droga | Co zrobić |
|---|---|
| Aplikacja Elbuz | zainstaluj aplikację w sklepie i wpisz kod powiązania w karcie „Aplikacja z marketplace” |
| Bezpośredni dostęp do API | utwórz własną aplikację w Dev Dashboard Shopify i wpisz jej Client ID i Client secret w karcie „Połączenie” (skąd wziąć klucze) |
Karta „Połączenie” ma cztery pola:
- Domena sklepu — adres Twojego sklepu, np.
mystore.myshopify.com; można podać też własną domenę sklepu. Do trybu szybkiego wystarczy samo to pole. - Client ID — identyfikator własnej aplikacji z Dev Dashboard.
- Client secret — sekret tej samej aplikacji. Na podstawie Client ID i Client secret Elbuz sam uzyskuje token dostępu i go odświeża. Tym samym sekretem weryfikowany jest podpis webhooków.
- Admin API access token — gotowy token, jeśli sklep już go ma (np. z aplikacji utworzonej wcześniej w panelu administracyjnym Shopify). Wtedy Client ID nie jest potrzebny.
Wypełniono i Client ID z Client secret, i token — Elbuz używa Client ID i Client secret.
Dwa tryby: bez klucza i przez API
Przełącznika trybów nie ma — Elbuz wybiera sam: jest dostęp do API — tryb pełny, nie ma — szybki. Dostęp daje aplikacja Elbuz, Client ID i Client secret albo gotowy token.
- Tryb szybki bez klucza — podajesz tylko adres sklepu, a Elbuz czyta katalog z publicznej listy produktów, którą Shopify udostępnia wszystkim (to właśnie
products.json). Widać tylko opublikowane produkty; zamówienia i dokładne stany są niedostępne. Nadaje się na pierwsze rozpoznanie lub jednorazowy import. - Tryb pełny przez API — sklep jest połączony aplikacją Elbuz albo kluczami własnej aplikacji. Elbuz widzi cały katalog i może pobierać zamówienia. Do stałej pracy potrzebny jest właśnie ten tryb.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Czym różni się tryb szybki bez klucza
Lista publiczna oddaje mniej danych niż Admin API:
| Co | Przez API | Bez klucza |
|---|---|---|
| Zawartość katalogu | wszystkie produkty, także wersje robocze i ukryte | tylko opublikowane |
| Stan | dokładna ilość | tylko „jest / nie ma” |
| Kod kreskowy () | przenoszony | niedostępny |
| Kategoria | kolekcja produktu | typ produktu |
| Zamówienia | tak | nie |
Jeśli zaznaczysz „Zamówienia”, ale nie ma dostępu do API, w dzienniku pojawi się komunikat, że import zamówień bez klucza API jest niedostępny. To ograniczenie samej listy publicznej, a nie błąd ustawień.
Skąd wziąć Client ID i Client secret: krok po kroku
W nowej aplikacji gotowego tokenu nie skopiujesz: od 1 stycznia 2026 roku Shopify go nie pokazuje. Dlatego Elbuz uzyskuje token sam — na podstawie Client ID i Client secret.
| Gdzie | Co zrobić |
|---|---|
| Shopify Dev Dashboard | Otwórz dev.shopify.com z konta właściciela sklepu → „Create app”. Aplikacja musi należeć do tej samej organizacji co sklep |
| Tamże | W wersji aplikacji nadaj uprawnienia dostępu (zakresy API): read_products, read_inventory, read_orders; dla zamówień starszych niż 60 dni — read_all_orders; do eksportu do Shopify — także write_products, write_inventory, read_locations. Wydaj wersję |
| Tamże | Zainstaluj aplikację w swoim sklepie |
| Tamże | W ustawieniach aplikacji skopiuj Client ID i Client secret |
| Elbuz | Okno importu → Twój szablon „Shopify” → karta „Połączenie” → pola „Client ID” i „Client secret” |
Tworzenie własnej aplikacji to procedura dla programisty, a Shopify co jakiś czas zmienia jej kolejność. Prościej użyć kodu powiązania: zainstaluj aplikację Elbuz i wpisz otrzymany kod w karcie „Aplikacja z marketplace”. Dostęp podstawi się sam, a pola Client ID, Client secret i tokenu zostaną puste.
Oficjalna pomoc Shopify: Instalacja i konfiguracja aplikacji, a dla programistów — uzyskanie tokenu na podstawie Client ID i Client secret (po angielsku).
Po wpisaniu kluczy kliknij „Sprawdź połączenie”: przycisk od razu powie, czy Shopify przyjmuje Twoje dane — jeszcze przed pierwszym pełnym importem.
Co trafia do karty
W karcie „Wybór danych do importu” zaznaczasz, co pobierać: Produkty (katalog do katalogu bazowego Elbuz), Zdjęcia i Zamówienia. Kategoria i producent przychodzą razem z produktem.
W trybie pełnym (przez API) każdy produkt Shopify trafia do pól karty Elbuz tak:
| Dane Shopify | Pole karty w Elbuz |
|---|---|
title | Nazwa produktu (dla wariantu — „Nazwa — Wariant”) |
descriptionHtml | Pełny opis |
vendor | Producent |
sku wariantu | SKU |
barcode wariantu | Kod kreskowy (EAN) |
price wariantu | Cena |
compareAtPrice | Stara cena — jeśli jest wyższa od bieżącej |
inventoryQuantity | Stan (dostępność) |
status ACTIVE | Aktywność karty (wersja robocza przychodzi wyłączona) |
tags | Tagi produktu |
pierwsza kolekcja (collections) | Kategoria |
selectedOptions (Size, Color…) | Opcje wariantu |
zdjęcie wariantu + media produktu | Zdjęcia — gdy zaznaczono „Zdjęcia” |
| identyfikatory produktu i wariantu | Klucze powiązania ze sklepem |
Warianty i cechy
Jeśli produkt ma kilka wariantów (rozmiary, kolory, wersje wyposażenia), każdy przychodzi osobną kartą z nazwą „Nazwa produktu — Wariant”, a wszystkie łączą się w jedną rodzinę według nazwy produktu nadrzędnego. Cena, stan, SKU i kod kreskowy należą do wariantu, więc każda karta dostaje własne liczby.
Do cech trafiają właśnie opcje wariantów (Size, Color itp.), a nie dowolne właściwości produktu: osobnego słownika cech Shopify nie ma.
Elbuz zapamiętuje identyfikatory produktu, wariantu i pozycji magazynowej: według nich idą zwrotne aktualizacje cen i stanów do sklepu.
Cena i stara cena
Cenę Shopify zapisuje w karcie bezpośrednio — z wariantu. Stara cena jest wypełniana z compareAtPrice i tylko wtedy, gdy jest wyższa od bieżącej. Jeśli w sklepie starej ceny nie ma, przebieg nie rusza tego pola w karcie: usunięto starą cenę w Shopify — w karcie Elbuz wyzeruj ją sam.
Ceny zakupu Shopify nie przekazuje. Reguły narzutu liczą od ceny zakupu, więc karty wypełnianej tylko z Shopify nie ruszają — cena w niej jest zawsze ze sklepu.
- Karta ma cenę zakupu (np. z cennika dostawcy) — na koniec importu Elbuz przeliczy cenę według reguł narzutu, ale tylko dla kart założonych w tym przebiegu. Istniejące karty zachowują cenę, którą właśnie zapisał Shopify.
- O cenę konkurują dwa źródła — wygrywa przebieg, który zakończył się ostatni. Rozdzielić je można flagami „Stała cena” lub „Nie aktualizuj” (ponowny przebieg).
Kategoria i producent
Kategoria pochodzi z pierwszej kolekcji produktu: w trybie pełnym program czyta do trzech kolekcji i bierze pierwszą, więc produkt z kilku kolekcji trafi do jednej kategorii. W trybie szybkim kolekcji nie widać, a kategorią staje się typ produktu (product type). Najpierw program szuka Twojej kategorii o takiej samej nazwie i dopiero potem tworzy nową.
Produkty bez kolekcji trafiają do kategorii technicznej „Produkty - shopify” — wyłączonej i bez udziału w eksportach. Rozkładaj je swobodnie po swoich kategoriach: ponowny przebieg nie zmienia miejsca produktu w drzewie. Jak zachowują się kategorie techniczne i marki — przegląd importu.
Producent — pole vendor. Nowa marka trafia do słownika producentów automatycznie. Nazwę marki zmieniaj po stronie Shopify: markę przemianowaną w Elbuz następny przebieg założy ponownie pod starą nazwą i przepnie do niej produkty.
Co robi ponowny przebieg z Twoimi poprawkami
Przebieg nadpisuje danymi ze sklepu: nazwę, pełny opis, cenę, starą cenę, ilość, dostępność, SKU, kod kreskowy, tagi, nazwę rodziny i aktywność karty. Poprawisz coś z tego w Elbuz — następna aktualizacja przywróci wartość z Shopify bez ostrzeżenia.
- Puste wartości nie kasują Twoich. Jeśli w Shopify pole jest puste, a cena lub stara cena zerowa, ręcznie wpisany kod kreskowy czy tagi zostaną. Ilość i aktywność są zapisywane tak, jak przyszły — nawet zero i „wyłączone”.
- W istniejącej karcie nie są ruszane: zdjęcia (dostają je tylko nowe karty), opcje wariantu, miejsce w drzewie kategorii, adres strony. Puste
vendornie odpina producenta.
Zablokować kartę można w samym produkcie: sekcja „Statusy i flagi”, blok „Ochrona podczas importu”. „Nie aktualizuj” — przebieg Shopify pomija kartę w całości, łącznie z aktywnością. „Stała cena” chroni tylko cenę i starą cenę. Więcej: jak zablokować swoją wartość.
1
Nie aktualizuj2
Stała cena- „Nie aktualizuj” — import całkowicie pomija ten produkt.
- „Stała cena” — import nie zmienia ceny tego produktu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Produkt jest rozpoznawany po nazwie zapamiętanej w chwili założenia karty. Zmieniono nazwę w Elbuz — przebieg znajdzie kartę i przywróci nazwę ze sklepu, duplikatu nie będzie. Zmieniono nazwę w Shopify — przebieg założy drugą kartę z nową nazwą, a stara zostanie ze starymi cenami i trzeba ją będzie usunąć ręcznie. SKU nie wpływa na rozpoznawanie: Shopify nie przekazuje kodu producenta.
Produkt zniknął z Shopify albo stał się wersją roboczą
Shopify oddaje nie tylko produkt, ale też jego stan, więc skutki są różne:
| Co stało się w Shopify | Co będzie z kartą w Elbuz |
|---|---|
| Produkt usunięto | Zostaje bez zmian: z ostatnią ceną i stanem, aktywna, bez wiersza w dzienniku. Usuń ją ręcznie — inaczej trafia do eksportu |
| Produkt przeniesiono do wersji roboczych lub archiwum (tryb pełny) | Przyjdzie wyłączona; cena i stan zaktualizują się jak zwykle. Włączona karta zostaje tylko w stanie Active |
| Produkt wycofano z publikacji (tryb szybki) | Dla Elbuz zniknął: karta zostaje aktywna ze starymi liczbami. Tryb szybki nigdy nie wyłącza kart |
Pola „usuwaj to, czego nie ma w źródle” w szablonie Shopify nie ma i żaden import z Shopify nie usuwa produktów. Ogólna reguła — produkt zniknął ze źródła.
Wyłączyć kartę czy usunąć
Wyłączona karta nie jest widoczna na witrynie, nie trafia do eksportu (nowy szablon eksportu bierze tylko aktywne produkty), a w eksporcie z powrotem do Shopify przyjdzie jako wersja robocza. Cena, stan, zdjęcia i powiązania zostają zachowane.
Ręczne wyłączanie produktu z Shopify prawie nie ma sensu: aktywność przychodzi ze sklepu przy każdym przebiegu, a produkt w stanie Active następna aktualizacja włączy z powrotem. Utrzymać kartę wyłączoną wbrew sklepowi można tylko flagą „Nie aktualizuj”. W trybie szybkim zdjęcie aktywności nie przetrwa żadnego przebiegu.
Usuniętą kartę następny przebieg założy od nowa — bez Twoich poprawek.
Jak przyjmować zamówienia z Shopify
To samo połączenie pobiera też zamówienia — tylko w trybie pełnym przez API. Są dwie drogi: odpytywanie według harmonogramu albo , gdy Shopify sam powiadamia Elbuz o nowym zamówieniu w tej samej chwili.
Webhook
Formularz ma kartę „Odbiór zamówień (Webhook)”: pole „Używaj webhooków” i webhooka. Subskrypcję po stronie Shopify Elbuz tworzy przyciskiem „Subskrybuj webhooki Shopify” — ręcznie niczego wklejać nie trzeba. Webhook jest przyjmowany pod trzema warunkami:
- w szablonie zaznaczono „Używaj webhooków”;
- szablon jest w stanie „Aktywny” — po wyłączeniu plakietki w nagłówku karty Elbuz bez komunikatu odrzuca powiadomienia;
- jeśli wypełniono Client secret, podpis powiadomienia się zgadza — inaczej zamówienie nie zostaje przyjęte.
Sklepu połączonego kodem powiązania przez aplikację Elbuz nie trzeba subskrybować: subskrypcja powstała podczas instalacji.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jakim dokumentem trafia zamówienie
Każde zamówienie jest zakładane jako dokument „Zamówienie klienta”, niezatwierdzony: stan i rezerwacja się nie zmieniają, dopóki nie zatwierdzisz dokumentu.
- Numer — jak w Shopify (
#1001); zamówienie jest rozpoznawane po wewnętrznym identyfikatorze sklepu, więc ponowny import nie tworzy duplikatu. - Klient jest wyszukiwany wśród Twoich kontrahentów po e-mailu i telefonie; jeśli się nie znajdzie, zakładany jest nowy.
- Statusy przychodzą dwoma polami: stan realizacji (UNFULFILLED, FULFILLED) i stan płatności (PAID, PENDING, REFUNDED). Twoje statusy są podstawiane według dopasowania przyciskami „Statusy zamówienia”, „Statusy dostawy” i „Statusy płatności” w sekcji „Powiązane ustawienia”. Niedopasowany status — pierwszy status słownika. Dopasowanie jest jedno dla webhooka i harmonogramu.
Gdy zamówienie zmieniło się po imporcie: zatwierdzonego dokumentu program już nie rusza. W niezatwierdzonym następna aktualizacja nadpisze płatność, dostawę i sposoby, a Twój status roboczy zmieni tylko wtedy, gdy status zmienił się w samym Shopify. Ogólny mechanizm — dwa statusy jednego zamówienia.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Pierwszy import pobiera całą historię zamówień, którą oddaje sklep. Dalej program dociąga tylko zmiany od daty ostatniego zamówienia — jest ona w bloku „Zaawansowane”, w polu „Import zamówień począwszy od daty (RRRR-MM-DD)”. Wyczyszczono pole — następny przebieg przejdzie całą historię. Zamówienia starsze niż 60 dni Shopify oddaje tylko aplikacji z uprawnieniem read_all_orders.
1
Statusy zamówienia2
Statusy płatności3
Import zamówień począwszy od daty (RRRR-MM-DD)- „Statusy zamówienia” — dopasowuje statusy zamówień Shopify do statusów w programie.
- „Statusy płatności” — dopasowuje statusy płatności Shopify do statusów w programie.
- „Import zamówień począwszy od daty” — data początkowa pobierania zamówień; pole obok ustawia początkowy identyfikator.
Aktualizacja według harmonogramu
Gdy połączenie jest sprawdzone, ustaw szablon w harmonogramie przyciskiem „Ustawienia harmonogramu” w formularzu: ceny i stany będą się aktualizować, a nowe produkty dochodzić. Eksport z powrotem do Shopify to osobny szablon w oknie „Eksport danych” z własnym harmonogramem (szablony eksportu).
Dziennik przebiegu pokazuje liczby dla każdej strony:
- „Shopify: strona katalogu 3, pobrano produktów: 75”;
- podsumowanie „Shopify: katalog zaimportowany, produktów (łącznie z wariantami): 240”;
- zamówienia osobno: „Shopify: strona zamówień 1, pobrano łącznie: 50”;
- błąd sklepu — czerwonym wierszem.
Nowe produkty widać w tabeli „Produkty” po kolumnie „Źródło: nazwa”, zaktualizowane — po „Data aktualizacji”. Ogólnie o dzienniku — jak sprawdzić, że import się udał.
Ile pobiera jeden przebieg
Limitu liczby produktów nie ma. Każdy wariant liczy się jako osobna pozycja: produkt w pięciu rozmiarach to pięć kart.
| Co | Strona | Dodatkowo |
|---|---|---|
| Tryb pełny | 25 produktów, pauza 1 s | do 100 wariantów, 20 zdjęć i 3 kolekcji na produkt; odpowiedź do 120 s |
| Tryb szybki | 250 produktów, pauza 1 s | nie więcej niż 2 000 stron (do 500 tys. pozycji); odpowiedź do 60 s |
| Zamówienia | 50 zamówień | do 100 wierszy w każdym |
Czas przebiegu dla Twojego katalogu widać w kolumnie „Czas trwania” i w „Historii uruchomień”.
Scenariusze
Obejrzeć katalog w Elbuz bez tworzenia aplikacji w Shopify
Co włączyć. W karcie „Połączenie” wypełnij tylko „Domena sklepu”, pola „Client ID”, „Client secret” i tokenu zostaw puste i nie podłączaj aplikacji Elbuz — z nią przebieg pójdzie w trybie pełnym. W „Wybór danych do importu” — „Produkty” i, jeśli potrzebne są obrazy, „Zdjęcia”.
Efekt. Do katalogu trafią opublikowane produkty — wszystkie aktywne, ze stanem 1 lub 0, a kategorią stanie się typ produktu. Wersji roboczych, kodów kreskowych i zamówień nie będzie (różnica trybów).
Utrzymywać katalog i stany w Elbuz zgodne z Shopify
Co włączyć. „Domena sklepu”, „Client ID” i „Client secret” (albo kod powiązania w karcie „Aplikacja z marketplace”), pola „Produkty” i „Zdjęcia”, a potem harmonogram przyciskiem „Ustawienia harmonogramu”.
Efekt. Każde uruchomienie czyta wszystkie produkty sklepu: wersje robocze i zarchiwizowane przychodzą wyłączone, reszta — aktywna, z dokładną ilością, kodem kreskowym i kategorią z pierwszej kolekcji. Produkty usunięte w Shopify zostają w Elbuz bez zmian (produkt zniknął), a zdjęcia istniejących kart się nie aktualizują.
Przyjmować zamówienia przez webhook
Co włączyć. Dostęp do API: Client ID i Client secret albo kod powiązania. Dalej — pole „Zamówienia” w karcie „Wybór danych do importu” i „Używaj webhooków” w karcie „Odbiór zamówień (Webhook)”, szablon w stanie „Aktywny”, a potem przycisk „Subskrybuj webhooki Shopify”. Client secret przy okazji weryfikuje podpis powiadomień. Swoje statusy dopasuj przyciskami „Statusy zamówienia”, „Statusy płatności” i „Statusy dostawy”.
Efekt. Nowe zamówienie od razu trafia jako niezatwierdzony dokument „Zamówienie klienta”; zmiana w Shopify aktualizuje w nim płatność i dostawę. Stan i rezerwacja zmienią się, gdy zatwierdzisz dokument.
Utrzymać swoją cenę na części produktów, resztę aktualizować ze sklepu
Co włączyć. W karcie produktu — sekcja „Statusy i flagi”, blok „Ochrona podczas importu”, przełącznik „Stała cena”.
Efekt. Cena i stara cena zostają Twoje: nie nadpisze ich ani przebieg Shopify, ani reguły narzutu. Pozostałe pola, w tym aktywność, nadal przychodzą ze sklepu; żeby karta nie zmieniała się wcale, włącz „Nie aktualizuj”.
Co zrobić, gdy Shopify się nie importuje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Shopify: podaj domenę sklepu oraz Client ID i Client secret własnej aplikacji…” | Pusta domena sklepu | Wypełnij pole domeny; dla zamówień i pełnego katalogu — także dostęp do API (czego potrzeba od Shopify) |
| „Shopify nie wydał tokenu dostępu dla Client ID i Client secret…” | Błąd w Client ID lub Client secret, aplikacja nie jest zainstalowana w sklepie albo należy do innej organizacji niż sklep (w nawiasie Shopify podaje shop_not_permitted) |
Skopiuj klucze jeszcze raz z ustawień aplikacji i zainstaluj ją w sklepie; aplikację twórz z konta właściciela sklepu (skąd wziąć klucze) |
| „Shopify: błąd API —” i tekst od sklepu | Shopify odrzucił zapytanie: token nieważny, aplikacja niezainstalowana w sklepie, brak uprawnień albo sklep chwilowo niedostępny | Kliknij „Sprawdź połączenie” — odpowiedź poda przyczynę bez pełnego przebiegu (skąd wziąć klucze) |
| Klucze wpisane, produkty przychodzą, a zamówienia — nie | Aplikacji brakuje uprawnienia read_orders; dla zamówień starszych niż 60 dni — read_all_orders |
Dodaj uprawnienie w wersji aplikacji, wydaj nową wersję, zatwierdź ją w sklepie i sprawdź połączenie (skąd wziąć klucze) |
| „Shopify: import zamówień bez klucza API jest niedostępny” | Zaznaczono „Zamówienia”, ale działa tryb szybki bez klucza | Wpisz Client ID i Client secret własnej aplikacji albo połącz sklep kodem przez aplikację Elbuz (różnica trybów) |
| „invalid JSON (not a Shopify storefront?)” | Pod podanym adresem nie ma publicznej listy produktów: zła domena, sklep jest chroniony hasłem albo nie działa na Shopify | Sprawdź adres sklepu; jeśli witryna jest chroniona hasłem, połącz się przez API (dwa tryby) |
| „Shopify: katalog zaimportowany”, ale produktów jest wyraźnie mniej niż w sklepie | Tryb szybki: błąd na dalszej stronie listy publicznej program odczytuje jako koniec katalogu — przed podsumowaniem w dzienniku stoi pomarańczowy wiersz „Shopify: błąd API — (page N)” | Przejdź na tryb pełny przez API i uruchom import jeszcze raz (przerwanie przebiegu) |
| Po imporcie stan zmienił się na 1 lub 0, a wyłączone produkty się włączyły | Tryb szybki przeszedł po katalogu zaimportowanym przez API (np. klucze usunięto z formularza) | Przywróć dostęp do API i uruchom import jeszcze raz (import w złym trybie) |
| W katalogu są dwa takie same produkty z różnymi nazwami | Nazwę produktu zmieniono w Shopify: przebieg nie rozpoznał starej karty i założył nową | Usuń starą kartę: po zmianie nazwy przebieg jej już nie aktualizuje, więc znajdziesz ją filtrem po starej „Dacie aktualizacji” (ponowny przebieg) |
| „Sklep połączony przez aplikację Elbuz — subskrypcja webhooków zamówień została skonfigurowana” | Kliknięto „Subskrybuj webhooki Shopify” w sklepie połączonym kodem powiązania | Nic nie trzeba robić: subskrypcja powstała przy instalacji aplikacji (webhook) |
Jeśli przebieg został przerwany
Produkty są zapisywane do katalogu partiami po 500 pozycji, więc po przerwaniu część katalogu jest już zaktualizowana, a reszta ma stare dane. Uruchom przebieg jeszcze raz: duplikatów nie będzie, a powtórka dokończy reguły narzutu i dane wyszukiwania dla nowych produktów. Ogólny mechanizm — jeśli przebieg został przerwany.
Odpowiedź „za dużo zapytań” tryb pełny przetrwa sam: do trzech prób z rosnącą pauzą.
W trybie szybkim błąd na pierwszej stronie zatrzymuje przebieg czerwonym wierszem. Natomiast błąd na dowolnej kolejnej stronie program uznaje za koniec katalogu: pomarańczowy wiersz „Shopify: błąd API — (page N)” i zwykłe podsumowanie „Shopify: katalog zaimportowany…” z mniejszym N.
Shopify odpowiada w obu przypadkach tak samo, więc nie da się ich odróżnić. Po trybie szybkim porównuj podsumowanie z liczbą produktów w sklepie, a przy dużym katalogu przejdź na tryb pełny.
Jeśli import poszedł w złym trybie
Tryb szybki po katalogu zaimportowanym przez API nadpisuje dokładne wartości uboższymi:
- stan się zaokrągli do 1 lub 0 — lista publiczna mówi tylko „można kupić / nie można”;
- wyłączone produkty się włączą — w trybie szybkim wszystkie odczytane produkty przychodzą aktywne;
- kody kreskowe przetrwają — pusta wartość nie kasuje wypełnionego pola.
Przywróć dostęp do API (klucze własnej aplikacji albo kod powiązania) i uruchom import jeszcze raz: tryb pełny przywróci ilość i aktywność, duplikatów nie będzie. Nie wróci tylko kategoria kart, które tryb szybki założył po raz pierwszy: brał ją z typu produktu, a miejsca w drzewie pełny przebieg nie zmienia.
Połączono nie ten sklep — produkty szablonu wybierzesz w „Produktach” po kolumnach „Źródło: nazwa” i „Źródło: kod” i usuniesz zbiorczo. Jak znaleźć nadpisane karty i czego nie da się przywrócić — jeśli zaimportowano nie to.
Najczęstsze pytania
Dlaczego nie przenoszą się cechy produktu?
Shopify nie ma osobnego słownika cech: wszystko, co opisuje pozycję, żyje w opcjach wariantu. Właśnie one są przenoszone (warianty i cechy). Pozostałe właściwości uzupełnij w swoim katalogu Elbuz.
Jak lepiej odbierać zamówienia — harmonogramem czy webhookiem?
Webhookiem szybciej: Shopify powiadamia Elbuz o nowym zamówieniu w tej samej chwili, a subskrypcję Elbuz tworzy przyciskiem w formularzu. Harmonogram też działa, ale z opóźnieniem do następnego uruchomienia (webhook).
Dlaczego w trybie szybkim nie widać wszystkich produktów?
Publiczna lista Shopify oddaje tylko opublikowane produkty — nie ma w niej wersji roboczych ani ukrytych pozycji. Żeby widzieć cały katalog, połącz się przez API (różnica trybów).
Dlaczego w Dev Dashboard nie widać Admin API access token?
Od 1 stycznia 2026 roku Shopify nie pokazuje stałego tokenu w nowych aplikacjach. Wpisz w szablonie Client ID i Client secret aplikacji — token dostępu Elbuz uzyska i będzie odświeżał sam (skąd wziąć klucze).
Co się stanie, jeśli zmienię nazwę produktu w Shopify?
Następny przebieg nie rozpozna starej karty — produkt jest wyszukiwany po nazwie — i założy drugą z nową nazwą. Starą usuń ręcznie. Zmiana nazwy w Elbuz jest bezpieczna: karta się znajdzie, tylko nazwa wróci ze sklepu.
Wyłączono „Aktywność” w karcie — czy następny przebieg ją włączy?
Tak, jeśli w Shopify produkt jest w stanie Active: aktywność przychodzi ze sklepu przy każdej aktualizacji. Utrzymać kartę wyłączoną można tylko przełącznikiem „Nie aktualizuj” (wyłączyć czy usunąć).
Czy stan się zmieni, gdy przyjdzie zamówienie z Shopify?
Nie. Zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta”, a niezatwierdzony dokument nie zmienia ani stanu, ani rezerwacji, dopóki go nie zatwierdzisz.
Czy można aktualizować ceny i stany w Shopify z Elbuz?
Tak, ale osobnym szablonem w oknie „Eksport danych” z typem bezpośredniego połączenia przez API i własnym harmonogramem. Sam import niczego z powrotem nie eksportuje (szablony eksportu).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Szablon
- nowy szablon → typ „Shopify”; jeden szablon — jeden sklep
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- adres sklepu; dla trybu pełnego — kod powiązania aplikacji Elbuz albo Client ID i Client secret własnej aplikacji
1
Domena sklepu2
Client ID3
Client secret4
Admin API access token5
Sprawdź połączenie- Domena sklepu — adres sklepu w postaci mystore.myshopify.com.
- Client ID — identyfikator własnej aplikacji z Dev Dashboard.
- Client secret — sekret aplikacji; służy też do weryfikacji podpisu webhooków.
- Admin API access token — droga zapasowa: gotowy token, jeśli sklep już go ma.
- Sprawdź połączenie — sprawdza dostęp do sklepu.
Jak ogólnie działają szablony importu — przegląd importu danych.
Powiązane tematy
- Jeśli chcesz zrozumieć, jak szablon importu działa z dowolnym źródłem — Import danych do katalogu.
- Jeśli łączysz przez API także inne platformy — Import katalogu przez API.
- Jeśli zamówienia z Shopify trzeba połączyć z innymi kanałami — Import zamówień z platform.
- Jeśli ceny i stany z Elbuz mają wracać do sklepu — Szablony eksportu.
