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ł Cloud TSE, 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”).

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 sporządzeniu dokumentu EndOfDay, a następnie podejmowana jest próba przeprowadzenia wymiany;
  • od 3 dni przed wygaśnięciem podejmowana jest próba wymiany po każdym dokumencie (nie tylko po EndOfDay); wszelkie otwarte transakcje są automatycznie zamykane;
  • jeżeli certyfikat już wygasł: podejmowana jest próba wymiany przed każdym wywołaniem funkcji createDocument.

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 uszkodzonych 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 uszkodzonego modułu TSE na nowy.

W przypadku modułów TSE o statusie „DEFECTIVE” aplikacja Fiscal Client przeprowadza wymianę 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”).

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 pomocniczy 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łów TSE („Włącz automatyczną wymianę modułów TSE”)

Wybór modułu TSE do wymiany

Dla każdego modułu TSE zdefiniowanego w konfiguracji (główny moduł TSE i rezerwowy 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 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 straci ważność, 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 Cloud 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).

Clienti, 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 zaistnieć konieczność kilkukrotnego uruchomienia 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 w celu aktualizacji 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),
• wyświetlane 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łączone),
• Powiadomienia dotyczące PushConfiguration (konfiguracja została pobrana przez odpowiedniego klienta lub nie można jej było przeprowadzić).

Zdarzenia dziennika

Dostęp do dziennika „Zdarzenia dziennika” 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.