Pierwsze uruchomienie AB Connect — 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ń.

1. Przygotuj sobie dane

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

   • klucz licencyjny otrzymany od AppsBusters,
   • 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. Uruchom AB Connect Guard

   Guard to okno, w którym ustawiasz podstawy i z którego uruchamiasz integrator. Po pierwszym starcie 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ę.

3. Wypełnij sekcję KONFIGURACJA INTEGRATORA

   Przejdź do sekcji Konfiguracja i uzupełnij cztery pola:

   • Aplikacja — wskaż OMS, z którym pracujesz.
   • ERP — wybierz Subiekt.
   • Baza danych — nazwa bazy firmy (podmiotu) z Subiekta GT.
   • Port — numer, pod którym otworzysz panel w przeglądarce. Domyślnie 5000. Zmieniaj tylko wtedy, gdy na tym komputerze pracuje już druga firma.

   Na koniec kliknij Zapisz konfigurację. Program potwierdzi komunikatem Zapisano konfigurację.

4. 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 obok programu. Zostaw dla zgodności ze starszymi instalacjami.

   Po wybraniu SQL Server uzupełnij Instancja SQL (np. .\INSERTGT albo SERWER\INSTANCJA) oraz sposób logowania: zaznacz Autentykacja Windows albo wpisz Login SQL i hasło. Kliknij Testuj połączenie — nie idź dalej, dopóki wynik nie jest pozytywny.

   Pole Zaimportuj konfigurację ze starego ABConnect (SQLite) zaznacz wyłącznie wtedy, gdy przechodzisz ze starego programu. Przy nowej instalacji zostaw je odznaczone. Zapisz zmiany przyciskiem Zapisz konfigurację.

5. Wybierz tryb autostartu i uruchom integrator

   W sekcji USŁUGA / AUTOSTART kliknij Zainstaluj. Otworzy się okno Wybierz tryb autostartu z dwiema możliwościami:

   • A) AB Connect Guard pilnuje integratora — ZALECANE — nie wymaga podawania hasła, ale ktoś musi być zalogowany do Windowsa, żeby integrator wstał po restarcie komputera.
   • B) Twoje konto Windows — działa 24/7 (wymaga hasła) — integrator pracuje także bez zalogowanego użytkownika, ale trzeba raz podać hasło Windows, a po każdej jego zmianie powtórzyć instalację.

   Po instalacji kliknij Start. Kropka statusu u góry zrobi się zielona, a integrator wystartuje po chwili.

   Chcesz tylko sprawdzić konfigurację, bez instalowania niczego na stałe? Użyj karty TRYB BEZ AUTOSTARTU / USŁUGI — DOBRY DO TESTÓW i przycisku Uruchom integrator (test). Integrator działa wtedy tylko dopóki to okno jest otwarte.

6. 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.

7. 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ę.

8. 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.

9. 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.

10. 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.

11. 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.

12. 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.

13. 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.

14. 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.