Preskočiť na hlavný obsah

Automatická výmena TSE

Harald Krondorfer
  • Aktualizované

Tento článok popisuje, ako nakonfigurovať automatickú výmenu certifikovaného technického bezpečnostného zariadenia (TSE/TSS).

Výmena TSE môže byť potrebná za určitých okolností, napríklad:

  • ak sa blíži koniec platnosti certifikátu pre používané TSE
    • alebo ak sa uprednostňuje prechod na iného výrobcu TSE,
  • hardware TSE je chybné a už sa nedá používať,
  • ak bolo Cloud TSE príslušným výrobcom označené ako „vadné“ a už sa nedá používať.

RetailForce poskytuje službu, ktorá umožňuje automatickú výmenu TSE. Výmenu je možné nakonfigurovať tak, aby:

  • ako nový TSE sa použije TSE od toho istého výrobcu alebo
  • od iného výrobcu.

Článok „Test – Automatická výmena TSE“ vysvetľuje, ako otestovať funkciu automatickej výmeny TSE.

Kritériá pre výmenu TSE

Predpoklady pre automatickú výmenu

Fiskálna služba môže výmenu vykonať len za určitých podmienok:

  • Verzia
    • Musí byť nainštalovaná verzia 1.11.18 fiskálneho middlewaru.
  • fiscalCountry
    • Automatická výmena TSE je samozrejme možná len pre nemecké systémy.
  • Konfigurácia
    • Automatická výmena TSE musí byť nakonfigurovaná a povolená v príslušnom klientskom systéme.
  • Dostupnosť
    • Ak sa na výmenu má použiť hardware TSE, musí byť v systéme k dispozícii aj nový hardware TSE (zapojený);
    • Ak sa na výmenu má použiť Cloud TSE, musí byť možné nadviazať internetové pripojenie k príslušnému výrobcovi.
  • Otvorené transakcie
    • Nesmú existovať žiadne otvorené transakcie (bola vykonaná funkcia createDocument, ale transakcia ešte nebola finalizovaná pomocou storeDocument alebo cancelDocument).
  • Koniec dňa (EndOfDay)
    • Automatická výmena sa vykoná až po dennom uzávierke (bol zaúčtovaný dokument typu: „[99] = EndOfDay“).
  • Licencie
    • Licencia pre aktuálny TSE;
    • Licencia pre nový TSE (ak sa líši od aktuálne používaného TSE);
    • Licencia na výmenu TSE („TSE Change“).

Upozornenie: automatická výmena TSE sa neuskutoční, ak nie je splnená **ktorákoľvek z predpokladov**. Výnimky nájdete v častiach „Vypršanie platnosti certifikátu“ a „Chybný TSE“.

Poznámka: Ak chcete dostávať e-mailové oznámenia o stave týkajúce sa automatickej výmeny TSE, odporúčame vybrať „Technickú kontaktnú osobu“ v RetailForce portal (nastavenie v časti Organizácia: „Technická kontaktná osoba“).

Licencie

Nastavenia pre výmenu TSE je možné konfigurovať kedykoľvek. Aby však k nej skutočne došlo, musia byť priradené správne licencie.

  • Výmena TSE: táto licencia je nevyhnutná na to, aby sa výmena mohla vôbec uskutočniť,
  • Licencie TSE: pre každé nakonfigurované zariadenie TSE (primárne aj sekundárne) musí byť priradená príslušná licencia.

Spúšťač výmeny TSE

Ak je nakonfigurovaná a povolená automatická výmena TSE, RetailForce system sa pokúsi (!) vykonať automatickú výmenu, keď nastanú nasledujúce udalosti:

  • Platnosť certifikátu TSE vypršala alebo vyprší v rámci stanoveného časového okna,
  • TSE je chybné (napr. už nefunguje, bolo výrobcom označené ako „DEFECTIVE“).

Vypršanie platnosti certifikátu

Nasledujúci postup sa uplatňuje v prípade, ak vypršala platnosť certifikátu aktuálne používaného TSE a bola aktivovaná automatická výmena:

  • 14 dní pred uplynutím platnosti certifikátu: ak neexistujú žiadne otvorené transakcie TSE, daňový klient sa pokúsi vykonať automatickú výmenu po dennom uzávierke (dokument EndOfDay);
  • ak sa výmena nepodarila úspešne vykonať v priebehu prvých 7 dní (obdobie od 14 do 7 dní pred uplynutím platnosti certifikátu):
    • od 7 dní pred vypršaním platnosti certifikátu klient automaticky uzavrie otvorené transakcie po dokumente EndOfDay a pokúsi sa vykonať výmenu;
    • od 3 dní pred uplynutím platnosti sa uskutoční pokus o výmenu po každom dokumente (nielen po EndOfDay); všetky otvorené transakcie sa automaticky uzavrú;
    • ak certifikát už vypršal: uskutoční sa pokus o výmenu pred každým createDocument.

Poznámka: V rámci 14-dňového obdobia daňový klient overuje u každého cloudu/pripojenia, či sú splnené kritériá na výmenu, a pokúša sa vymeniť TSE.

Chybný TSE

Medzi chybné TSE patria napríklad hardware TSE, ktoré systém už nerozpoznáva, alebo prípady, keď bolo fiskálne TSE nastavené do stavu „DEFECTIVE“ a už sa nedá používať.

Na chybné TSE sa vzťahujú rovnaké pravidlá ako v prípade, keď platnosť certifikátu TSE už vypršala. Pred každou operáciou createDocument sa klient pokúsi nahradiť chybné TSE novým.

Upozornenie: V tomto prípade už nie je možné uzavrieť stále otvorené transakcie, keďže na starom TSE už nie je možné generovať podpisy a nové TSE „nepozná staré, otvorené transakcie“ (keďže tieto transakcie neboli iniciované na novom TSE, ale na starom).

V prípade TSE so stavom „DEFECTIVE“ vykoná daňový klient výmenu ihneď po volaní koncového bodu cloud/connect (alebo iného koncového bodu, ktorý zahŕňa prenos cloudApiKey a cloudApiSecret).

To platí len v prípade, ak je zaškrtnuté checkbox „Povoliť automatickú výmenu TSE“ (pozri kapitolu „Konfigurácia“).

Poznámka: V prípade chybných fiskaly Cloud TSE odporúčame najskôr vykonať alebo otestovať výmenu na jednom živom systéme (client).

Konfigurácia

Automatická výmena TSE sa definuje prostredníctvom konfigurácie pre Nemecko.

Od release 1.11.18 sú v portáli k dispozícii nasledujúce konfiguračné možnosti:

  • Výber TSE na výmenu (primárne TSE a sekundárne TSE)
    • „Použiť pre nových klientov“ – pri prvej inicializácii nového klienta sa použije TSE tohto typu,
    • „Použiť pri výmene“ – pri vykonávaní výmeny sa použije TSE tohto typu.
  • Možnosť aktivovať automatickú výmenu TSE („Aktivovať automatickú výmenu TSE“)

Upozornenie: automatická výmena TSE sa aktivuje až po zaškrtnutí checkboxu „Povoliť automatickú výmenu TSE“!

Výber TSE na výmenu

Pre každé TSE definované v konfigurácii (primárne TSE a sekundárne TSE) môžete určiť, ktoré z týchto TSE sa má použiť pri prvom uvedení do prevádzky a pri výmenách.

Možné nastavenia

Možné sú nasledujúce kombinácie:

Rovnaké TSE pre výmenu

V tomto prípade sa používa rovnaké TSE ako pri počiatočnom uvedení do prevádzky, tak aj v prípade výmeny. Na to musíte:

  • buď nakonfigurovať primárne TSE alebo sekundárne TSE,
  • a pre toto TSE nastaviť obe možnosti („Použiť pre nových klientov“ a „Použiť pri výmene“).

V nižšie uvedenom príklade je ako sekundárne TSE nakonfigurované sekundárne TSE typu „[3] = Swissbit Cloud 2.0“, pričom sú vybrané obe možnosti.

To znamená, že každý terminal, ktorému bola táto konfigurácia priradená, používa pri aktivácii Swissbit Cloud TSE 2.0. Ak napríklad vyprší platnosť certifikátu aktivovaného TSE, aktivuje sa nový Swissbit Cloud TSE 2.0.

TSE-replacement-secondary-both-options.png

Ako je uvedené vyššie, k nahradeniu dôjde len vtedy, ak je zaškrtnuté aj políčko „Povoliť automatické nahradenie TSE“!

Iný TSE na výmenu

V tomto prípade je pre počiatočné uvedenie do prevádzky nakonfigurovaný konkrétny TSE („Použiť pre nových klientov“) a v prípade výmeny je nakonfigurovaný TSE od iného výrobcu. Na to musíte:

  • nakonfigurovať dva TSE, oba
    • primárne TSE a
    • sekundárne TSE
  • nastaviť pre jedno TSE možnosť „Použiť pre nových klientov“ a 
  • pre druhú TSE nastaviť možnosť „Použiť pri výmene“

V nižšie uvedenom príklade sa terminály uvádzajú do prevádzky pomocou sekundárneho TSE (Fiskaly Cloud TSE). Ak budú splnené kritériá pre automatickú výmenu TSE, aktivuje sa nové TSE typu Swissbit Cloud TSE 2.0, ktoré sa od tohto momentu bude používať.

TSE-replacement-different-TSE.png

Distribúcia konfigurácie

Na distribúciu novej konfigurácie všetkým klientom, ktorí sú už v prevádzke, sú k dispozícii dve možnosti:

  • Spustite automatické distribúciu z Cloud portálu pomocou tlačidla „Push Configuration TSE“ alebo
  • aktualizujte konfiguráciu klienta pomocou PUT /api/v1/management/clients/byCloud/{clientId}.

Pri oboch metódach sa nová konfigurácia – ktorá obsahuje pravidlá pre výmenu TSE – prenesie do klienta (klientov).

Push Configuration TSE

Toto tlačidlo nájdete ako action item v ponuke „Configuration“ po výbere (kliknutí na) príslušnej konfigurácie.

Po stlačení tohto tlačidla sa správanie líši v závislosti od toho, či ide o lokálnych klientov (lokálna inštalácia middleware) alebo klientov v službe Cloud Fiscalisation Service:

Správanie pri lokálnej inštalácii middleware

Toto tlačidlo slúži výlučne na distribúciu konfigurácie a aktiváciu automatickej výmeny TSE!

Po stlačení tlačidla sa všetkým pripojeným klientom odošle príkaz na stiahnutie aktuálnej konfigurácie z portálu. V tomto kontexte „pripojené“ znamená: klienti, ktorým je táto konfigurácia priradená priamo alebo nepriamo (prostredníctvom organizácie, spoločnosti alebo predajne).

Clienti, ktorí v danom okamihu nemajú aktívne cloudové pripojenie (žiadne aktívne pripojenie k portálu cez „cloud/connect“), novú konfiguráciu NEZÍSKAJÚ.

Preto môže byť potrebné spustiť funkciu „Push Configuration TSE“ niekoľkokrát, kým všetci klienti stiahnu konfiguráciu.

Každý klient nahlási úspešné stiahnutie konfigurácie späť na portál. Oznámenie sa zobrazí prostredníctvom ikony zvončeka (vpravo hore). Pohľad na riadiaci panel „TSE replacement“ tiež poskytuje prehľad o stave výmeny TSE (pozri článok: Riadiaci panel Nemecko – Informácie o TSE).

Správanie služby Cloud Fiscalisation Service

Rovnako ako pri lokálnej inštalácii sa aj tu spustí príkaz na aktualizáciu konfigurácie na klientoch. Príkaz sa však doručí až pri najbližšom volaní funkcie „cloud/connect“ zo strany klienta.

Portál si „pamätá“ stav príkazu (ktorý client nie je momentálne pripojený a ktorý už konfiguráciu načítal).

To znamená, že pri službe Cloud Fiscalisation Service nie je potrebné opätovne aktivovať funkciu „Push Configuration TSE“.

Oznámenia

Oznámenia a správy týkajúce sa výmeny TSE sú:

- zobrazené prostredníctvom ikony zvončeka v portáli (vpravo hore),
- zobrazené v protokole udalostí (pre každý terminal) a-
zaslané e-mailom.

Zvonček

Ikona zvončeka zobrazuje nasledujúce typy správ:

- Hardware TSE nie je k dispozícii v príslušnom systéme (nie je pripojený),
- Oznámenia týkajúce sa PushConfiguration (konfigurácia bola načítaná príslušným klientom alebo sa nepodarilo vykonať).

Udalosti v protokole

K protokolu „Udalosti v protokole“ sa dostanete prostredníctvom príslušnej action item na každom termináli. Obsahuje všetky udalosti súvisiace s výmenou TSE na príslušnom termináli.

E-mailové oznámenia

Správy o úspešnom vykonaní a chybách je možné zasielať aj prostredníctvom e-mailu. E-mailové oznámenia sa zasielajú len vtedy, ak bol v portáli vybraný technický kontakt (nastavenie v časti Organizácia: „Technický kontakt“).

Správy sa odosielajú hromadne, každú hodinu.

Tento článok bol preložený automaticky.

Podobné články

Príspevky

0 komentárov

Ak chcete napísať komentár, prihlásiť sa.

Využíva technológiu Zendesk