# Połączenie sklepu PrestaShop z RUIT

Samouczek łączenia PrestaShop: włącz API sklepu, utwórz klucz z uprawnieniami, których używa RUIT, i wklej go razem z adresem sklepu.

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

W tym samouczku łączysz swój sklep PrestaShop z RUIT. PrestaShop łączy się kluczem swojej **usługi
sieciowej** (`webservice`), którą polski panel nazywa po prostu **API**. Klucz tworzysz w panelu
własnego sklepu i nadajesz mu uprawnienia zasób po zasobie. Są dwie części: przygotowanie klucza w
PrestaShop i wklejenie go w RUIT. Zajmuje to **dziesięć minut** i robi się **tylko raz**.

**Potrzebujesz** dostępu administratora do panelu PrestaShop, sklepu dostępnego przez `https://` i
[zweryfikowanego telefonu](https://ruit.es/pl/docs/weryfikacja-telefonu/), bo bez niego kreator łączenia się nie
otworzy.

## 1. Włącz API PrestaShop

W panelu swojego sklepu wejdź w **Zaawansowane → API**. Usługa jest domyślnie wyłączona: ustaw
**Włącz API PrestaShop** na **Tak** i naciśnij **Zapisz**.

_Zrzut ekranu: Strona Webservice w panelu PrestaShop po angielsku: lista kluczy, przycisk dodawania nowego klucza w prawym górnym rogu, a niżej konfiguracja z przełącznikiem włączania usługi_

Strona usługi sieciowej, z panelem po angielsku. Ramki wskazują przełącznik **włączania** i
przycisk **dodawania nowego klucza**.

## 2. Utwórz klucz dla RUIT

Na tym samym ekranie naciśnij **Dodaj nowy klucz API**. Naciśnij **Wygeneruj**, żeby PrestaShop sam
utworzył klucz, nadaj mu opis, który rozpoznasz, i zostaw klucz włączony. Skopiuj go: to ten klucz
wkleisz w RUIT w kroku 4.

_Zrzut ekranu: Formularz nowego klucza w PrestaShop: pole klucza z przyciskiem generowania obok, opis klucza, przełącznik włączenia i początek tabeli uprawnień_

Ramki wskazują **Wygeneruj** i **opis**. Klucz jest zakryty: PrestaShop tworzy go z 32 znaków.

## 3. Zaznacz uprawnienia klucza

Pod formularzem jest tabela uprawnień: jeden zasób w każdym wierszu i jedno pole wyboru na każdą
czynność. RUIT używa tych:

| Zasób | Zobacz (`GET`) | Modyfikuj (`PUT`) | Dodaj (`POST`) | Skasuj (`DELETE`) |
|---|---|---|---|---|
| `products` | Tak | Tak | Tak | Tak |
| `combinations` | Tak | Tak | Tak | |
| `stock_availables` | Tak | Tak | | |
| `specific_prices` | Tak | | Tak | Tak |
| `images` | Tak | | Tak | Tak |
| `categories`, `manufacturers`, `product_options`, `product_option_values`, `languages`, `taxes`, `tax_rules` | Tak | | | |

Kolumny **Łatka** i **Szybki podgląd** zostaw niezaznaczone. Naciśnij **Zapisz**.

_Zrzut ekranu: Tabela uprawnień klucza w PrestaShop z kolumnami zobacz, modyfikuj, dodaj, łatka, skasuj i szybki podgląd oraz wierszem produktów z zaznaczonymi polami zobacz, modyfikuj, dodaj i skasuj_

Tabela przewinięta do wiersza `products`. Ramki wskazują nagłówek z kolumnami i ten wiersz z
czterema zaznaczonymi polami.

> **Wskazówka:** Jeśli nie chcesz zaznaczać pola po polu, możesz też zaznaczyć wszystkie uprawnienia: z klucza
> korzysta tylko RUIT, a usunąć go możesz na tym ekranie, kiedy zechcesz.

> **Ostrzeżenie:** Przy łączeniu RUIT sprawdza tylko, czy klucz może **odczytać listę języków**. Brak innego
> uprawnienia nie ujawnia się przy łączeniu, tylko później, przy imporcie albo publikacji. Import
> wyraźnie ostrzega, jeśli klucz nie może odczytać `taxes` i `tax_rules`.

## 4. Połącz sklep w RUIT

Wejdź w **Ustawienia → Konta**, naciśnij **Połącz konto** i wybierz **PrestaShop**. Wpisz adres
swojego sklepu w polu **Strona internetowa** (sama domena też wystarczy: RUIT doda na początku
`https://`) i wklej klucz w polu **Klucz API**. Naciśnij **Połącz**.

_Zrzut ekranu: Okno łączenia z PrestaShop w RUIT: link do tego przewodnika, pole Strona internetowa, pole Klucz API z ikoną podglądu oraz przyciski anulowania i łączenia_

Okno PrestaShop. Numery wskazują **Strona internetowa** i **Klucz API**. Ikona oka pokazuje klucz,
kiedy chcesz go sprawdzić.

RUIT testuje klucz, prosząc twój sklep o listę języków, i zapamiętuje pierwszy aktywny: w tym
języku będzie pisał karty produktów.

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

Twój sklep pojawia się na liście **Połączone konta** ze swoją kartą PrestaShop. Klucz nie wygasa,
więc karta nie ma przycisku **Połącz ponownie**, który mają Wallapop i Vinted: połączenie trwa,
dopóki nie usuniesz klucza w swoim panelu.

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

Sklep PrestaShop wśród połączonych kont, z nazwą, którą mu nadano.

**Następny krok:** import z marketplace, żeby ściągnąć produkty, które masz już w sklepie, albo
[publikacja pierwszego produktu](https://ruit.es/pl/docs/pierwsza-oferta/).

## Jeśli coś się nie zgadza

- **„Nie udało się zweryfikować danych dostępowych. Sprawdź klucze API i adres sklepu”.** Twój
  sklep nie odpowiedział tak, jak RUIT się spodziewał. Sprawdź po kolei, czy API jest włączone
  (krok 1), czy klucz jest skopiowany w całości i ma uprawnienie **Zobacz** dla `languages`
  (krok 3) oraz czy adres prowadzi do sklepu, a nie do panelu.
- **„Nieprawidłowy format danych dostępowych”.** Klucz ma mniej niż 8 znaków, więc wklejono tylko
  jego fragment. Klucze PrestaShop mają 32 znaki.
- **„Adres URL musi używać protokołu HTTPS (nie HTTP)”.** RUIT nie łączy sklepów bez `https://`.
  Zainstaluj w sklepie certyfikat i spróbuj ponownie.
- **Import ostrzega o podatkach.** Klucz nie ma uprawnienia **Zobacz** dla `taxes` i `tax_rules`.
  Zaznacz te dwa pola w kroku 3 i powtórz import; nie trzeba łączyć sklepu ponownie.
- **Publikacja się nie udaje i wymienia zasób.** Brakuje tego uprawnienia w tabeli z kroku 3.
  Zaznacz je i opublikuj ponownie.

- [Sprzedaż na PrestaShop z RUIT](https://ruit.es/pl/docs/marketplaces/)
- [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/)