W niniejszym artykule opisano sposób konfiguracji automatycznej wymiany certyfikowanego technicznego urządzenia zabezpieczającego (TSE/TSS).

Wymiana urządzenia TSE może okazać się konieczna w pewnych okolicznościach, takich jak:

• gdy certyfikat używanego urządzenia TSE wkrótce straci ważność,
  • oraz preferowana jest zmiana producenta urządzenia TSE,
• hardware TSE jest uszkodzone i nie nadaje się już do użytku,
• gdy Cloud TSE zostało oznaczone przez odpowiedniego producenta jako „wadliwe” i nie można z niego już korzystać.

RetailForce oferuje usługę umożliwiającą automatyczną wymianę modułu TSE. Wymianę można skonfigurować w taki sposób, aby:

• jako nowy moduł TSE zostanie wykorzystany moduł tego samego producenta lub
• od innego producenta.

W artykule „Test – automatyczna wymiana modułu TSE” wyjaśniono, jak przetestować funkcję automatycznej wymiany modułu TSE.

Kryteria wymiany modułu TSE

Warunki wstępne automatycznej wymiany

Usługa fiskalna może przeprowadzić wymianę wyłącznie pod pewnymi warunkami:

• Wersja
  • Należy zainstalować wersję 1.11.18 oprogramowania Fiscal Middleware.
• FiscalCountry
  • Automatyczna wymiana modułu TSE jest oczywiście możliwa wyłącznie w przypadku systemów niemieckich.
• Konfiguracja
  • Automatyczną wymianę modułu TSE należy skonfigurować i włączyć w odpowiednim kliencie.
• Dostępność
  • Jeśli do wymiany ma zostać użyty hardware TSE, w systemie musi być również dostępny nowy hardware TSE (podłączony);
  • jeżeli do wymiany ma zostać wykorzystany moduł TSE w chmurze, musi istnieć możliwość nawiązania połączenia internetowego z odpowiednim producentem.
• Otwarte transakcje
  • Nie mogą występować żadne otwarte transakcje (została wykonana funkcja createDocument, ale transakcja nie została jeszcze sfinalizowana za pomocą funkcji storeDocument lub cancelDocument).
• Zakończenie dnia (EndOfDay)
  • Automatyczna wymiana odbywa się dopiero po zamknięciu dnia (zarejestrowano dokument typu: „[99] = EndOfDay”).
• Licencje
  • Licencja na aktualny TSE;
  • Licencja dla nowego TSE (jeśli różni się od obecnie używanego TSE);
  • Licencja na wymianę modułu TSE („TSE Change”).

Uwaga: automatyczna wymiana modułu TSE nie zostanie przeprowadzona, jeśli **którykolwiek z warunków wstępnych** nie zostanie spełniony. Informacje na temat wyjątków znajdują się w sekcjach „Wygasnięcie certyfikatu” oraz „Uszkodzony moduł TSE”.

Uwaga: aby otrzymywać powiadomienia o statusie dotyczące automatycznej wymiany modułu TSE za pośrednictwem poczty elektronicznej, zalecamy wybranie „osoby kontaktowej ds. technicznych” w RetailForce portalu (ustawienie w sekcji „Organizacja”: „Osoba kontaktowa ds. technicznych”).

Licencje

Ustawienia dotyczące wymiany modułu TSE można skonfigurować w dowolnym momencie. Jednak aby wymiana faktycznie miała miejsce, należy przypisać odpowiednie licencje.

• Wymiana modułu TSE: ta licencja jest niezbędna do przeprowadzenia samej wymiany,
• Licencje TSE: dla każdego skonfigurowanego modułu TSE (głównego i pomocniczego) należy również przypisać odpowiednią licencję.

Warunki uruchomienia wymiany TSE

Jeśli skonfigurowano i włączono automatyczną wymianę modułu TSE, RetailForce system podejmie próbę (!) przeprowadzenia automatycznej wymiany w przypadku wystąpienia następujących zdarzeń:

• Certyfikat TSE stracił ważność lub wygaśnie w określonym przedziale czasowym,
• urządzenie TSE jest uszkodzone (np. przestało działać, zostało oznaczone przez producenta jako „USZKODZONE”).

Wygasnięcie certyfikatu

W przypadku wygaśnięcia certyfikatu aktualnie używanego modułu TSE oraz włączenia funkcji automatycznej wymiany obowiązuje następująca sekwencja zdarzeń:

• 14 dni przed wygaśnięciem certyfikatu: jeśli nie ma żadnych otwartych transakcji TSE, klient fiskalny podejmuje próbę przeprowadzenia automatycznej wymiany po zamknięciu dnia (dokument EndOfDay);
• jeżeli wymiana nie mogła zostać pomyślnie przeprowadzona w ciągu pierwszych 7 dni (okres od 14 do 7 dni przed wygaśnięciem certyfikatu):
  • od 7 dni przed wygaśnięciem certyfikatu otwarte transakcje są automatycznie zamykane przez klienta po zakończeniu dnia (EndOfDay), a następnie podejmowana jest próba przeprowadzenia wymiany;
  • począwszy od 3 dni przed wygaśnięciem podejmowana jest próba wymiany po każdym dokumencie (nie tylko po operacji EndOfDay); wszelkie otwarte transakcje są automatycznie zamykane;
  • jeżeli certyfikat już stracił ważność: podejmowana jest próba wymiany przed każdym wywołaniem funkcji createDocument.

Uwaga: W ciągu 14-dniowego okresu klient fiskalny sprawdza w każdej chmurze/połączeniu, czy spełnione są kryteria wymiany, i podejmuje próbę wymiany modułu TSE.

Uszkodzony moduł TSE

Do wadliwych modułów TSE zaliczają się na przykład moduły hardware TSE, które nie są już rozpoznawane przez system, lub przypadki, w których moduł fiskalny TSE został ustawiony w statusie „DEFECTIVE” i nie może być już używany.

W przypadku wadliwych modułów TSE obowiązują te same zasady, co w sytuacji, gdy certyfikat modułu TSE już stracił ważność. Przed każdą operacją createDocument klient podejmuje próbę wymiany wadliwego modułu TSE na nowy.

Uwaga: W tym przypadku nadal otwartych transakcji nie można już zamknąć, ponieważ na starym TSE nie można już generować podpisów, a nowe TSE „nie ma wiedzy o starych, otwartych transakcjach” (ponieważ transakcje te nie zostały zainicjowane na nowym TSE, lecz na starym).

W przypadku modułów TSE o statusie „DEFECTIVE” aplikacja Fiscal Client dokonuje wymiany natychmiast po wywołaniu punktu końcowego cloud/connect (lub innego punktu końcowego, który wymaga przesłania kluczy cloudApiKey i cloudApiSecret).

Dotyczy to wyłącznie sytuacji, w której zaznaczone jest checkbox „Włącz automatyczną wymianę modułów TSE” (patrz rozdział „Konfiguracja”).

Uwaga: W przypadku wadliwych TSE fiskaly Cloud zalecamy najpierw przeprowadzenie lub przetestowanie wymiany na jednym działającym systemie (client).

Konfiguracja

Automatyczna wymiana modułów TSE jest definiowana w ramach konfiguracji dla Niemiec.

Od release 1.11.18 w portalu dostępne są następujące opcje konfiguracyjne:

• Wybór modułu TSE do wymiany (główny moduł TSE i rezerwowy moduł TSE)
  • „Użyj dla nowych klientów” – podczas pierwszej inicjalizacji nowego klienta wykorzystywany jest moduł TSE tego typu,
  • „Użyj do wymiany” – gdy ma zostać przeprowadzona wymiana, wykorzystywany jest TSE tego typu.
• Opcja włączenia automatycznej wymiany modułu TSE („Włącz automatyczną wymianę modułu TSE”)

Uwaga: automatyczna wymiana TSE zostanie aktywowana dopiero po zaznaczeniu checkboxa „Włącz automatyczną wymianę TSE”!

Wybór modułu TSE do wymiany

Dla każdego modułu TSE zdefiniowanego w konfiguracji (główny moduł TSE i pomocniczy moduł TSE) można określić, który z tych modułów powinien być używany podczas pierwszego uruchomienia oraz w przypadku wymiany.

Możliwe ustawienia

Możliwe są następujące kombinacje:

Ten sam moduł TSE do wymiany

W tym przypadku zarówno podczas pierwszego uruchomienia, jak i w razie konieczności wymiany wykorzystywany jest ten sam moduł TSE. W tym celu należy:

• Skonfigurować TSE główne lub TSE pomocnicze,
• oraz ustawić dla tego TSE obie opcje („Użyj dla nowych klientów” i „Użyj w przypadku wymiany”).

W poniższym przykładzie jako dodatkowy moduł TSE skonfigurowano moduł typu „[3] = Swissbit Cloud 2.0”, z zaznaczonymi obiema opcjami.

Oznacza to, że każdy terminal, któremu przypisano tę konfigurację, korzysta z modulu Swissbit Cloud TSE 2.0 podczas aktywacji. Jeśli na przykład certyfikat aktywowanego modułu TSE wygaśnie, aktywowany zostanie nowy moduł Swissbit Cloud TSE 2.0.

Jak opisano powyżej, wymiana nastąpi tylko wtedy, gdy zaznaczone jest również pole wyboru „Włącz automatyczną wymianę TSE”!

Inny moduł TSE do wymiany

W tym przypadku dla pierwszego uruchomienia skonfigurowano konkretny moduł TSE („Użyj dla nowych klientów”), a na wypadek wymiany skonfigurowano moduł TSE innego producenta. W tym celu należy:

• skonfigurować dwa moduły TSE, z których oba
  • główny moduł TSE oraz
  • dodatkowe TSE
• ustawić opcję „Użyj dla nowych klientów” dla jednego urządzenia TSE oraz 
• opcję „Użyj w przypadku wymiany” dla drugiego urządzenia TSE

W poniższym przykładzie terminale są uruchamiane przy użyciu TSE pomocniczego (Fiskaly Cloud TSE). Jeśli zostaną spełnione kryteria automatycznej wymiany TSE, zostanie aktywowany nowy TSE typu Swissbit Cloud TSE 2.0, który będzie używany od tego momentu.

Dystrybucja konfiguracji

Dostępne są dwie opcje dystrybucji nowej konfiguracji do wszystkich klientów, którzy już prowadzą działalność:

• Uruchomienie automatycznego rozpowszechniania z portalu chmurowego za pomocą przycisku „Push Configuration TSE” lub
• zaktualizować konfigurację klienta za pomocą polecenia PUT /api/v1/management/clients/byCloud/{clientId}.

W obu przypadkach nowa konfiguracja – zawierająca reguły dotyczące wymiany modułu TSE – zostanie przesłana do klienta (klientów).

Push Configuration TSE

Przycisk ten znajduje się jako action item w menu „Configuration” po wybraniu (kliknięciu) odpowiedniej konfiguracji.

Po naciśnięciu przycisku zachowanie różni się w zależności od tego, czy chodzi o klientów lokalnych (lokalna instalacja middleware), czy o klientów korzystających z usługi Cloud Fiscalisation Service:

Działanie w przypadku lokalnej instalacji middleware

Przycisk ten służy wyłącznie do dystrybucji konfiguracji i aktywacji automatycznej wymiany modułu TSE!

Po naciśnięciu przycisku do wszystkich podłączonych klientów wysyłane jest polecenie pobrania aktualnej konfiguracji z portalu. W tym kontekście termin „podłączone” oznacza: klientów, którym ta konfiguracja została przypisana bezpośrednio lub pośrednio (poprzez organizację, firmę lub sklep).

Clients, którzy w danym momencie nie mają aktywnego połączenia z chmurą (brak aktywnego połączenia z portalem poprzez „Cloud/Connect”), NIE otrzymają nowej konfiguracji.

W związku z tym może być konieczne kilkukrotne uruchomienie funkcji „Push Configuration TSE”, aż wszyscy klienci pobiorą konfigurację.

Każdy klient zgłasza do portalu pomyślne pobranie konfiguracji. Powiadomienie jest wyświetlane za pomocą ikony dzwonka (w prawym górnym rogu). Widok pulpitu nawigacyjnego „Wymiana TSE” zapewnia również przegląd statusu wymiany modułu TSE (patrz artykuł: Pulpit nawigacyjny Niemcy – Informacje o TSE).

Działanie usługi fiskalizacji w Cloud

Podobnie jak w przypadku instalacji lokalnej, uruchamiane jest tutaj polecenie mające na celu aktualizację konfiguracji na klientach. Polecenie to jest jednak dostarczane dopiero przy następnym wywołaniu funkcji „cloud/connect” przez klienta.

Portal „zapamiętuje” status polecenia (który client nie jest obecnie podłączony, a który już pobrał konfigurację).

Oznacza to, że w przypadku usługi fiskalizacji w chmurze nie ma konieczności ponownego uruchamiania funkcji „Push Configuration TSE”.

Powiadomienia

Powiadomienia i komunikaty dotyczące wymiany modułu TSE są:

- wyświetlane za pomocą ikony dzwonka w portalu (w prawym górnym rogu),
- widoczne w dzienniku zdarzeń (dla każdego terminala) oraz-
wysyłane pocztą elektroniczną.

Dzwonek

Ikona dzwonka wyświetla następujące rodzaje komunikatów:

- Hardware TSE nie jest dostępny w danym systemie (nie jest podłączony),
- Powiadomienia dotyczące funkcji PushConfiguration (konfiguracja została pobrana przez danego klienta lub nie można jej było przeprowadzić).

Zdarzenia w dzienniku

Dostęp do dziennika „Zdarzenia w dzienniku” można uzyskać poprzez odpowiednią action item na każdym terminalu. Zawiera on wszystkie zdarzenia związane z wymianą modułu TSE na danym terminalu.

Powiadomienia e-mail

Komunikaty o powodzeniu i błędach mogą być również wysyłane pocztą elektroniczną. Powiadomienia e-mailowe są wysyłane wyłącznie wtedy, gdy w portalu wybrano osobę kontaktową ds. technicznych (ustawienie w sekcji „Organizacja”: „Osoba kontaktowa ds. technicznych”).

Wiadomości są wysyłane partiami, co godzinę.

Ten artykuł został przetłumaczony automatycznie.