# Podłączenie sklepu Shopify do 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-17 · Source: https://ruit.es/pl/docs/sprzedaz-na-shopify/_

W tym samouczku podłączasz swój sklep Shopify do 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** być właścicielem sklepu albo mieć uprawnienie do tworzenia aplikacji, jeśli
należysz do zespołu. Nadaje się każdy sklep, także deweloperski. RUIT w żadnym momencie nie prosi o
twoje hasło do Shopify: uprawnienia ustalasz sam 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
> sklepu, w aplikacje i kanały sprzedaży, nie ma tam już formularza: jest tylko kafelek, który odsyła
> cię we właściwe miejsce. 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

Wejdź na [dev.shopify.com](https://dev.shopify.com) 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 tych, którzy 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 zaznaczyć je pojedynczo na bardzo długiej liście, ale wklejenie
listy jest szybsze i niczego nie pominiesz. Pozostałe pola zostają takie, jakie są.

_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, jedno po drugim.

| Uprawnienie                                | Obowiązkowe     | Do czego                                                        |
| ------------------------------------------ | --------------- | ---------------------------------------------------------------- |
| `read_products` i `write_products`         | Tak             | Import, publikacja i edycja produktów                            |
| `read_inventory` i `write_inventory`       | Tak             | Utrzymanie stanu magazynowego w synchronizacji                    |
| `read_locations`                           | Tak             | Wiedza, w którym magazynie zapisać ten stan                       |
| `read_orders`                              | Tak             | Natychmiastowa wiedza o sprzedaży. Bez niego połączenie odpada     |
| `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.
> **Tych dwóch od publikacji nikt nie sprawdza** i na tym polega pułapka: połączenie wychodzi dobrze,
> produkt powstaje, a w sklepie go nie ma, bo nikt nie opublikował go w kanale sprzedaży. Dodaj je
> teraz, a oszczędzisz sobie drugiej wycieczki.

## 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_

Ten krok jest zapominany 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 przeglądu. 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 upoważniają, 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 tracą ważność każdego dnia 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**. Poprosi cię o trzy
rzeczy:

| Pole           | Co wkleić                                     |
| -------------- | --------------------------------------------- |
| Adres 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.

_Wideo jeszcze nienagrane: Podłą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.

**Następny krok:** [import z marketplace](https://ruit.es/docs/importar-desde-un-marketplace/), żeby ściągnąć to,
co już sprzedajesz w tym sklepie.

## Jeśli coś się nie zgadza

- **Połączenie nie wychodzi i mówi, że brakuje uprawnień.** Błąd wymienia, których. Wróć do kroku 3,
  wklej całą listę w **nowej wersji** aplikacji i opublikuj ją; uprawnienia podróżują razem z
  wersją, więc samo ich edytowanie bez publikacji niczego nie zmienia.
- **Produkt powstaje, ale nie widać go w sklepie.** Brakuje ci dwóch uprawnień od publikacji. To te,
  których nikt nie sprawdza przy łączeniu.
- **Połączenie nie wychodzi i 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 jest dobra. Jej klucze są w zakładce z poświadczeniami
  w panelu sklepu, a nie w Dev Dashboard.
- **Kończy się stan magazynowy produktu.** RUIT archiwizuje produkt w Shopify, zamiast go kasować,
  więc historia i adres produktu zostają zachowane.

- [Sprzedaż na WooCommerce z RUIT](https://ruit.es/docs/vender-en-woocommerce/)
- [Sprzedaż na PrestaShop z RUIT](https://ruit.es/docs/vender-en-prestashop/)