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ń.
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).
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.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.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.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.
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.
.\INSERTGTalboSERWER\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.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.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.
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ę.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.
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.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.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.
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.
Doprowadź do pierwszego dokumentu
Żeby zobaczyć efekt end-to-end:
- W sekcji Wystawianie dokumentów (faktury, paragony, WZ) włącz Włącz moduł wystawiania dokumentów.
- W sekcji Tworzenie i obsługa ZK (Zamówień Klienta) ustaw statusy, na których mają powstawać zamówienia.
- W OMS twórz zawsze serie faktur — nigdy serie paragonów. To prefiks serii faktur decyduje, jaki dokument powstanie w Subiekcie.
- 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.Sprawdź również
- Kreator wdrożenia — szybka konfiguracja krok po kroku — szybsza droga dla nowego wdrożenia, 8 kroków zamiast całego konfiguratora.
- Połączenie z Subiektem GT (Sfera) — opis każdego pola i przycisku z sekcji połączenia.
- Wybór trybu autostartu — który tryb wybrać dla swojego komputera lub serwera.
- Integrator nie działa — co sprawdzić, gdy po starcie nic się nie dzieje.