Integracja obsługuje wyłącznie Magento 2. Magento 1 (w tym wersja 1.9 i starsze) nie jest wspierane.

Połączenie z Magento

Połączenie integratora ze sklepem na platformie Magento 2 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 Magento 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-Magento2_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-Magento2_IonCube9-13, a w nim folder RtnetSubSync – to ten wewnętrzny folder wgrywasz na serwer.
    Rozpakowywanie paczki brokera Magento – opcja Wyodrębnij wszystkie
  3. Połącz się klientem FTP/SFTP z serwerem sklepu i przejdź do katalogu głównego instalacji Magento, a następnie do podkatalogu pub.
  4. Przeciągnij folder RtnetSubSync do katalogu pub.
    WinSCP – folder RtnetSubSync wgrany do katalogu pub sklepu Magento

2. Sprawdzenie, czy broker działa

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

Adres nie zawiera fragmentu /pub.

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

Poprawna odpowiedź brokera Magento – komunikat Działa!

W przypadku błędu 404 (nie znaleziono strony) serwer prawdopodobnie wskazuje na katalog główny Magento, a nie na [code]pub[/code] (częściej spotykane w starszych instalacjach i na hostingach współdzielonych). Przenieś folder [code]RtnetSubSync[/code] z katalogu [code]pub[/code] do katalogu głównego sklepu i ponownie otwórz adres brokera.

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 do pliku 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 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.

Konfiguracja magazynów

Wymagane jest skonfigurowanie mapowania magazynów na sklepy. Więcej informacji znajduje się w tym artykule pomocy.