Baza wiedzy Kiero OMS.

Połącz własny sklep w Ustawienia → Integracje → Dodaj integrację → PrestaShop. Każdy klient używa adresu i klucza swojego sklepu. Nie trzeba prosić o dostęp do pilotażu ani instalować modułu Kiero. Potrzebujesz uprawnień właściciela lub administratora organizacji; publikowanie wymaga również uprawnień zapisu do produktów. Połączenie jest niedostępne w organizacji demo.

Co obsługuje integracja

Import zamówień z wybranych statusów: klient, adres dostawy i faktury, pozycje, waluta, ceny, podatki i potwierdzenie płatności.
Publikowanie produktów OMS: nazwa, opis, SKU/EAN, kategoria, język, podatek, zdjęcia, ceny i stany. Warianty łączysz z istniejącymi wartościami atrybutów w PrestaShop.
Opcjonalna synchronizacja cen i stanów produktów opublikowanych przez ten konektor. Obie funkcje są początkowo wyłączone.

Sprawdzono PrestaShop 9.1.5. Inne wersje wymagają osobnej weryfikacji; publikacja korzysta z PATCH. Nie są obsługiwane: import całego katalogu, tworzenie atrybutów, zwroty, wysyłanie statusów i numerów śledzenia do sklepu, webhooki, automatyczne przeliczanie walut ani współdzielone/zaawansowane stany magazynowe.

1. Przygotuj Webservice w PrestaShop

Zaloguj się do administracji sklepu. Otwórz Advanced Parameters / Zaawansowane → Webservice.
Ustaw Enable PrestaShop's webservice → Yes i zapisz. Jeśli widzisz „This functionality has been disabled”, sprawdź ten główny przełącznik — aktywny klucz sam nie włącza usługi.
Wybierz Add new webservice key, wygeneruj 32-znakowy klucz, dodaj opis „Kiero OMS” i włącz klucz.
Nadaj prawa według tabeli. Nie wybieraj „All”: PUT i DELETE nie są potrzebne. Zapisz.

Zastosowanie	Zasoby	Metody
Połączenie i zamówienia	shops, orders, customers, addresses, countries, currencies, carriers, order_states	GET
Automatyczne rozpoznanie strefy czasowej	configurations	GET (opcjonalne dla samego importu)
Publikacja i synchronizacja katalogu	products	GET, POST, PATCH
Zdjęcia	images	GET, POST
Stany	stock_availables	GET, PATCH
Ustawienia i słowniki publikacji	configurations, languages, categories, shop_groups, currencies, tax_rule_groups, tax_rules, taxes	GET
Warianty	combinations	GET, POST, PATCH
Atrybuty wariantów	product_options, product_option_values	GET

Klucz daje dostęp do danych sklepu. Wklej go tylko w formularzu Kiero; nie dodawaj do URL, wiadomości, zrzutu ekranu ani opisu produktu. Kiero przechowuje klucz zaszyfrowany po stronie serwera. Po ujawnieniu wygeneruj nowy, zastąp go w ustawieniach integracji, sprawdź połączenie i wyłącz stary.

2. Sprawdź adres i dostęp

Użyj publicznego adresu HTTPS, np. https://twoj-sklep.pl lub https://twoj-sklep.pl/sklep/. Końcowe /api/ jest rozpoznawane automatycznie. Nie używaj localhost, prywatnego IP, loginu/hasła w adresie, parametrów ani niestandardowego portu. Certyfikat TLS musi być poprawny.

Serwer musi przekazywać nagłówek Authorization i obsługiwać GET oraz POST/PATCH przy publikacji. Zewnętrzne Basic Auth przed /api koliduje z kluczem Webservice: administrator hostingu powinien udostępnić API pod uwierzytelnianiem PrestaShop, zachowując ochronę panelu i witryny. Nie wyłączaj ochrony całego sklepu. Przełącznik CGI zmieniaj zgodnie z konfiguracją PHP hostingu, a nie na próbę.

3. Podłącz sklep w Kiero

W formularzu PrestaShop podaj nazwę połączenia, URL i klucz, następnie pobierz dostępne sklepy i statusy.
Wybierz sklep. Przy kilku dostępnych sklepach wybór jest obowiązkowy. Współdzielony stan grupy sklepów nie jest obsługiwany przez publikację.
Zaznacz statusy zamówień do importu. Wyklucz anulowane i zwrócone; statusy nie są wybierane automatycznie. Nazwy zależą od konfiguracji Twojego sklepu.
Sprawdź strefę IANA, np. Europe/Warsaw. Jeśli nie została odczytana z konfiguracji, wpisz faktyczną strefę sklepu. Zła strefa może przesunąć zakres importu.
Wybierz podmiot prawny swojej organizacji i datę początku importu. Początek daty jest zapisywany jako 00:00 UTC.
Sprawdź opcję automatycznego pobierania zamówień i zapisz połączenie. Nowe połączenia mają ją domyślnie włączoną. Zapis nie wykonuje natychmiastowego importu: użyj ręcznej synchronizacji albo poczekaj na harmonogram (domyślnie około 5 minut plus czas kolejki).
W ustawieniach połączenia uruchom test i ręczne pobranie. Sprawdź kilka zamówień w Zamówienia: walutę, pozycje, adresy, dostawę i płatność.

Zmieniasz URL lub klucz podczas łączenia? Pobierz sklepy i statusy ponownie. Powtórny import tego samego zamówienia nie powinien tworzyć drugiego zamówienia ani ponownie odejmować stanów. Niepełny import wymaga naprawienia przyczyny i ponowienia. Potwierdzenie opłacenia zależy od statusu oznaczonego jako płatny i rzeczywiście opłaconej kwoty; nietypowe moduły płatnicze wymagają weryfikacji.

4. Opublikuj produkt

Przygotuj produkt w Produkty: nazwę, unikalne SKU, opcjonalny poprawny EAN-13, opis i dostępne publicznie zdjęcia HTTPS. Do 10 zdjęć JPEG/PNG/WebP, każde do 8 MiB.
Wybierz produkt lub partię do 20 produktów, następnie Publikuj → PrestaShop i właściwe połączenie.
Wybierz język, istniejącą kategorię i zweryfikowaną grupę podatkową sklepu; brak podatku wybierz świadomie. Złożone stawki regionalne nie są zgadywane.
Podaj ceny brutto w walucie sklepu i nieujemne całkowite ilości. Kiero oblicza cenę netto dla PrestaShop. Zmiana waluty nie przelicza kwoty.
Dla produktu z wieloma wariantami przypisz każdy wariant do istniejących wartości atrybutów. Utwórz brakujące atrybuty w PrestaShop przed publikacją. Zestawy wartości muszą być różne i obejmować te same grupy atrybutów.
Domyślnie produkt pozostanie nieaktywny. Zaznacz aktywację tylko gdy chcesz go udostępnić po weryfikacji.
Zleć publikację i poczekaj na sukces zadania. Samo przyjęcie do kolejki nie oznacza publikacji. Sprawdź produkt w PrestaShop przed rozpoczęciem sprzedaży.

Kiero najpierw tworzy nieaktywny produkt, zapisuje warianty, zdjęcia, stany i powiązania, a dopiero potem może go aktywować. Ujemna różnica ceny wariantu jest prawidłowa, gdy wariant kosztuje mniej od ceny bazowej. Kolejna publikacja tego samego produktu w tym samym połączeniu używa istniejącej operacji. Ponowienie nie edytuje zapisanego zestawu danych; nie służy do zmiany kategorii lub opisu.

5. Włącz ceny i stany świadomie

W ustawieniach integracji włącz osobno synchronizację cen i stanów. Źródłem wartości jest produkt/wariant OMS; nie włączaj równolegle drugiego systemu zapisującego te same wartości. Najpierw sprawdź jeden produkt, także stan zero. Zmiany wykonuje kolejka według harmonogramu, nie natychmiast po edycji.

Synchronizacja obejmuje tylko produkty opublikowane przez ten konektor, nie dowolny katalog zastany w sklepie. Stan jest zapisywany jako ilość bezwzględna, nie przyrost. Cena wariantu jest przeliczana na różnicę względem ceny bazowej. Ogólny pojedynczy i masowy edytor cen/stanów ofert nie zapisuje zmian PrestaShop: zmień produkt OMS i użyj synchronizacji integracji. Opisów, kategorii i zdjęć ten harmonogram nie aktualizuje.

6. Gdy pojawi się problem

Objaw	Co zrobić
Webservice disabled	Włącz i zapisz główny przełącznik Webservice, potem sprawdź aktywność klucza.
401 / 403	Sprawdź klucz, jego prawa i przekazywanie Authorization; zweryfikuj zewnętrzne Basic Auth/WAF z hostingiem.
Brak opcji publikacji / permission error	Uzupełnij GET/POST/PATCH według tabeli; przy wariantach potrzebne są też combinations i słowniki atrybutów.
Błędna waluta lub podatek	Użyj waluty sklepu i obsługiwanej grupy podatkowej; nie zmieniaj samej etykiety waluty przy tej samej kwocie.
Zdjęcie niedostępne	Otwórz URL bez logowania, sprawdź HTTPS, format, rozmiar i blokady hostingu.
Shared/advanced stock	Zastosuj obsługiwany niezależny stan sklepu albo skonsultuj model stanów; nie wybieraj przypadkowego rekordu.
Zadanie failed	Sprawdź przyczynę i po jej usunięciu ponów. Nie twórz nowego połączenia w celu obejścia błędu.
Reconciliation required / potrzebna weryfikacja	Nie publikuj kopii. Odpowiedź mogła zaginąć po zapisie w sklepie. Pomoc techniczna musi porównać identyfikatory i wynik operacji. Nieznany wynik wysłania zdjęcia wymaga ręcznej weryfikacji; Retry sam go nie rozwiązuje.
Brak zamówienia	Sprawdź wybrany sklep, status, datę, strefę, aktywność integracji, dostęp abonamentowy i wynik kolejki; potem ponów synchronizację.

Zgłaszając problem podaj nazwę integracji, wersję PrestaShop, czas, ID produktu/zamówienia/zadania i bezpieczny komunikat błędu. Nie przesyłaj klucza. Zobacz Pomoc.

7. Pauza i odłączenie

Wyłącz automatyczne zamówienia oraz ceny/stany, aby zatrzymać harmonogramy. Wstrzymaj integrację, aby kolejne zadania nie wykonywały pracy; nie cofa to zakończonej operacji ani żądania już wysłanego do sklepu. Dane już zaimportowane do OMS i produkty w sklepie pozostają. Usunięcie połączenia nie usuwa produktów PrestaShop. Gdy kończysz korzystanie, wyłącz lub usuń również dedykowany klucz w PrestaShop.

Status roadmapy oznacza dostępność funkcji. Kontrolny test wersji 9.1.5 wykonano 27 października 2026; nie stanowi to potwierdzenia każdej konfiguracji lub wersji sklepu.