API Shopera – co można zautomatyzować w sklepie i od czego zacząć

Jak nadać dostęp do API w panelu Shopera

Shoper oferuje dwa sposoby dostępu do REST API dla integracji zewnętrznych: token API generowany dla konkretnej integracji oraz starszy dostęp przez login i hasło administratora z uprawnieniami webapi. Według pomocy Shopera integracje oparte na loginie i haśle nadal działają, ale dla nowych połączeń zalecane są tokeny.

Token API dla integracji zewnętrznej

1. W panelu przejdź do Aplikacje i integracje > Zewnętrzne aplikacje i kliknij Dodaj integrację.

2. Wybierz narzędzie z listy lub opcję Inne, wpisz nazwę integracji i opcjonalny opis.

3. W sekcji Uprawnienia wybierz obszar sklepu (np. Produkty, Zamówienia, Klienci, Magazyny) i zakres dostępu – od samego odczytu po odczyt, dodawanie, edycję i usuwanie.

4. Kliknij Zapisz i utwórz token, a następnie od razu skopiuj token – według pomocy jest wyświetlany tylko raz.

5. Wklej token w narzędziu zewnętrznym i sprawdź działanie integracji.

Według pomocy Shopera wygenerowany token nie wygasa. Jeśli wycieknie lub zmienisz wykonawcę, utwórz nowy token – stary przestaje działać, a integracja wymaga wpisania nowego. Szczegóły w artykule generowanie tokena API dla integracji zewnętrznej.

Administrator z dostępem webapi

Drugi sposób to grupa administratorów z typem dostępu do webapi. Tworzysz ją w Ustawienia > Ogólne > Administratorzy sklepu, nadajesz uprawnienia w zakładce Uprawnienia, a następnie dodajesz administratora z loginem i hasłem, które służą jako dane dostępu do webapi. Instrukcję znajdziesz w artykule jak w Shoperze utworzyć dostęp po API, a zasady nadawania uprawnień opisujemy w tekście uprawnienia administratorów w Shoperze.

[#uwaga] Pomoc techniczna Shopera według pomocy nie wspiera łączenia się ze sklepem przez API – odsyła do dokumentacji dla deweloperów. Za działanie integracji odpowiada więc jej wykonawca. Ustal z nim, kto monitoruje integrację, kto naprawia błędy i jak szybko, zanim cokolwiek uruchomisz na produkcji.

Od czego zacząć pierwszą integrację

Najczęstszy błąd to próba zautomatyzowania wszystkiego naraz. Lepiej wybrać jeden proces, który zabiera najwięcej czasu lub generuje najwięcej błędów, i od niego zacząć.

1. Opisz proces – co się dzieje dziś, kto to robi, ile czasu zajmuje i jakie błędy się zdarzają.

2. Sprawdź gotowe rozwiązania – App Store, wbudowane funkcje panelu, systemy do obsługi zamówień.

3. Nadaj minimalny dostęp – token tylko do obszarów i operacji, których integracja naprawdę potrzebuje.

4. Zbuduj prototyp na odczycie – najpierw pobieranie danych, dopiero potem zapis zmian w sklepie.

5. Zaplanuj obsługę błędów – limity zapytań opisane w dokumentacji, ponawianie, logi i powiadomienia.

6. Przekaż utrzymanie – dokumentacja, właściciel integracji, plan na zmiany w API i w sklepie.

Wykres – etapy przygotowania pierwszej integracji na API Shopera. [#chart:sh35b]

[#przyklad] Sklep z częściami rowerowymi dostaje od dostawcy plik z cenami i stanami raz dziennie. Pracownik ręcznie aktualizował około 300 produktów, co zajmowało pół dnia. Programista napisał skrypt, który pobiera plik, porównuje go z produktami w sklepie przez REST API i aktualizuje tylko zmienione ceny i stany. Token ma uprawnienia wyłącznie do produktów i magazynów, a każda zmiana jest zapisywana w logu.

API a webhooki – czym się różnią

REST API działa na zasadzie zapytania: Twój system pyta sklep o dane albo wysyła zmiany. Webhook działa odwrotnie – to sklep powiadamia Twój system, że coś się wydarzyło, np. złożono nowe zamówienie. W praktyce dobre integracje łączą oba mechanizmy: webhook informuje o zdarzeniu, a API pozwala pobrać szczegóły lub zapisać zmiany. Więcej o tym w artykule webhooki w Shoperze.

Bezpieczeństwo i dobre praktyki

• Zasada minimalnych uprawnień – integracja do stanów nie potrzebuje dostępu do klientów.

• Osobny token dla każdej integracji – łatwiej odebrać dostęp jednemu narzędziu bez wyłączania pozostałych.

• Bezpieczne przechowywanie – token traktuj jak hasło: nie wysyłaj go e-mailem ani nie zapisuj w kodzie w publicznym repozytorium.

• Testy na małej próbce – zmiany masowe uruchamiaj najpierw na kilku produktach.

• Kopia danych przed zmianą – eksport produktów przed dużą aktualizacją ułatwia powrót.

• Przegląd dostępów – co kwartał usuń integracje, z których nikt nie korzysta.

Szerzej o zabezpieczeniu sklepu piszemy w artykule bezpieczeństwo sklepu na Shoperze.

Typowe integracje na API w sklepach na Shoperze

Jeśli integracja dotyczy stanów magazynowych z wielu źródeł, przeczytaj też tekst synchronizacja stanów magazynowych w Shoperze. Gotowe rozszerzenia przeglądamy w artykule Shoper App Store – przydatne aplikacje, a integracje z hurtowniami – w tekście integracja Shopera z hurtownią.

Co przygotować przed rozmową z programistą

Dobry brief skraca wycenę i ogranicza ryzyko nieporozumień. Nie musisz znać szczegółów technicznych – wystarczy, że jasno opiszesz proces biznesowy i oczekiwany efekt.

• Cel i miernik – np. „stany aktualizowane co godzinę, zero sprzedaży produktów niedostępnych”.

• Źródło danych – skąd pochodzą dane (plik, system, API dostawcy), w jakim formacie i jak często się zmieniają.

• Identyfikatory – po czym łączysz produkty w obu systemach: kod produktu, EAN, symbol z ERP.

• Kierunek i częstotliwość – co płynie do sklepu, co ze sklepu i jak szybko musi się zaktualizować.

• Wyjątki – warianty, zestawy, produkty wycofane, przedsprzedaż, zamówienia anulowane.

• Odpowiedzialność – kto monitoruje integrację, kto reaguje na błędy i w jakim czasie.

Jeśli proces dotyczy statusów zamówień i wiadomości do klientów, najpierw sprawdź, co da się ustawić bez kodu – opisujemy to w artykule automatyzacja zamówień w Shoperze. Przy jednorazowych, masowych zmianach katalogu często wystarczy import produktów z pliku CSV.

Od czego zależy koszt integracji na API

Nie ma jednej stawki za integrację – koszt zależy od złożoności procesu, liczby systemów i wymagań co do niezawodności. Poniżej czynniki, które najbardziej wpływają na wycenę i czas realizacji.

Pamiętaj, że integracja to nie tylko koszt wdrożenia, ale też utrzymania: zmiany w API, w sklepie i w systemie zewnętrznym wymagają aktualizacji kodu. Zapytaj wykonawcę o model opieki po wdrożeniu.

Najczęściej zadawane pytania

Czy każdy sklep na Shoperze ma dostęp do API?

Dostęp do REST API nadajesz w panelu – przez token w sekcji Zewnętrzne aplikacje albo administratora z dostępem webapi. Zakres funkcji w konkretnym pakiecie warto potwierdzić w cenniku Shopera.

Gdzie znajdę dokumentację API Shopera?

Na stronie developers.shoper.pl. Znajdziesz tam dokumentację REST API, webhooków, autoryzacji OAuth 2.0 dla aplikacji, PHP SDK, Front API i CLI.

Czy token API wygasa?

Według pomocy Shopera wygenerowany token nie traci ważności. Możesz go jednak w każdej chwili zastąpić nowym – wtedy stary przestaje działać.

Czy pomoc techniczna Shopera pomoże w integracji przez API?

Według pomocy Shopera wsparcie techniczne nie obsługuje łączenia się ze sklepem przez API. Za integrację odpowiada programista lub agencja, która ją tworzy.

Czy potrzebuję programisty, żeby korzystać z API?

Tak, w większości przypadków. Część narzędzi zewnętrznych pozwala jednak połączyć się ze sklepem po wklejeniu tokena – wtedy programista nie jest potrzebny.

Jak odebrać dostęp integracji?

Usuń integrację lub utwórz nowy token w sekcji Zewnętrzne aplikacje. W przypadku dostępu webapi usuń administratora albo zmień jego hasło.

Podsumowanie

API Shopera pozwala zautomatyzować niemal każdy powtarzalny proces w sklepie – od aktualizacji cen i stanów, przez przesyłanie zamówień, po raporty. Zanim jednak zlecisz integrację, sprawdź gotowe aplikacje, a jeśli API jest konieczne, zacznij od jednego procesu, nadaj minimalne uprawnienia przez token i zadbaj o monitoring. Dobrze zaprojektowana integracja oszczędza godziny pracy co tydzień, źle zaprojektowana – generuje błędy szybciej niż człowiek.

Jeśli planujesz integrację sklepu z magazynem, ERP lub własnym systemem, jako autoryzowany partner Shoper pomożemy zaprojektować i wdrożyć ją bezpiecznie – sprawdź ofertę wdrożenia i rozwoju sklepu Shoper.