Przejdź do treści
ABHelp ABHelpCentrum pomocy Historia zmianPanel

Pierwsze uruchomienie — od instalacji do pierwszego dokumentu

Cała droga od świeżo zainstalowanego programu do pierwszego dokumentu wystawionego w Subiekcie. Po drodze wyjaśniamy, dlaczego na starcie widać tylko jedno pole i kiedy pojawia się reszta ustawień.

Ostatnia aktualizacja: 13 listopada 2026
  1. Przygotuj sobie dane

    Zanim usiądziesz do konfiguracji, miej pod ręką:

    • klucz licencyjny otrzymany od AppsBusters,
    • informację, z jakim sklepem pracujesz (Baselinker albo Sellasist) — instalator o to zapyta,
    • nazwę serwera SQL i nazwę bazy firmy (podmiotu) z Subiekta GT,
    • login i hasło operatora Subiekta — najlepiej osobnego, założonego wyłącznie dla integracji,
    • token API do Twojego OMS,
    • aktywną Sferę w Subiekcie GT (bez niej test połączenia nie przejdzie).
  2. Zainstaluj program i wybierz sklep oraz Subiekta

    Uruchom instalator AB Connect Guard i przejdź kolejne strony. Na stronie Sklep i ERP zaznacz:

    • Sklep: Baselinker albo Sellasist,
    • Program ERP: Subiekt GT.

    Oba wybory są wymagane — bez nich instalator nie pójdzie dalej. Później zmienisz je w Guardzie, w sekcji Konfiguracja integratora.

    W trakcie instalacji pojawi się okno wyboru trybu autostartu — przeczytaj opisy i wybierz (szczegóły: wybór trybu autostartu).

    Na koniec instalacji program zapyta, czy uruchomić integrator — opisujemy to w następnym kroku.

    Dostępność: opis dotyczy instalatora Guarda 1.2026.312.1050. Starsze instalatory mogą wyglądać i działać inaczej.

    Strona Sklep i ERP w instalatorze — oba wybory są wymagane.
    Strona Sklep i ERP w instalatorze — oba wybory są wymagane.
  3. Zdecyduj, czy uruchomić integrator od razu

    Gdy instalacja się skończy, pojawi się pytanie Uruchomić integrator teraz?

    • Tak — integrator rusza od razu, a w trybie usługi Guard uruchamia usługę Windows. Od razu możesz też otworzyć panel konfiguracji w przeglądarce.
    • Nie — integrator czeka. Program podpowie, że uruchomisz go później przyciskiem Uruchom integrator w panelu po lewej stronie okna AB Connect Guard.

    Na ostatnim ekranie instalator napisze, czy integrator został uruchomiony. Instalacja w trybie cichym (bez okien) o nic nie pyta i niczego nie uruchamia.

    Pytanie na koniec instalacji: Tak uruchamia integrator od razu, Nie zostawia go wyłączonego.
    Pytanie na koniec instalacji: Tak uruchamia integrator od razu, Nie zostawia go wyłączonego.
  4. Uruchom AB Connect Guard

    Guard to okno, w którym ustawiasz podstawy i z którego uruchamiasz integrator. Otworzysz go ikoną przy zegarku albo skrótem programu. Na Pulpicie zobaczysz zieloną kartę Pierwsze uruchomienie — co po kolei zrobić, a po lewej stronie listę sekcji: Status, Konfiguracja, Harmonogram, Aktualizacje, Usługa, Logi.

    Kartę z instrukcją możesz schować przyciskiem Rozumiem, schowaj i przywrócić przyciskiem Pokaż instrukcję.

    Okno AB Connect Guard: karta „Pierwsze uruchomienie” z kolejnymi krokami i sekcja konfiguracji.
    Okno AB Connect Guard: karta „Pierwsze uruchomienie” z kolejnymi krokami i sekcja konfiguracji.
  5. Sprawdź sekcję KONFIGURACJA INTEGRATORA

    Przejdź do sekcji Konfiguracja i sprawdź trzy pola — dwa pierwsze są już wypełnione wyborem z instalatora:

    • Aplikacja — OMS, z którym pracujesz.
    • ERP — Subiekt.
    • Port — numer, pod którym otworzysz panel w przeglądarce. Domyślnie 5000. Zmieniaj tylko wtedy, gdy na tym komputerze pracuje już druga firma.

    Jeśli coś zmieniłeś, kliknij Zapisz konfigurację. Program potwierdzi komunikatem Zapisano konfigurację.

    Bazę firmy z Subiekta wskazujesz dopiero w panelu, w sekcji Połączenie z Subiekt — opisujemy to niżej.

  6. Wskaż, gdzie AB Connect ma trzymać swoje ustawienia

    Niżej, w sekcji BAZA ABCONNECT (KONFIGURACJA), wybierz pole Baza:

    • SQL Server (zalecane) — ten sam serwer, na którym stoi baza Subiekta. Każda firma ma wtedy własną, osobną bazę ustawień.
    • SQLite — ustawienia w pliku na tym komputerze. Zostaw dla zgodności ze starszymi instalacjami.

    Po wybraniu SQL Server uzupełnij Instancja SQL (np. .\INSERTGT albo SERWER\INSTANCJA), nazwę w polu Baza SQL ABConnect — ustawienia oraz sposób logowania: zaznacz Autentykacja Windows albo wpisz Login SQL i hasło.

    Logi trafiają do osobnej bazy o tej samej nazwie z końcówką _logs — jej nazwę widać pod polem. Program zakłada ją sam przy pierwszym starcie, jeśli konto ma prawo do założenia bazy. Jeśli go nie ma, test połączenia pokaże pomarańczowe ostrzeżenie: integrator będzie działał, ale logi zapisze w pliku na tym komputerze, dopóki administrator serwera SQL nie założy bazy logów i nie odda jej temu kontu.

    Kliknij Testuj połączenie — test sprawdza dostęp do bazy ustawień i do bazy logów. Nie idź dalej, dopóki wynik nie jest zielony albo pomarańczowy (pomarańczowy oznacza, że ustawienia są w porządku, a tylko logi pójdą do pliku).

    Pole Przenieś ustawienia z bazy SQLite zaznacz, gdy ta firma ma już ustawienia w SQLite — przy przejściu ze starego programu albo gdy firma pracowała dotąd na SQLite i przechodzi na SQL Server. Ustawienia zostaną przeniesione raz, przy pierwszym starcie; plik SQLite zostaje nietknięty, historii logów nie przenosimy. Przy nowej instalacji zostaw pole odznaczone. Zapisz zmiany przyciskiem Zapisz konfigurację.

    Przykład demonstracyjny: nazwa bazy ustawień, a pod nią nazwa osobnej bazy logów.
    Przykład demonstracyjny: nazwa bazy ustawień, a pod nią nazwa osobnej bazy logów.
  7. Uruchom integrator

    Autostart instaluje już instalator — tryb wybrałeś w oknie, które pojawiło się w trakcie instalacji. Jeśli na pytanie Uruchomić integrator teraz? odpowiedziałeś Tak, integrator już działa i możesz przejść dalej.

    Jeśli wybrałeś Nie, kliknij Uruchom integrator w panelu po lewej stronie okna Guarda, przy statusie integratora. Przycisk działa w każdym trybie autostartu — w trybie usługi uruchamia usługę Windows.

    Kropka statusu zrobi się zielona, a integrator wystartuje po chwili. Po ponownym uruchomieniu komputera integrator startuje już sam.

    Jeśli sekcja Usługa / Autostart pokazuje, że autostart nie jest zainstalowany, kliknij Zainstaluj i wybierz tryb — więcej w poradniku Wybór trybu autostartu.

    Chcesz tylko sprawdzić konfigurację, bez instalowania autostartu? Gdy autostart nie jest zainstalowany, w oknie widać kartę TRYB BEZ AUTOSTARTU / USŁUGI z przyciskiem Uruchom integrator. Integrator działa wtedy tylko dopóki to okno jest otwarte.

    Przycisk Uruchom integrator w panelu po lewej stronie okna Guarda — widoczny w każdym trybie.
    Przycisk Uruchom integrator w panelu po lewej stronie okna Guarda — widoczny w każdym trybie.
  8. Otwórz panel w przeglądarce

    Gdy integrator działa, w lewym dolnym rogu Guarda pojawia się przycisk Otwórz w przeglądarce. Kliknij go — otworzy się panel AB Connect pod adresem z portem ustawionym wcześniej w konfiguracji.

    Przy zupełnie świeżej instalacji program zapyta: Skorzystać z uproszczonego kreatora? Możesz wybrać Tak, uruchom kreator (prowadzi przez podstawy w 8 krokach) albo Nie, pełny konfigurator. Dalsze kroki tego poradnika opisują pełny konfigurator.

  9. Wpisz klucz licencyjny

    Na samej górze konfiguratora jest jedyna widoczna sekcja: Klucz licencyjny. Wklej do niej klucz i kliknij Sprawdź licencję.

    To normalne, że poza tą sekcją nie ma na razie nic więcej — program odsłania ustawienia stopniowo.

    Pole na klucz licencyjny i przycisk Sprawdź licencję.
    Pole na klucz licencyjny i przycisk Sprawdź licencję.
  10. Po licencji pojawiają się dwie sekcje — i to na razie wszystko

    Po pozytywnym sprawdzeniu klucza dochodzą dokładnie dwie sekcje:

    • Połączenie z Subiekt,
    • Zdalna pomoc.

    Reszta ustawień (zamówienia, dokumenty, produkty, stany, mapowania, KSeF) nadal jest schowana. To nie jest błąd — sekcje odsłaniają się dwustopniowo i drugi stopień otwiera dopiero udany test połączenia z Subiektem.

  11. Uzupełnij Połączenie z Subiekt

    Wypełnij po kolei: Server SQL, Autentykacja Windows (albo Użytkownik SQL i Hasło SQL), Nazwa bazy danych, Login operatora i Hasło operatora.

    Nazwy baz i loginy operatorów możesz wciągnąć z serwera przyciskami Wczytaj z serwera i Wczytaj operatorów zamiast wpisywać je ręcznie. Przycisk Test połączenia SQL sprawdza sam dostęp do bazy.

    Szczegółowy opis każdego pola znajdziesz w poradniku Połączenie z Subiektem GT (Sfera).

    Pole Nazwa bazy danych z przyciskami Wczytaj z serwera i Test połączenia SQL.
    Pole Nazwa bazy danych z przyciskami Wczytaj z serwera i Test połączenia SQL.
  12. Kliknij Test połączenia SFERA

    Zanim klikniesz — aktywuj Sferę w Subiekcie GT. Bez tego test nie ma prawa się udać.

    Po udanym teście program pokaże potwierdzenie razem z numerem NIP podmiotu — to najlepszy dowód, że połączyłeś się z właściwą firmą.

    Jeśli mimo aktywowanej Sfery test zwraca błąd, zamknij wszystkie okna Subiekta (pomaga przycisk Zresetuj subiekta obok) albo zrestartuj komputer.

    Przyciski Test połączenia SFERA i Zresetuj subiekta.
    Przyciski Test połączenia SFERA i Zresetuj subiekta.
  13. Dopiero teraz widać całą resztę konfiguracji

    Po zielonym teście Sfery rozwijają się wszystkie pozostałe sekcje: OMS, Tworzenie i obsługa ZK, stany magazynowe, produkty, Wystawianie dokumentów, mapowania, pola własne, kontrahenci, KSeF i pozostałe.

    Jeżeli ktoś pyta dlaczego nic nie widzę — w 9 przypadkach na 10 odpowiedź brzmi: test Sfery jeszcze nie przeszedł.

    Jest jeszcze druga droga: przycisk Sprawdź token Sellasist (albo Sprawdź token Baselinker) z górnego paska. Udane sprawdzenie tokenu również odsłania resztę ustawień — ale połączenie z Subiektem i tak musi w końcu zadziałać, żeby cokolwiek powstało w Subiekcie.

  14. Zapisz zmiany

    Ustawienia zapisujesz przyciskiem Zapisz zmiany z górnego paska. Program zapyta Zapisać zmiany? i po potwierdzeniu przyciskiem Zapisz i uruchom ponownie uruchomi się ponownie, żeby zmiany weszły w życie.

    Obok jest przycisk Zapisz Bez walidacji — pomija sprawdzanie poprawności ustawień. Używaj go tylko wtedy, gdy naprawdę wiesz, dlaczego zwykły zapis nie przechodzi.

  15. Doprowadź do pierwszego dokumentu

    Żeby zobaczyć efekt end-to-end:

    1. W sekcji Wystawianie dokumentów (faktury, paragony, WZ) włącz Włącz moduł wystawiania dokumentów.
    2. W sekcji Tworzenie i obsługa ZK (Zamówień Klienta) ustaw statusy, na których mają powstawać zamówienia.
    3. W OMS twórz zawsze serie faktur — nigdy serie paragonów. To prefiks serii faktur decyduje, jaki dokument powstanie w Subiekcie.
    4. Zapisz zmiany, przestaw testowe zamówienie w OMS na ustawiony status i sprawdź, czy w Subiekcie powstało ZK, a po nim dokument.
    Główny przełącznik modułu wystawiania dokumentów.
    Główny przełącznik modułu wystawiania dokumentów.
  16. Sprawdź również

Czy ten artykuł był pomocny?

Podgląd zdjęcia