# Połączenie sklepu Shopify z RUIT

Samouczek łączenia Shopify: utwórz aplikację w Dev Dashboard, wklej osiem uprawnień, zainstaluj ją i skopiuj jej dwa klucze do RUIT.

_Updated: 2026-09-28 · Source: https://ruit.es/pl/docs/polaczenie-sklepu-shopify/_

W tym samouczku łączysz swój sklep Shopify z RUIT. Są dwie części: najpierw tworzysz aplikację
wewnątrz własnego sklepu, a potem wklejasz jej dwa klucze w RUIT. Zajmuje to **pięć minut** i robi
się **tylko raz**.

**Potrzebujesz** konta właściciela sklepu albo, jeśli należysz do zespołu, uprawnienia do tworzenia
aplikacji. Nadaje się każdy sklep, także deweloperski. RUIT w żadnym momencie nie prosi o twoje
hasło do Shopify: to ty ustalasz uprawnienia i możesz je cofnąć, kiedy zechcesz.

> **Ostrzeżenie:** Od 2026 roku nowe aplikacje **powstają wyłącznie w Dev Dashboard**. Jeśli wejdziesz w Ustawienia, a
> potem w Aplikacje i kanały sprzedaży, nie ma tam już formularza: jest tylko kafelek, który odsyła
> cię do Dev Dashboard. Aplikacje utworzone wcześniej w panelu nadal działają, a ich klucze są w ich
> zakładce z poświadczeniami.

## 1. Otwórz Dev Dashboard

Otwórz [przewodnik po Dev Dashboard Shopify](https://shopify.dev/docs/apps/build/dev-dashboard) i zaloguj się na `dev.shopify.com/dashboard` na tym samym koncie, z którego zarządzasz
sklepem. Zobaczysz listę aplikacji swojej organizacji, a w prawym górnym rogu `Create app`.

_Zrzut ekranu: Lista aplikacji w Dev Dashboard Shopify, z wyszukiwarką po nazwie i przyciskiem tworzenia aplikacji w prawym górnym rogu_

Lista aplikacji. Za pierwszym razem będzie pusta i zobaczysz polecenie terminala: zignoruj je, jest
dla osób, które programują aplikacje. Przycisk, którego szukasz, to `Create app`.

## 2. Utwórz aplikację i nadaj jej nazwę

Naciśnij `Create app`, wpisz nazwę, którą rozpoznasz, i potwierdź. Nazwa jest tylko dla ciebie.

_Zrzut ekranu: Ekran tworzenia aplikacji w Dev Dashboard, z polem nazwy i przyciskiem tworzenia_

Każda nazwa jest dobra. Na ilustracjach w tym przewodniku aplikacja nazywa się RUIT.

## 3. Wklej osiem uprawnień

Shopify zostawia cię na ekranie wersji. Znajdź sekcję `API access` i w polu `Scopes` wklej tę
listę bez zmian:

```
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publications
```

Jest też przycisk, który pozwala zaznaczać je pojedynczo na bardzo długiej liście, ale wklejenie
listy jest szybsze i niczego nie pominiesz. Pozostałe pola zostaw bez zmian.

_Zrzut ekranu: Pole `Scopes` w Dev Dashboard z ośmioma uprawnieniami wklejonymi jako lista rozdzielona przecinkami_

Osiem uprawnień wklejonych za jednym razem. Pod polem jest lista z polami wyboru, która robi to
samo, po jednym uprawnieniu.

| Uprawnienie                                | Obowiązkowe?    | Do czego                                                             |
| ------------------------------------------ | --------------- | -------------------------------------------------------------------- |
| `read_products` i `write_products`         | Tak             | Import, publikacja i edycja produktów                                |
| `read_inventory` i `write_inventory`       | Tak             | Synchronizacja stanów magazynowych                                   |
| `read_locations`                           | Tak             | Informacja, w którym magazynie zapisać ten stan                      |
| `read_orders`                              | Tak             | Natychmiastowa informacja o sprzedaży. Bez niego połączenie jest odrzucane |
| `read_publications` i `write_publications` | Bardzo zalecane | Żeby produkt było widać w sklepie, a nie tylko w panelu              |

> **Ostrzeżenie:** Pierwszych sześć jest sprawdzanych przy łączeniu, więc jeśli któregoś brakuje, dowiesz się od razu.
> **Dwóch uprawnień do publikacji nikt nie sprawdza** i na tym polega pułapka: połączenie się udaje,
> produkt powstaje, a w sklepie go nie ma, bo nikt nie opublikował go w kanale sprzedaży. Dodaj je
> teraz, a oszczędzisz sobie powrotu.

## 4. Opublikuj wersję

Naciśnij `Release` w prawym górnym rogu i potwierdź w oknie, które się otworzy. Nazwa i wiadomość,
o które prosi, są opcjonalne.

_Zrzut ekranu: Okno, które potwierdza publikację nowej wersji aplikacji, z opcjonalnymi polami nazwy i wiadomości_

O tym kroku zapomina się najczęściej. **Dopóki wersja nie zostanie opublikowana, klucze z kroku 6
jeszcze nie istnieją.**

## 5. Zainstaluj aplikację w swoim sklepie

Wróć do widoku ogólnego aplikacji i naciśnij `Install app`. Wybierz swój sklep i potwierdź na
ekranie uprawnień.

_Zrzut ekranu: Widok ogólny aplikacji w Dev Dashboard, z aktywną wersją i przyciskiem instalacji aplikacji_

Widok ogólny, z opublikowaną już wersją i przyciskiem instalacji.

_Zrzut ekranu: Ekran instalacji w panelu sklepu, z uprawnieniami, o które prosi aplikacja, i przyciskami anulowania oraz instalacji_

Shopify ostrzega, że aplikacja nie przeszła jego weryfikacji. To normalne przy prywatnej aplikacji
utworzonej we własnej organizacji: nikt poza tobą nie może jej zainstalować, a uprawnienia to
dokładnie te z twojej listy.

> **Uwaga:** Bez tego kroku klucze istnieją, ale niczego nie autoryzują, a RUIT odrzuca połączenie z
> informacją, że aplikacja nie jest zainstalowana w sklepie.

## 6. Skopiuj `Client ID` i `Client Secret`

W ustawieniach aplikacji, w sekcji z poświadczeniami, masz obie wartości. Sekret jest ukryty,
dopóki nie naciśniesz ikony oka.

> **Ostrzeżenie:** RUIT chce pary **`Client ID` i `Client Secret`**, i nic więcej. Nie kopiuj klucza automatyzacji z
> Dev Dashboard ani, w starszej aplikacji, klucza dostępu zaczynającego się od `shpat_`. Z tych dwóch
> kluczy RUIT wydaje własne dostępy, które co dzień tracą ważność i odnawiają się same, więc nigdy nie
> przechowujemy stałego klucza do twojego sklepu.

## 7. Połącz sklep w RUIT

Wejdź w **Ustawienia → Konta**, naciśnij **Połącz konto** i wybierz **Shopify**. RUIT poprosi cię o
trzy rzeczy:

| Pole            | Co wkleić                                |
| --------------- | ---------------------------------------- |
| URL sklepu      | Domenę kończącą się na `.myshopify.com`   |
| `Client ID`     | Ten z kroku 6                             |
| `Client Secret` | Ten z kroku 6                             |

Adres to domena kończąca się na `.myshopify.com`, a nie ta, pod którą sprzedajesz publicznie. RUIT
jest wyrozumiały przy kopiowaniu i wklejaniu: przyjmuje również adres panelu administracyjnego.

_Zrzut ekranu: Okno łączenia z Shopify w RUIT: link do tego przewodnika, pola adresu URL sklepu, identyfikatora i sekretu aplikacji oraz przyciski anulowania i łączenia_

Okno Shopify. Numery wskazują **URL sklepu**, `Client ID` i `Client Secret`.

_Wideo jeszcze nienagrane: Połączenie sklepu Shopify_

## Co udało ci się osiągnąć

Twój sklep Shopify jest połączony z RUIT kluczami, które należą do ciebie i które możesz cofnąć,
kiedy zechcesz. Od tej chwili możesz zaimportować produkty, które już masz, publikować te ze swojego
magazynu, a RUIT dowiaduje się o każdej sprzedaży w chwili, w której następuje.

_Zrzut ekranu: Ekran Połączone konta w RUIT z kartą dla każdego marketplace, w tym kartą Shopify z połączonym sklepem, oraz przycisk łączenia konta w prawym górnym rogu_

Sklep Shopify wśród połączonych kont, z nazwą sklepu w Shopify i bez przycisku ponownego łączenia.

**Następny krok:** import z marketplace, żeby ściągnąć to, co już sprzedajesz w tym sklepie.

## Jeśli coś się nie zgadza

- **Połączenie się nie udaje, a komunikat mówi, że brakuje uprawnień.** Błąd wymienia, których.
  Wróć do kroku 3, wklej całą listę w **nowej wersji** aplikacji i ją opublikuj; uprawnienia są
  częścią wersji, więc samo ich edytowanie bez publikacji niczego nie zmienia.
- **Produkt powstaje, ale nie widać go w sklepie.** Brakuje dwóch uprawnień do publikacji. To te,
  których nikt nie sprawdza przy łączeniu.
- **Połączenie się nie udaje, a komunikat mówi, że aplikacja nie jest zainstalowana.** Krok 5
  został pominięty albo aplikacja trafiła do innego sklepu.
- **Masz aplikację sprzed 2026 roku.** Nadal działa. Jej klucze są w zakładce z poświadczeniami w
  panelu sklepu, a nie w Dev Dashboard.

- [Sprzedaż na Shopify z RUIT](https://ruit.es/pl/docs/sprzedaz-na-shopify/)
- [Połączenie sklepu WooCommerce z RUIT](https://ruit.es/pl/docs/polaczenie-sklepu-woocommerce/)
- [Jak działa łączenie konta](https://ruit.es/pl/docs/jak-dziala-laczenie-konta/)