PowerHub · poradnik dla e-commerce
# Integracja shopGold z PowerHub przez FTP: zamówienia, produkty, ceny i stany bez publicznego API
shopGold jest polskim oprogramowaniem sklepowym instalowanym na serwerze należącym do sprzedawcy. W odróżnieniu od wielu platform abonamentowych sklep działa we własnym środowisku hostingowym i daje właścicielowi dostęp do plików oraz bazy danych. Taka architektura zapewnia kontrolę, ale oznacza też, że integrator nie może skorzystać ze standardowego publicznego API.
PowerHub rozwiązuje ten problem za pomocą dedykowanego pliku komunikacyjnego instalowanego na serwerze shopGold przez FTP. Plik pełni rolę kontrolowanego punktu wymiany danych. PowerHub wysyła do niego uwierzytelnione żądania, a sklep przekazuje zamówienia i informacje o katalogu oraz przyjmuje aktualizacje dostępne w danym zakresie integracji.
Czym jest shopGold i dla kogo powstał
shopGold jest platformą do prowadzenia własnego sklepu internetowego, a nie marketplace’em. Sprzedawca zachowuje własną domenę, markę, relację z klientem i samodzielnie pozyskuje ruch. Oprogramowanie jest kupowane na własność i instalowane na hostingu spełniającym wymagania techniczne.
Z tego powodu w przypadku shopGold nie ma jednej listy krajów, najlepiej sprzedających się kategorii ani średniego obrotu partnera. Rynek sklepu zależy od konfiguracji języków, walut, płatności, dostaw, działań marketingowych i prawa obowiązującego sprzedawcę. Na shopGold może działać zarówno mały sklep specjalistyczny w Polsce, jak i sklep obsługujący zagranicznych klientów.
Nie istnieje również wspólna „średnia sprzedaż sprzedawcy shopGold”, którą można wykorzystać w biznesplanie. shopGold dostarcza technologię, ale nie generuje wspólnego popytu jak marketplace. Według niezależnego monitoringu ecommetria w październiku 2026 roku wykrywano około 942 sklepy shopGold w badanej bazie. To informacja o obecności technologii, a nie o wartości transakcji użytkowników.
Dlaczego integracja nie korzysta ze standardowego API
shopGold nie udostępnia publicznego API pozwalającego PowerHub bezpośrednio pobierać i aktualizować dane każdego sklepu. Jednocześnie właściciel instalacji ma dostęp do serwera. Dlatego połączenie powstaje przez plik dostarczony dla integracji PowerHub i umieszczony w katalogu sklepu.
Plik komunikuje się z lokalną instalacją shopGold, ale odpowiada wyłącznie na żądania spełniające warunki integracji. W panelu PowerHub zapisuje się adres pliku oraz dane uwierzytelniające. Dzięki temu system może wykonywać operacje bez udostępniania ogólnego dostępu do panelu administracyjnego lub bazy danych.
Podobny model stosują inne integracje shopGold. Oficjalna instrukcja połączenia z BaseLinker opisuje wgranie jednego pliku przez FTP do głównego katalogu sklepu, a opis integracji z Sellasist wskazuje plik komunikacyjny umieszczany na serwerze. Jest to więc znany dla tego oprogramowania sposób łączenia z systemem zewnętrznym.
Jakie dane może obsługiwać PowerHub
Zakres należy każdorazowo sprawdzić w formularzu integracji i aktualnej dokumentacji PowerHub. Docelowy proces może obejmować:
- pobieranie nowych zamówień wraz z pozycjami, kosztem dostawy, płatnością i danymi klienta,
- przesyłanie zmian statusu realizacji do shopGold,
- import produktów, wariantów, SKU, EAN, cen i stanów,
- powiązanie kart produktów shopGold z magazynem PowerHub,
- aktualizację cen i dostępności po zmianie w centralnym katalogu,
- przekazanie numeru przesyłki albo dokumentu, jeśli obsługuje to wdrożony zakres,
- obsługę sprzedaży shopGold razem z marketplace’ami, kurierami i magazynem.
Największa korzyść pojawia się wtedy, gdy shopGold jest jednym z kilku kanałów. Zamówienie trafia do tej samej kolejki co sprzedaż marketplace, a rezerwacja produktu wpływa na wspólny stan. Pracownik realizuje paczkę w jednym procesie, niezależnie od źródła zamówienia.
Co przygotować przed instalacją
Do uruchomienia potrzebne są:
- aktywny sklep shopGold i konto administratora,
- dostęp FTP lub SFTP do serwera sklepu albo menedżer plików w panelu hostingu,
- adres serwera, login, hasło i właściwy port,
- informacja, w którym katalogu znajduje się instalacja sklepu,
- plik komunikacyjny PowerHub pobrany z panelu lub otrzymany od zespołu wdrożeniowego,
- unikalne hasło albo klucz komunikacji,
- kopia zapasowa plików i bazy sklepu,
- osoba techniczna, która może sprawdzić logi PHP oraz konfigurację hostingu.
Jeżeli sklep jest utrzymywany przez agencję albo dostawcę hostingu, nie trzeba przekazywać danych FTP wielu osobom. Administrator może samodzielnie wgrać otrzymany plik zgodnie z instrukcją PowerHub.
Instalacja pliku PowerHub przez FTP krok po kroku
1. Wykonaj kopię zapasową
Przed zmianą plików utwórz kopię instalacji i bazy danych. Dodanie pojedynczego pliku jest małą operacją, ale backup pozwala bezpiecznie reagować na pomyłkę w lokalizacji, nazwie albo konfiguracji serwera.
2. Pobierz właściwy plik z PowerHub
Użyj pliku przygotowanego dla integracji shopGold. Nie zmieniaj jego nazwy ani zawartości, jeśli instrukcja wdrożeniowa tego nie wymaga. Nie korzystaj z pliku przesłanego dla innego sklepu, ponieważ może zawierać inną wersję mechanizmu albo konfiguracji.
3. Ustal katalog główny sklepu
Po połączeniu z FTP znajdź katalog, w którym działa publiczna część shopGold. Na wielu hostingach jest to public_html, www albo katalog w rodzaju domains/nazwa-domeny/public_html, ale rzeczywista ścieżka zależy od usługodawcy. Właściwe miejsce można rozpoznać po plikach instalacji sklepu i adresie domeny.
Pliku integracyjnego nie należy umieszczać w katalogu szablonu graficznego. Aktualizacja lub zmiana szablonu mogłaby go usunąć, a połączenie przestałoby działać.
4. Wgraj plik w miejsce wskazane przez PowerHub
Prześlij plik w trybie binarnym lub automatycznym, bez modyfikowania kodowania. Zachowaj standardowe uprawnienia odczytu stosowane przez pozostałe pliki PHP na hostingu. Nie ustawiaj globalnych praw zapisu. Jeżeli PowerHub wskazuje dedykowany katalog, utwórz go dokładnie według instrukcji.
5. Skonfiguruj tajny klucz komunikacji
Wygeneruj długie, losowe hasło i zapisz je w miejscu wskazanym przez proces instalacji. Ten sam sekret podaje się w formularzu integracji PowerHub. Klucz nie powinien być ponownie używany w panelu sklepu, FTP ani innych usługach.
6. Podaj adres pliku w PowerHub
Adres powinien korzystać z HTTPS i prowadzić bezpośrednio do pliku komunikacyjnego, na przykład w schemacie https://domena-sklepu.pl/sciezka/plik-integracji.php. Dokładną nazwę i ścieżkę należy skopiować z instrukcji wyświetlanej dla integracji, a nie przepisywać z przykładu.
7. Uruchom test połączenia
PowerHub powinien potwierdzić, że plik odpowiada, uwierzytelnienie jest prawidłowe, a wersja PHP i konfiguracja serwera pozwalają wykonać wymagane operacje. Błąd 404 oznacza zwykle nieprawidłową ścieżkę, 403 blokadę serwera, a 500 problem wykonywania skryptu. Szczegółową przyczynę należy sprawdzić w logach hostingu.
Pierwsza synchronizacja: kolejność ma znaczenie
Połączenie techniczne nie oznacza jeszcze gotowości do automatycznej sprzedaży. Pierwszą synchronizację należy przeprowadzić w kontrolowanej kolejności:
- Pobierz słowniki statusów, płatności i dostaw.
- Ustal, które statusy shopGold odpowiadają etapom PowerHub.
- Zaimportuj małą próbkę produktów.
- Sprawdź SKU, EAN, warianty, stawki VAT, ceny i stany.
- Powiąż istniejące produkty zamiast tworzyć duplikaty.
- Włącz pobieranie zamówień.
- Złóż zamówienie testowe w sklepie.
- Sprawdź zmianę statusu, rezerwację stanu, wysyłkę oraz anulowanie.
- Dopiero po odbiorze testów uruchom cykliczną synchronizację całego katalogu.
Jeżeli sklep i magazyn używają różnych SKU, trzeba przygotować tabelę powiązań. Automatyczne łączenie po niejednoznacznej nazwie produktu jest ryzykowne, szczególnie przy wariantach rozmiaru, koloru lub pojemności.
Mapowanie statusów, dostaw i płatności
Status „nowe” w shopGold nie zawsze oznacza ten sam moment co status „nowe” w procesie magazynowym. Zamówienie opłacone, pobraniowe i oczekujące na przelew mogą wymagać innych reguł. Dobre mapowanie powinno odpowiedzieć na pytania:
- kiedy PowerHub ma zarezerwować towar,
- kiedy zamówienie może trafić do kompletacji,
- który status oznacza gotowość do wysyłki,
- kiedy sklep ma powiadomić klienta,
- jak oznaczyć anulowanie i zwrot,
- co zrobić ze statusem niestandardowym utworzonym w shopGold.
Metody dostawy i płatności również powinny zostać powiązane z odpowiednimi usługami w PowerHub. Nazwa widoczna klientowi może różnić się od technicznego sposobu realizacji. Przykładowo kilka metod „kurier” może być obsługiwanych przez różnych przewoźników zależnie od wagi lub kraju.
Synchronizacja cen i stanów bez konfliktów
Przed włączeniem aktualizacji należy wybrać źródło nadrzędne. Cena nie może być jednocześnie niezależnie zmieniana w shopGold, arkuszu, ERP i PowerHub, ponieważ ostatni zapis będzie nadpisywał wcześniejszy. To samo dotyczy stanu.
Najczęściej PowerHub lub połączony z nim magazyn staje się źródłem dostępności, a shopGold kanałem prezentacji. Rezerwacja po zamówieniu obniża wspólny stan, który następnie trafia do pozostałych kanałów. Bufor bezpieczeństwa może zapobiegać sprzedaży ostatnich sztuk równocześnie w kilku miejscach.
Przy cenach trzeba uwzględnić walutę, VAT, promocję, zaokrąglenia i ewentualny cennik przypisany do shopGold. Test powinien obejmować cenę regularną, promocyjną, wariant i produkt z zerowym stanem.
Bezpieczeństwo pliku komunikacyjnego
Plik zewnętrzny jest punktem dostępu do danych sklepu, dlatego powinien być traktowany jak element infrastruktury, nie zwykła wtyczka.
- Korzystaj wyłącznie z wersji otrzymanej z PowerHub.
- Wymagaj połączenia HTTPS.
- Użyj unikalnego, długiego sekretu i zmieniaj go po podejrzeniu ujawnienia.
- Nie przesyłaj danych FTP zwykłą wiadomością, jeżeli administrator może sam wykonać instalację.
- Ogranicz dostęp do pliku według zaleceń PowerHub i możliwości hostingu.
- Kontroluj logi błędów oraz nietypową liczbę wywołań.
- Usuń nieużywane kopie pliku z nazwami typu „stary” lub „backup”.
- Po aktualizacji shopGold, PHP albo serwera wykonaj ponowny test połączenia.
Warto zapisać datę instalacji, wersję pliku, osobę odpowiedzialną i lokalizację. Dzięki temu późniejsza aktualizacja nie zaczyna się od szukania, gdzie działa integracja.
Typowe problemy i ich rozwiązania
| Objaw | Co sprawdzić |
|---|---|
| PowerHub nie łączy się z plikiem | adres URL, nazwę pliku, HTTPS, błąd 404 i reguły serwera |
| Serwer zwraca błąd 500 | wersję PHP, log błędów, brakujące rozszerzenia i zgodność pliku |
| Brak nowych zamówień | zakres dat, status źródłowy, harmonogram oraz uwierzytelnienie |
| Powstają duplikaty produktów | SKU, EAN, warianty i reguły automatycznego łączenia |
| Cena jest nadpisywana | źródło nadrzędne, kierunek synchronizacji i reguły cenowe |
| Stan wraca do starej wartości | drugi system zapisujący magazyn lub niewłaściwe powiązanie produktu |
| Status nie zmienia się w sklepie | mapowanie statusów i uprawnienie operacji po stronie pliku |
Problemu nie należy rozwiązywać przez wielokrotne uruchamianie pełnego importu. Najpierw trzeba ustalić, czy błąd dotyczy komunikacji, jednego rekordu, mapowania czy całego procesu.
Jak mierzyć efekt integracji
Po uruchomieniu warto porównać:
- czas od złożenia zamówienia do pojawienia się go w PowerHub,
- liczbę ręcznie przepisanych zamówień,
- liczbę anulowań wynikających z braku stanu,
- zgodność cen i dostępności pomiędzy systemami,
- czas przygotowania przesyłki,
- liczbę błędów oraz średni czas ich usunięcia,
- udział zamówień obsłużonych bez logowania do panelu shopGold.
Integracja przynosi największą wartość, gdy ogranicza pracę ręczną i jednocześnie zmniejsza liczbę błędów. Sama liczba zsynchronizowanych rekordów nie jest jeszcze miarą sukcesu.
Najczęstsze pytania
Czy trzeba modyfikować kod shopGold?
Integracja wymaga wgrania dedykowanego pliku komunikacyjnego na serwer sklepu. Nie należy samodzielnie edytować plików rdzenia ani szablonu, jeśli instrukcja PowerHub tego nie przewiduje.
Czy PowerHub potrzebuje hasła administratora shopGold?
Połączenie powinno korzystać z adresu pliku i osobnego sekretu komunikacji. Zakres wymaganych danych należy sprawdzić w aktualnym formularzu integracji. Nie należy używać tego samego hasła co do panelu lub FTP.
Czy plik zniknie po aktualizacji sklepu?
Plik umieszczony we właściwym katalogu nie powinien być częścią szablonu. Mimo to po każdej dużej aktualizacji warto sprawdzić jego obecność, zgodność wersji i test komunikacji.
Czy integrację można zainstalować bez programu FTP?
Tak, jeśli hosting udostępnia bezpieczny menedżer plików. Zasada pozostaje ta sama: plik musi trafić do właściwego katalogu instalacji i być dostępny pod adresem HTTPS.
Od czego zacząć po udanym teście?
Od mapowania słowników i małej próbki produktów, następnie od jednego zamówienia testowego. Pełny katalog i automatyczne aktualizacje należy włączyć po sprawdzeniu całej ścieżki.
Podsumowanie
Integracja shopGold z PowerHub omija brak publicznego API dzięki dedykowanemu plikowi komunikacyjnemu zainstalowanemu przez FTP. Po poprawnej konfiguracji sklep może przekazywać zamówienia i katalog oraz przyjmować uzgodnione aktualizacje stanów, cen i statusów. Kluczowe są właściwa lokalizacja pliku, osobny sekret, HTTPS, jednoznaczne SKU, mapowanie procesów i test po każdej większej aktualizacji środowiska.
Źródła
- shopGold – oficjalna strona oprogramowania
- shopGold – przykład integracji przez pojedynczy plik FTP
- shopGold – integracja z Sellasist i plik komunikacyjny
- shopGold – praca z plikami przez FTP
- Integracje PowerHub – konfiguracja połączeń
- Lista integracji PowerHub – shopGold
Sprawdź możliwości PowerHub
Połącz kanały sprzedaży, magazyn, dostawy i obsługę zamówień w jednym systemie.Poznaj PowerHub
