Konfiguracja modułu KSeF: Różnice pomiędzy wersjami

← poprzednia edycja następna edycja →

@@ Linia 169: / Linia 169: @@
 Jest on używany wyłącznie w trybach szczególnych (offline / awaryjnych) i '''nie zastępuje''' certyfikatu lub tokena skonfigurowanego dla operatora.
 |}
+== Ustawienia usługi synchronizacji KSeF ==
+Aplikacja '''Rejestr KSeF''' umożliwia konfigurację lokalnej usługi synchronizacji KSeF (WebAPI), która odpowiada za komunikację z KSeF oraz przetwarzanie danych w tle.
+Aby usługa działała poprawnie i uruchamiała się automatycznie razem z aplikacją, należy uzupełnić jej konfigurację oraz zapisać ustawienia.
+Po zapisaniu konfiguracji aplikacja przy starcie automatycznie uruchamia usługę synchronizacji.
+Jeżeli konfiguracja nie zostanie zapisana, usługa '''nie uruchomi się automatycznie'''.
+Opcja '''Ustawienia usługi synchronizacji KSeF''' dostępna jest w oknie konfiguracji KSeF.
+[[Plik:RejestrKSeF ustawienia synchronizacji.png|ramka|brak|Ustawienia usługi synchronizacji KSeF]]
+=== Wymagane pola konfiguracji ===
+Poniższe pola są obowiązkowe – bez ich uzupełnienia konfiguracja nie zostanie zapisana.
+{| class="wikitable"
+|-
+! Pole w formularzu
+! Co wpisać
+! Uwagi
+|-
+| '''Port HTTP usługi'''
+| Domyślnie ''5293''
+| Lokalny port (localhost). Musi być wolny – jeśli jest zajęty, usługa nie wystartuje.
+|-
+| '''Limit oczekiwania na start [s]'''
+| Najczęściej ''30'' lub ''60''
+| Czas (w sekundach), przez jaki aplikacja czeka na uruchomienie usługi.
+|-
+| '''Środowisko KSeF'''
+| ''Test'', ''Demo'' lub ''Prod''
+| Określa środowisko Ministerstwa Finansów, z którym łączy się system.
+|-
+| '''Tryb pracy usługi'''
+| Najczęściej ''Production''
+| W środowisku produkcyjnym należy ustawić tryb ''Production''. Tryb ''Development'' używany jest w testach.
+|-
+| '''Użytkownik'''
+| Użytkownik Firebird
+| Najczęściej ''SYSDBA'' lub konto techniczne.
+|-
+| '''Hasło'''
+| Hasło użytkownika Firebird
+| Pole może być puste tylko jeśli konfiguracja Firebird na to pozwala.
+|-
+| '''Baza / plik'''
+| Ścieżka do pliku bazy
+| Np. ''E:\bazyfb3\IS_KSEF_SYNC.gdb''
+|-
+| '''Host / DataSource'''
+| ''localhost'' lub adres serwera
+| Adres serwera Firebird.
+|-
+| '''Port bazy'''
+| Najczęściej ''3050''
+| Standardowy port Firebird.
+|-
+| '''Charset'''
+| Najczęściej ''UTF8''
+| Powinien być zgodny z konfiguracją bazy.
+|-
+| '''ServerType'''
+| Najczęściej ''0''
+| Parametr techniczny połączenia Firebird.
+|-
+| '''Dialect'''
+| Najczęściej ''3''
+| Zalecany dla nowych baz.
+|-
+| '''Klucz szyfrowania danych logowania'''
+| Generowany automatycznie
+| Służy do zabezpieczenia danych dostępowych. Nie należy go zmieniać ręcznie.
+|}
+Po uzupełnieniu danych należy zapisać konfigurację przyciskiem '''Zapis'''.
+=== Uruchamianie usługi ===
+Po zapisaniu konfiguracji można uruchomić usługę przyciskiem:
+* '''Uruchom serwis'''
+Po poprawnym uruchomieniu usługa będzie startować automatycznie razem z aplikacją '''Rejestr KSeF'''.
+Jeżeli usługa nie zostanie skonfigurowana lub zapis się nie powiedzie:
+* serwis nie uruchomi się automatycznie,
+* komunikacja z KSeF może nie działać poprawnie.
+=== Baza synchronizacji KSeF ===
+Usługa synchronizacji korzysta z osobnej bazy danych Firebird.
+Baza ta służy do:
+* przechowywania danych technicznych,
+* kolejkowania operacji,
+* synchronizacji z KSeF.
+==== Wymagania ====
+Aby usługa działała poprawnie:
+* użytkownik Firebird musi mieć możliwość logowania do serwera,
+* użytkownik powinien mieć uprawnienia do tworzenia bazy i tabel,
+* wskazana ścieżka do bazy musi być dostępna dla serwera Firebird.
+==== Pierwsze uruchomienie ====
+Przy pierwszym uruchomieniu usługi system automatycznie:
+* tworzy bazę synchronizacji (jeżeli nie istnieje),
+* zakłada wymagane tabele,
+* przygotowuje strukturę do pracy z KSeF.
+Jeżeli użytkownik Firebird nie ma odpowiednich uprawnień:
+* usługa nie uruchomi się poprawnie,
+* szczegóły błędu będą widoczne w logach usługi.
 == Uzyskiwanie certyfikatów i tokenów KSeF ==