Pierwsze uruchomienie i instalacja

Co przygotować przed startem, jaki tryb instalacji wybrać i w jakiej kolejności skonfigurować aplikację, żeby zacząć wystawiać e-paragony.

1. Co potrzebujesz

   Zanim zaczniesz, przygotuj:

   • Drukarkę fiskalną z modułem online (e-paragon) — Novitus, Posnet albo Elzab.
   • Klucz licencyjny od AppsBusters.
   • Komputer z Windows 10/11 w tej samej sieci co drukarka.
   • Konto API do Sellasist albo Baselinker (tryb sklepu) lub dostęp do bazy SQL Twojego programu księgowego (tryb ERP).

   Drukarki bez modułu online nie obsłużą e-paragonów — to fizyczna funkcja drukarki, nie ustawienie.

2. Wybierz tryb instalacji

   Instalator pyta o sposób uruchamiania:

   • Wersja okienkowa — aplikacja działa w oknie na pulpicie, gdy ktoś jest zalogowany. Z tej wersji korzysta większość klientów; sprawdza się przy zwykłych instalacjach biurowych.
   • Wersja w tle — aplikacja działa cały czas w tle, a ustawienia otwierasz w przeglądarce. Nadaje się na komputer, który stoi non stop i obsługuje drukarkę.

   Dla wersji w tle instalator zapyta jeszcze, na jakim koncie ma działać (patrz kolejny krok). Każdą opcję opisuje prostym językiem i z góry zaznacza zalecaną — w razie wątpliwości rozwiń opis przy danej opcji.

3. Wersja w tle — na jakim koncie ma działać

   Przy wersji w tle wybierasz, jak aplikacja ma się uruchamiać:

   • Usługa systemowa (zalecana) — działa całą dobę bez hasła i bez logowania, rusza od razu po włączeniu komputera. Nie ma dostępu do baz ERP przez konto Windows — jeśli pobierasz paragony z Subiekta / Nexo / Optimy, połączenie do bazy musi używać loginu i hasła SQL.
   • Usługa na koncie użytkownika (z hasłem) — działa całą dobę bez logowania i ma dostęp do baz ERP przez konto Windows, ale wymaga podania hasła do tego konta.
   • Pod opieką Guarda — aplikacją opiekuje się „opiekun” z ikonką przy zegarku (bez hasła, z dostępem do ERP przez konto Windows). Startuje jednak dopiero po zalogowaniu użytkownika.
   • Uruchamianie przy zalogowaniu — bez hasła, również rusza dopiero po zalogowaniu.

   Wybór zależy od tego, jak działa Twój komputer i jak łączysz się z bazą ERP.

4. Serwer lub komputer bez logowania po restarcie

   Najważniejsze pytanie: czy aplikacja ma wystawiać paragony także wtedy, gdy nikt nie jest zalogowany w Windows? Typowy przypadek to serwer, który po restarcie (np. po nocnych aktualizacjach) zostaje na ekranie logowania i nikt się na niego nie loguje.

   W takiej sytuacji wybierz opcję, która startuje razem z Windows, bez logowania — czyli usługę:

   • Usługa systemowa — najprościej, bez hasła, rusza od razu po włączeniu komputera. Do Subiekta / Nexo / Optimy połączenie z bazą musi używać loginu i hasła SQL.
   • Usługa na koncie użytkownika (z hasłem) — gdy łączysz się z ERP przez konto Windows. Działa całą dobę bez logowania, ale wymaga zapisanego hasła.

   Pozostałe opcje (uruchamiane dopiero przy zalogowaniu) oraz wersja okienkowa nie wstaną, dopóki ktoś się nie zaloguje — nie nadają się na serwer bez stałego logowania.

5. Kilka firm na jednym komputerze

   Prowadzisz kilka firm? Możesz zainstalować osobną, w pełni niezależną kopię aplikacji dla każdej z nich (tylko wersja w tle). Podczas instalacji instalator pyta o nazwę kopii — wpisz np. nazwę firmy.

   Obsługujesz jedną firmę? Zostaw pole puste i kliknij Dalej. Instalator sam wykrywa kopie zainstalowane na komputerze i podpowiada je na liście (wybierz z listy, aby zaktualizować istniejącą), a dla nowej kopii proponuje pierwszy wolny port.

   Każda nazwana kopia ma własne ustawienia, własną bazę paragonów, własny adres ustawień w przeglądarce (np. localhost:5050 i localhost:5051) oraz własną ikonkę przy zegarku podpisaną nazwą firmy. Każda firma potrzebuje własnej licencji i własnej drukarki fiskalnej (drukarka jest zarejestrowana na konkretny NIP).

   Odinstalowanie jednej firmy nie rusza pozostałych, a baza paragonów zawsze zostaje na dysku. Aktualizacje działają niezależnie dla każdej kopii.

6. Pierwsze uruchomienie — kolejność konfiguracji

   Po instalacji otwórz ustawienia aplikacji (w wersji okienkowej — z ikony przy zegarku; w wersji w tle — w przeglądarce). Po lewej masz spis Sekcje, który prowadzi przez kolejne karty. Zalecana kolejność:

   1. W sekcji Licencja wpisz klucz i kliknij Sprawdź Licencję. Reszta sekcji odblokuje się dopiero po poprawnej licencji.
   2. W sekcji OMS wybierz system (Sellasist / Baselinker), wpisz token API i kliknij Sprawdź Połączenie.
   3. W sekcji Drukarka wybierz protokół, wpisz adres IP i kliknij Wyślij Ustawienia do Drukarki.
   4. Opcjonalnie skonfiguruj ERP, zwykły wydruk, wysyłkę mailem, personalizację.
   5. Kliknij wielki przycisk ▶ Włącz Fiskalizację w sekcji Drukarka.
   6. Na końcu kliknij 💾 Zapisz Ustawienia (pasek zapisu pojawia się u góry, gdy masz niezapisane zmiany).

   Sprawdź lewy dolny róg menu — powinno świecić zielonym napisem Fiskalizacja WŁĄCZONA. To pole jest też przełącznikiem: jedno kliknięcie włącza lub wyłącza fiskalizację od razu.

7. Folder z danymi

   Wszystkie ustawienia, baza paragonów i logi zapisują się w C:\ProgramData\ABFiscalEparagon (nazwana kopia dla dodatkowej firmy: C:\ProgramData\ABFiscalEparagon-NazwaKopii). Folder zostaje nawet po deinstalacji — przy ponownej instalacji odzyskasz swoje dane.

8. Uwaga na stare zamówienia w OMS / ERP

   Przy pierwszym uruchomieniu, jeśli w sklepie lub ERP są stare niezafiskalizowane zamówienia z poprzednich tygodni, aplikacja od razu zacznie je wszystkie wystawiać.

   Jeśli nie chcesz tego:

   • Sellasist — użyj karty Reset starych paragonów (przed startem) w sekcji OMS (osobny poradnik Wstrzymane paragony i reset kolejki).
   • Baselinker — oznacz stare zamówienia jako już wydrukowane po swojej stronie.
   • Tryb ERP — ustaw Datę rozpoczęcia fiskalizacji na dziś, żeby pominąć starsze dokumenty.

   Zalecamy włączać fiskalizację rano w spokojnym czasie, żeby na spokojnie obserwować pierwsze e-paragony.