Tento článek popisuje, jak nakonfigurovat automatickou výměnu certifikovaného technického bezpečnostního zařízení (TSE/TSS).

Výměna TSE může být nezbytná za určitých okolností, například:

• pokud se blíží konec platnosti certifikátu pro používané TSE
  • a je preferován přechod k jinému výrobci TSE,
• hardwarové TSE je vadné a již jej nelze používat,
• cloudové TSE bylo příslušným výrobcem označeno jako „vadné“ a již jej nelze používat.

RetailForce poskytuje službu, která umožňuje automatickou výměnu TSE. Výměnu lze nakonfigurovat tak, aby:

• bude jako nový TSE použit TSE od stejného výrobce nebo
• jako nový TSE byl použit TSE od jiného výrobce.

Článek „Test – Automatická výměna TSE“ vysvětluje, jak otestovat funkci automatické výměny TSE.

Kritéria pro výměnu TSE

Předpoklady pro automatickou výměnu

Služba Fiscal Service může výměnu provést pouze za určitých podmínek:

• Verze
  • Musí být nainstalována verze 1.11.18 fiskálního middlewaru.
• FiscalCountry
  • Automatická výměna TSE je samozřejmě možná pouze u německých systémů.
• Konfigurace
  • Automatická výměna TSE musí být nakonfigurována a povolena v příslušném klientovi.
• Dostupnost
  • Pokud má být k výměně použito hardwarové TSE, musí být v systému k dispozici také nové hardwarové TSE (zapojené);
  • má-li být k výměně použita Cloud TSE, musí být možné navázat internetové připojení k příslušnému výrobci.
• Otevřené transakce
  • Nesmí existovat žádné otevřené transakce (byla provedena funkce createDocument, ale transakce ještě nebyla dokončena pomocí funkce storeDocument nebo cancelDocument).
• Konec dne (EndOfDay)
  • Automatická výměna se provede až po denním uzavření (byl zaúčtován doklad typu: „[99] = EndOfDay“).
• Licence
  • Licence pro aktuální TSE;
  • Licence pro nový TSE (pokud se liší od aktuálně používaného TSE);
  • Licence pro výměnu TSE („TSE Change“).

Licence

Nastavení pro výměnu TSE lze konfigurovat kdykoli. Aby však k výměně skutečně došlo, musí být přiřazeny správné licence.

• Výměna TSE: tato licence je nezbytná k tomu, aby k výměně vůbec mohlo dojít,
• Licence TSE: pro každé nakonfigurované zařízení TSE (primární i sekundární TSE) musí být rovněž přiřazena odpovídající licence.

Spouštěč výměny TSE

Je-li nakonfigurována a povolena automatická výměna TSE, systém RetailForce se pokusí (!) provést automatickou výměnu, jakmile dojde k následujícím událostem:

• Platnost certifikátu TSE vypršela nebo vyprší v rámci stanoveného časového okna,
• TSE je vadné (např. již nefunguje, bylo výrobcem označeno jako „DEFECTIVE“).

Vypršení platnosti certifikátu

Následující postup platí v případě, že vyprší platnost certifikátu aktuálně používaného TSE a je povolena automatická výměna:

• 14 dní před vypršením platnosti certifikátu: pokud nejsou žádné otevřené transakce TSE, fiskální klient se pokusí provést automatickou výměnu po denním uzavření (dokument EndOfDay);
• pokud se výměnu nepodařilo úspěšně provést během prvních 7 dnů (období od 14 do 7 dnů před vypršením platnosti certifikátu):
  • od 7 dnů před vypršením platnosti certifikátu klient po dokumentu EndOfDay automaticky uzavře otevřené transakce a pokusí se provést výměnu;
  • od 3 dnů před vypršením platnosti se provede pokus o obnovení po každém dokumentu (nejen po EndOfDay); všechny otevřené transakce se automaticky uzavřou;
  • pokud certifikát již vypršel: před každým vytvořením dokumentu (createDocument) se pokusí o provedení výměny.

Vadný TSE

Mezi vadné TSE patří například hardwarové TSE, které systém již nerozpoznává, nebo případy, kdy bylo fiskální TSE nastaveno do stavu „DEFECTIVE“ a již jej nelze používat.

Pro vadné TSE platí stejná pravidla jako v případě, kdy již vypršela platnost certifikátu TSE. Před každou operací createDocument se klient pokusí vadné TSE nahradit novým.

U TSE se stavem „DEFECTIVE“ provede fiskální klient výměnu okamžitě, jakmile je volán koncový bod „cloud/connect“ (nebo jiný koncový bod, který zahrnuje přenos CloudApiKey a CloudApiSecret).

To platí pouze v případě, že je zaškrtnuto políčko „Povolit automatickou výměnu TSE“ (viz kapitola „Konfigurace“).

Konfigurace

Automatická výměna TSE se nastavuje v konfiguraci pro Německo.

Od verze 1.11.18 jsou v portálu k dispozici následující konfigurační možnosti:

• Výběr TSE pro výměnu (primární TSE a sekundární TSE)
  • „Použít pro nové klienty“ – při první inicializaci nového klienta se použije TSE tohoto typu,
  • „Použít pro výměny“ – při provádění výměny se použije TSE tohoto typu.
• Možnost povolit automatickou výměnu TSE („Povolit automatickou výměnu TSE“)

Výběr TSE pro výměnu

Pro každé TSE definované v konfiguraci (primární TSE a sekundární TSE) můžete určit, které z těchto TSE se má použít při prvním uvedení do provozu a při výměnách.

Možná nastavení

Jsou možné následující kombinace:

Stejný TSE pro výměnu

V tomto případě se stejné TSE používá jak při počátečním uvedení do provozu, tak v případě výměny. K tomu je třeba:

• Nakonfigurovat buď primární TSE, nebo sekundární TSE,
• a nastavit pro tuto TSE obě možnosti („Použít pro nové klienty“ a „Použít pro výměny“).

V níže uvedeném příkladu je jako sekundární TSE nakonfigurováno sekundární TSE typu „[3] = Swissbit Cloud 2.0“ s vybranými oběma možnostmi.

To znamená, že každý terminál, kterému byla tato konfigurace přiřazena, používá při aktivaci Swissbit Cloud TSE 2.0. Pokud například vyprší platnost certifikátu aktivovaného TSE, aktivuje se nový Swissbit Cloud TSE 2.0.

Jak je popsáno výše, k nahrazení dojde pouze v případě, že je zaškrtnuto také políčko „Povolit automatické nahrazení TSE“!

Jiný TSE pro výměnu

V tomto případě je pro první uvedení do provozu nakonfigurováno konkrétní TSE („Použít pro nové klienty“) a pro případ výměny je nakonfigurováno TSE od jiného výrobce. K tomu je třeba:

• nakonfigurovat dvě TSE, přičemž obě
  • primární TSE a
  • sekundární TSE
• nastavit u jednoho TSE možnost „Použít pro nové klienty“ a 
• u druhého TSE nastavit možnost „Použít pro výměny“

V níže uvedeném příkladu se terminály uvádějí do provozu pomocí sekundární TSE (fiskaly Cloud). Pokud budou splněna kritéria pro automatickou výměnu TSE, bude aktivována nová TSE typu Swissbit Cloud TSE 2.0, která se od tohoto okamžiku začne používat.

Distribuce konfigurace

K dispozici jsou dvě možnosti distribuce nové konfigurace všem klientům, kteří jsou již v provozu:

• Spusťte automatické rozeslání z Cloud portálu pomocí tlačítka „Push Configuration TSE“ nebo
• aktualizujte konfiguraci klienta pomocí PUT /api/v1/management/clients/byCloud/{clientId}.

U obou metod se nová konfigurace – která obsahuje pravidla pro výměnu TSE – přenese do klienta (klientů).

Push Configuration TSE

Toto tlačítko najdete jako akci v nabídce „Configuration“ poté, co vyberete (kliknete na) příslušnou konfiguraci.

Po stisknutí tlačítka se chování liší u lokálních klientů (lokální instalace middlewaru) a klientů ve službě Cloud Fiscalisation Service:

Chování v případě lokální instalace middlewaru

Toto tlačítko slouží výhradně k distribuci konfigurace a aktivaci automatické výměny TSE!

Po stisknutí tlačítka se všem připojeným klientům odešle příkaz ke stažení aktuální konfigurace z portálu. V této souvislosti se „připojenými“ rozumí: klienti, kterým je tato konfigurace přiřazena přímo nebo nepřímo (prostřednictvím organizace, společnosti nebo prodejny).

Klienti, kteří v daném okamžiku nemají aktivní připojení k Cloudu (žádné aktivní připojení k portálu přes „Cloud/Connect“), novou konfiguraci NEobdrží.

Může proto být nutné spustit funkci „Push Configuration TSE“ několikrát, dokud si všichni klienti konfiguraci nestáhnou.

Každý klient nahlásí portálu úspěšné stažení konfigurace. Oznámení se zobrazí prostřednictvím ikony zvonku (vpravo nahoře). Pohled na řídicí panel „Výměna TSE“ také poskytuje přehled o stavu výměny TSE (viz článek: Řídicí panel Německo – Informace o TSE).

Chování služby Cloud Fiscalisation Service

Stejně jako u lokální instalace se i zde spouští příkaz k aktualizaci konfigurace na klientech. Příkaz je však doručen až při příštím volání funkce „Cloud/Connect“ ze strany klienta.

Portál si „pamatuje“ stav příkazu (který klient není aktuálně připojen a který již konfiguraci načítal).

To znamená, že u služby Cloud Fiscalisation Service není nutné znovu aktivovat funkci „Push Configuration TSE“.

Oznámení

Oznámení a zprávy týkající se výměny TSE se:

• zobrazují se prostřednictvím ikony zvonku v portálu (vpravo nahoře),
• zobrazují se v protokolech událostí (pro každý terminál) a
• zasílány e-mailem.

Zvonek

Ikona zvonku zobrazuje následující typy zpráv:

• Hardware TSE není na daném systému k dispozici (není připojen),
• Oznámení týkající se PushConfiguration (konfigurace byla příslušným klientem načtena nebo ji nebylo možné provést).

Události protokolu

K protokolu „Události protokolu“ lze přistupovat prostřednictvím odpovídající položky akce na každém terminálu. Obsahuje všechny události související s výměnou TSE na příslušném terminálu.

E-mailová oznámení

Zprávy o úspěchu a chybách lze také zasílat e-mailem. E-mailová oznámení se odesílají pouze v případě, že byl v portálu vybrán technický kontakt (nastavení v části Organizace: „Technický kontakt“).

Zprávy se odesílají hromadně, každou hodinu.

Tento článek byl přeložen automaticky.