↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak przenieść katalog ze strony do Elbuz: Elbuz Tunnel dla CMS

    Jak zaimportować katalog z Shopify: adres sklepu albo dostęp do Admin API

    31 min czytaniaZaktualizowano

    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:

    DrogaCo zrobić
    Aplikacja Elbuzzainstaluj aplikację w sklepie i wpisz kod powiązania w karcie „Aplikacja z marketplace”
    Bezpośredni dostęp do APIutwó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.
    Tryb jest wybierany dwa razy: osobno dla produktów i osobno dla zamówień. Bez dostępu do API produkty przyjdą w trybie szybkim, a zamówienia — nie, w dzienniku będzie tylko czerwony wiersz
    taktaknienietaktaknienieUruchomienie szablonu ShopifyZaznaczono „Produkty”?Jest dostęp do API — aplikacjaElbuz,Client ID i secret albo token?Tryb pełny25 produktów na stronę, wszystkiestanyTryb szybki250 produktów na stronę, tylkoopublikowaneZaznaczono „Zamówienia”?Jest dostęp do API — aplikacjaElbuz,Client ID i secret albo token?Zamówienia50 na stronęCzerwony wiersz w dziennikubez klucza API niedostępnyKoniec przebiegu
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Czym różni się tryb szybki bez klucza

    Lista publiczna oddaje mniej danych niż Admin API:

    CoPrzez APIBez klucza
    Zawartość kataloguwszystkie produkty, także wersje robocze i ukrytetylko opublikowane
    Standokładna ilośćtylko „jest / nie ma”
    Kod kreskowy ()przenoszonyniedostępny
    Kategoriakolekcja produktutyp produktu
    Zamówieniataknie

    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.

    GdzieCo zrobić
    Shopify Dev DashboardOtwórz dev.shopify.com z konta właściciela sklepu → „Create app”. Aplikacja musi należeć do tej samej organizacji co sklep
    TamżeW 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żeZainstaluj aplikację w swoim sklepie
    TamżeW ustawieniach aplikacji skopiuj Client ID i Client secret
    ElbuzOkno 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 ShopifyPole karty w Elbuz
    titleNazwa produktu (dla wariantu — „Nazwa — Wariant”)
    descriptionHtmlPełny opis
    vendorProducent
    sku wariantuSKU
    barcode wariantuKod kreskowy (EAN)
    price wariantuCena
    compareAtPriceStara cena — jeśli jest wyższa od bieżącej
    inventoryQuantityStan (dostępność)
    status ACTIVEAktywność karty (wersja robocza przychodzi wyłączona)
    tagsTagi produktu
    pierwsza kolekcja (collections)Kategoria
    selectedOptions (Size, Color…)Opcje wariantu
    zdjęcie wariantu + media produktuZdjęcia — gdy zaznaczono „Zdjęcia”
    identyfikatory produktu i wariantuKlucze 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 vendor nie 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ść.

    Przełączniki ochrony podczas importu w karcie produktu
    1Nie aktualizuj
    2Stała cena
    1. „Nie aktualizuj” — import całkowicie pomija ten produkt.
    2. „Stała cena” — import nie zmienia ceny tego produktu.
    Co przebieg robi z jedną kartą. Nowa karta dostaje wszystko, zdjęcia — jeśli zaznaczono „Zdjęcia”. W istniejącej dwie prawe gałęzie to Twoje zabezpieczenia: „Nie aktualizuj” zatrzymuje wszystko, pusta wartość i „Stała cena” chronią poszczególne pola
    nietaktaknietaknietaknieProdukt lub wariant z ShopifyKarta znaleziona?Nowa karta z kategorią ipowiązaniemzdjęcia — jeśli zaznaczono „Zdjęcia”Włączono „Nie aktualizuj”?Karta się nie zmieniaIlość i aktywnośćzawsze z ShopifyWartość z Shopify pusta lub zero?Zostaje Twoja wartośćTo cena i włączono „Stała cena”?Pole jest nadpisywane z Shopify
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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 ShopifyCo będzie z kartą w Elbuz
    Produkt usuniętoZostaje 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.

    Dwa filtry na wejściu — pole wyboru z plakietką i podpis. Po przejściu obu decyduje rodzaj zdarzenia: nowe zamówienie zakłada dokument, zmiana aktualizuje już założony
    nietaktaknietaknietaknieShopify wysyła zamówienieZaznaczono „Używaj webhooków”i szablon „Aktywny”?Powiadomienie odrzucone bezkomunikatuWypełniono Client secret?Podpis się zgadza?Zamówienie nie zostaje przyjęteZdarzenie — zmiana zamówienia?Aktualizuje istniejący dokumentjeśli go nie ma — zakłada nowyZakłada tylko nowy dokument
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    Zatwierdzony dokument to punkt końcowy: po zatwierdzeniu żadna gałąź go nie zmienia. W niezatwierdzonym platforma nadpisuje płatność i dostawę, a Twój status — tylko gdy zmienił się status w Shopify
    nietaknietaktaknietaknieZamówienie z ShopifyDokument z tym zamówieniem jużistnieje?Nowy dokument „Zamówienieklienta”niezatwierdzonyTo aktualizacja — webhook zmianyalbo dociągnięcie od daty?Dokument się nie zmieniaDokument zatwierdzony?Płatność, dostawa i sposoby — zShopifyStatus w Shopify zmienił się odpoprzedniego razui ma dopasowanie?Twój status — według dopasowaniaTwój status zostaje
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    Przyciski powiązanych ustawień i rozwinięta sekcja „Zaawansowane” z polami początku importu zamówień
    1Statusy zamówienia
    2Statusy płatności
    3Import zamówień począwszy od daty (RRRR-MM-DD)
    1. „Statusy zamówienia” — dopasowuje statusy zamówień Shopify do statusów w programie.
    2. „Statusy płatności” — dopasowuje statusy płatności Shopify do statusów w programie.
    3. „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.

    CoStronaDodatkowo
    Tryb pełny25 produktów, pauza 1 sdo 100 wariantów, 20 zdjęć i 3 kolekcji na produkt; odpowiedź do 120 s
    Tryb szybki250 produktów, pauza 1 snie więcej niż 2 000 stron (do 500 tys. pozycji); odpowiedź do 60 s
    Zamówienia50 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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
    Karta „Połączenie” szablonu Shopify: cztery pola i przycisk „Sprawdź połączenie”
    1Domena sklepu
    2Client ID
    3Client secret
    4Admin API access token
    5Sprawdź połączenie
    1. Domena sklepu — adres sklepu w postaci mystore.myshopify.com.
    2. Client ID — identyfikator własnej aplikacji z Dev Dashboard.
    3. Client secret — sekret aplikacji; służy też do weryfikacji podpisu webhooków.
    4. Admin API access token — droga zapasowa: gotowy token, jeśli sklep już go ma.
    5. Sprawdź połączenie — sprawdza dostęp do sklepu.

    Jak ogólnie działają szablony importu — przegląd importu danych.

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo