Połączenie z ShopGold

Połączenie integratora ze sklepem na platformie ShopGold wymaga dwóch rzeczy: wgrania na serwer modułu brokera i uzupełnienia w konfiguracji integratora pól Adres brokera oraz Klucz Secret.

  1. Uruchom integrator i otwórz menu Program > Konfiguracja (F9).
  2. Przejdź do zakładki Połączenie ze sklepem. Pola Adres brokera i Klucz Secret uzupełnisz po wykonaniu kroków opisanych poniżej.

Konfiguracja integratora – zakładka Połączenie ze sklepem

Konfiguracja składa się z 5 etapów:

  1. Wgranie brokera na serwer przez FTP/SFTP
  2. Sprawdzenie, czy broker działa
  3. Wpisanie adresu brokera w konfiguracji integratora
  4. Wygenerowanie klucza i zapisanie go w pliku brokera
  5. Wpisanie klucza Secret w konfiguracji integratora
Przed rozpoczęciem przygotuj dane dostępowe FTP/SFTP do serwera sklepu (adres serwera, login, hasło). Otrzymasz je od firmy hostingowej lub administratora sklepu.

1. Wgranie brokera na serwer przez FTP/SFTP

W ShopGold broker instaluje się przez wgranie plików na serwer (FTP/SFTP), a nie z panelu administracyjnego sklepu. Możesz użyć dowolnego klienta FTP/SFTP, np. WinSCP, FileZilla lub Total Commander. Zrzuty ekranu w instrukcji pochodzą z bezpłatnego programu WinSCP.
  1. Zlokalizuj plik RtnetSubSync-ShopGold_IonCube9-13.zip. Znajduje się w folderze instalacyjnym integratora. Domyślne lokalizacje:
    ERP (integrator) Lokalizacja do 06.2026 Lokalizacja od 07.2026
    Subiekt GT / Subiekt nexo PRO / Navireo (SubSync) C:\Program Files (x86)\RTNET\SubSync C:\Program Files (x86)\Integratory.pl\SubSync
    WAPRO Mag (WfSync) C:\Program Files (x86)\RTNET\WfSync C:\Program Files (x86)\Integratory.pl\WfSync
    Optima (OpSync) C:\Program Files (x86)\RTNET\OpSync C:\Program Files (x86)\Integratory.pl\OpSync
    Symfonia ERP/Handel (SymSyncPro) C:\Program Files (x86)\RTNET\SymSyncPro C:\Program Files (x86)\Integratory.pl\SymSyncPro

    Z poziomu uruchomionego integratora możesz też przejść do tego folderu bezpośrednio: Program > Zaawansowane > Otwórz katalog programu.

    Choć nazwa pliku zawiera fragment „IonCube9-13”, paczka brokera jest kompatybilna także z nowszymi wersjami ionCube, w tym 14+.

    Aktualną wersję paczki brokera możesz też pobrać tutaj.
  2. Rozpakuj plik ZIP (prawy przycisk myszy > Wyodrębnij wszystkie > Wyodrębnij). Powstanie folder RtnetSubSync-ShopGold_IonCube9-13, a w nim folder RtnetSubSync – to ten wewnętrzny folder wgrywasz na serwer.
    Rozpakowywanie paczki brokera ShopGold – opcja Wyodrębnij wszystkie
  3. Połącz się klientem FTP/SFTP z serwerem sklepu i przejdź do katalogu głównego instalacji ShopGold, a następnie do podkatalogu webserwis.
    Jeśli w katalogu głównym sklepu nie ma katalogu [code]webserwis[/code], utwórz go.
  4. Przeciągnij folder RtnetSubSync do katalogu webserwis.
    WinSCP – folder RtnetSubSync wgrany do katalogu webserwis sklepu ShopGold

2. Sprawdzenie, czy broker działa

Otwórz w przeglądarce adres: https://[adres Twojego sklepu]/webserwis/RtnetSubSync/Broker.php

Jeśli broker jest wgrany poprawnie, zobaczysz komunikat jak na zrzucie ekranu poniżej:

Poprawna odpowiedź brokera ShopGold – komunikat Działa!

3. Wpisanie adresu brokera w konfiguracji integratora

Gdy broker zwraca komunikat „Działa!”, skopiuj pełny adres z paska przeglądarki (razem z https://) i wklej go w integratorze:

Program > Konfiguracja (F9) > Połączenie ze sklepem > Adres brokera

Pole Adres brokera uzupełnione adresem webserwis/RtnetSubSync/Broker.php

4. Wygenerowanie klucza i zapisanie go w pliku brokera

  1. Otwórz generator klucza Secret. Strona wygeneruje gotową zawartość pliku z nowym, unikalnym kluczem.
  2. Zaznacz całą zawartość strony (Ctrl + A) i skopiuj ją (Ctrl + C).
    Generator klucza Secret – zaznaczona zawartość do skopiowania
  3. Na serwerze, w folderze webserwis/RtnetSubSync, otwórz do edycji plik Secrets.php (w WinSCP: prawy przycisk myszy na pliku > Edytuj).
    WinSCP – otwieranie pliku Secrets.php do edycji
  4. Zaznacz całą dotychczasową zawartość pliku (Ctrl + A) i usuń ją (Delete).
    Plik Secrets.php – domyślna zawartość zaznaczona do usunięcia
  5. Wklej skopiowaną zawartość z generatora (Ctrl + V) i zapisz plik (Ctrl + S).
    Plik Secrets.php po wklejeniu zawartości z generatora

5. Wpisanie klucza Secret w konfiguracji integratora

  1. Z kodu wygenerowanego w kroku 4 skopiuj wartość klucza – ciąg znaków zapisany w apostrofach w linii define('RTNETSS_SECRET', '...'); (bez apostrofów). Najszybciej zaznaczysz go, klikając dwukrotnie w ciąg znaków.
    Kopiowanie wartości klucza RTNETSS_SECRET z pliku Secrets.php
  2. Wklej ją w integratorze: Program > Konfiguracja (F9) > Połączenie ze sklepem > Klucz Secret.
  3. Kliknij Testuj, aby sprawdzić połączenie. Przy poprawnej konfiguracji pojawi się komunikat „Połączenie z serwerem nawiązane pomyślnie” wraz z informacjami o wersji sklepu i serwera.
    Wynik testu połączenia – komunikat Sukces
  4. Zapisz konfigurację przyciskiem OK.