Il presente articolo illustra come configurare la sostituzione automatica del dispositivo tecnico di sicurezza certificato (TSE/TSS).

La sostituzione di un TSE può rendersi necessaria in determinate circostanze, ad esempio:

se il certificato del TSE in uso sta per scadere,
- e si preferisce passare a un produttore di TSE diverso,
un TSE hardware è difettoso e non può più essere utilizzato,
una Cloud TSE è stata contrassegnata come «difettosa» dal produttore di riferimento e non può più essere utilizzata.

RetailForce offre un servizio che consente la sostituzione automatica di un TSE. La sostituzione può essere configurata in modo tale che:

venga utilizzato come nuovo TSE un dispositivo dello stesso produttore oppure
uno di un altro produttore venga utilizzato come nuovo TSE.

L’articolo «Test – Sostituzione automatica del TSE» illustra come testare la funzione di sostituzione automatica del TSE.

Criteri per la sostituzione del TSE

Prerequisiti per la sostituzione automatica

Il Fiscal Service può effettuare la sostituzione solo a determinate condizioni:

Versione
- È necessario che sia installata la versione 1.11.18 del Fiscal Middleware.
FiscalCountry
- La sostituzione automatica del TSE è ovviamente possibile solo per i sistemi tedeschi.
Configurazione
- La sostituzione automatica del TSE deve essere configurata e abilitata nel client di riferimento.
Disponibilità
- Se per la sostituzione si intende utilizzare un hardware TSE, è necessario che sul sistema sia disponibile (collegato) anche un nuovo hardware TSE;
- Se per la sostituzione si intende utilizzare un Cloud TSE, deve essere possibile stabilire una connessione Internet con il produttore in questione.
Transazioni aperte
- Non devono essere presenti transazioni aperte (la funzione createDocument è stata eseguita, ma la transazione non è stata ancora finalizzata tramite storeDocument o cancelDocument).
Chiusura giornaliera (EndOfDay)
- La sostituzione automatica viene eseguita solo dopo la chiusura giornaliera (è stato registrato un documento di tipo: «[99] = EndOfDay»).
Licenze
- Licenza per l’attuale TSE;
- Licenza per il nuovo TSE (se diverso dal TSE attualmente in uso);
- Licenza per la sostituzione del TSE («TSE Change»).

Attenzione: la sostituzione automatica del TSE non verrà effettuata se **uno qualsiasi dei prerequisiti** non è soddisfatto. Per le eccezioni, consultare le sezioni «Scadenza del certificato» e «TSE difettoso».

Nota: per ricevere via e-mail le notifiche di stato relative alla sostituzione automatica del TSE, si consiglia di selezionare un “Referente tecnico” nel RetailForce portal (impostazione in Organizzazione: “Referente tecnico”).

Licenze

Le impostazioni per la sostituzione di un TSE possono essere configurate in qualsiasi momento. Tuttavia, affinché il processo si avvii effettivamente, è necessario assegnare le licenze corrette.

TSE Change: questa licenza è necessaria affinché la sostituzione possa avvenire,
Licenze TSE: è necessario assegnare una licenza corrispondente per ciascun TSE configurato (TSE primario e secondario).

Condizioni per la sostituzione del TSE

Se la sostituzione automatica del TSE è configurata e abilitata, il sistema RetailForce tenterà (!) di eseguire la sostituzione automatica al verificarsi dei seguenti eventi:

il certificato del TSE è scaduto o sta per scadere entro un intervallo di tempo specificato,
Il TSE è difettoso (ad es. non funziona più, è stato contrassegnato come «DIFETTOSO» dal produttore).

Scadenza del certificato

La seguente sequenza di eventi si applica quando il certificato del TSE attualmente in uso scade e la sostituzione automatica è stata abilitata:

14 giorni prima della scadenza del certificato: in assenza di transazioni TSE pendenti, il Client Fiscale tenta la sostituzione automatica al termine della chiusura giornaliera (documento EndOfDay);
se la sostituzione non è stata effettuata con successo entro i primi 7 giorni (il periodo compreso tra 14 e 7 giorni prima della scadenza del certificato):
- a partire da 7 giorni prima della scadenza del certificato, le transazioni aperte vengono chiuse automaticamente dal client a seguito di un EndOfDay e si tenta di effettuare la sostituzione;
- a partire da 3 giorni prima, si tenta di effettuare la sostituzione dopo ogni documento (non solo dopo un EndOfDay); eventuali transazioni aperte vengono chiuse automaticamente;
- se il certificato è già scaduto: si tenta di effettuare la sostituzione prima di ogni operazione «createDocument».

Nota: entro il periodo di 14 giorni, il Client Fiscale interroga ciascun cloud/connect per verificare che i prerequisiti di sostituzione siano soddisfatti e tenta la sostituzione del TSE.

TSE difettoso

I TSE difettosi includono, ad esempio, gli hardware TSE non più riconosciuti dal sistema oppure i casi in cui un fiskaly TSE è stato marcato come «DEFECTIVE» e non può più essere utilizzato.

Ai TSE difettosi si applicano le stesse regole previste nel caso in cui il certificato del TSE sia già scaduto. Prima di ogni operazione CreateDocument, il client tenta di sostituire il TSE difettoso con uno nuovo.

Attenzione: in tale situazione le transazioni ancora aperte non possono più essere chiuse, poiché non è più possibile generare firme sul vecchio TSE e il nuovo TSE «non è a conoscenza delle vecchie transazioni aperte» (in quanto tali transazioni non sono state avviate sul nuovo TSE, ma su quello vecchio).

Per i TSE nello stato «DEFECTIVE», il Client Fiscale esegue la sostituzione immediatamente non appena viene richiamato l’endpoint cloud/connect (o un altro endpoint che comporti la trasmissione di cloudApiKey e cloudApiSecret).

Tale comportamento è abilitato solo se risulta selezionata la checkbox «Abilita sostituzione automatica del TSE» (vedere il capitolo «Configurazione»).

Nota: nel caso di TSE fiskaly Cloud difettosi, si raccomanda di effettuare o testare innanzitutto la sostituzione su un singolo sistema in produzione (client).

Configurazione

La sostituzione automatica dei TSE viene definita tramite la configurazione per la Germania.

A partire dalla release 1.11.18, nel portale sono disponibili le seguenti opzioni di configurazione:

Selezione del TSE da sostituire (TSE primario e TSE secondario)
- "Utilizza per i nuovi clienti" – quando un nuovo client viene inizializzato per la prima volta, viene utilizzato un TSE di questo tipo,
- "Utilizza per le sostituzioni" – quando è necessario eseguire una sostituzione, viene impiegato un TSE di questo tipo.
Opzione per abilitare la sostituzione automatica del TSE («Abilita sostituzione automatica del TSE»)

Attenzione: la sostituzione automatica del TSE viene attivata solo se è spuntata anche la checkbox “Abilita sostituzione automatica del TSE”!

Selezione di un TSE per la sostituzione

Per ciascun TSE definito nella configurazione (TSE primario e TSE secondario), è possibile specificare quale TSE debba essere impiegato durante la messa in servizio iniziale e per le sostituzioni.

Impostazioni possibili

Sono possibili le seguenti combinazioni:

Stesso TSE per la sostituzione

In questo caso, viene utilizzato lo stesso TSE sia durante la messa in servizio iniziale che in caso di sostituzione. A tal fine, è necessario:

configurare un TSE primario o un TSE secondario,
e impostare entrambe le opzioni («Utilizza per i nuovi clienti» e «Utilizza per le sostituzioni») per tale TSE.

Nell’esempio seguente, un TSE secondario di tipo «[3] = Swissbit Cloud 2.0» è configurato come TSE secondario, con entrambe le opzioni selezionate.

Ciò implica che ogni terminal a cui è stata assegnata tale configurazione utilizzerà il Swissbit Cloud TSE 2.0 durante l’attivazione. In caso di scadenza del certificato del TSE attivato, verrà automaticamente provisionato un nuovo Swissbit Cloud TSE 2.0.

Come descritto in precedenza, la sostituzione viene eseguita solo se risulta selezionata anche la casella "Abilita sostituzione automatica del TSE".

TSE diverso per la sostituzione

In questo scenario, viene configurato un TSE specifico per la messa in servizio iniziale («Utilizza per i nuovi client») e un TSE di un altro produttore in caso di sostituzione. A tal fine, è necessario:

configurare due TSE, entrambi
- un TSE primario e
- un TSE secondario
impostare l’opzione «Utilizza per nuovi clienti» per un TSE e
l’opzione «Utilizza per le sostituzioni» per l’altro TSE

Nell’esempio seguente, i terminali vengono messi in servizio tramite il TSE secondario (Fiskaly Cloud TSE). Se sono soddisfatti i criteri per la sostituzione automatica del TSE, viene attivato un nuovo TSE di tipo Swissbit Cloud TSE 2.0, che viene utilizzato da quel momento in poi.

Distribuzione della configurazione

Sono disponibili due opzioni per distribuire la nuova configurazione a tutti i client già in funzione:

Avviare la distribuzione automatica dal Portale Cloud utilizzando il pulsante «Invia configurazione TSE», oppure
aggiornare la configurazione del client tramite PUT /api/v1/management/clients/byCloud/{clientId}.

Con entrambi i metodi, la nuova configurazione – che include le regole per la sostituzione del TSE – viene trasmessa al/ai client.

Invia configurazione TSE

Il pulsante è disponibile tra gli action item della voce di menu “Configurazione” dopo aver selezionato la configurazione pertinente.

Al momento della pressione del pulsante, il comportamento varia a seconda che si tratti di client locali (installazione locale del middleware) o di client nel Cloud Fiscalisation Service:

Comportamento in caso di installazione locale del middleware

Questo pulsante è destinato esclusivamente alla distribuzione della configurazione e all’attivazione dello scambio automatico del TSE.

Dopo aver premuto il pulsante, viene inviato un comando a tutti i client connessi affinché scarichino la configurazione corrente dal portale. In questo contesto, per «connessi» si intendono: i client ai quali questa configurazione è assegnata direttamente o indirettamente (tramite organizzazione, azienda o punto vendita).

I client che in quel momento non dispongono di una connessione Cloud attiva (nessuna connessione attiva al portale tramite «Cloud/Connect») NON riceveranno la nuova configurazione.

Potrebbe quindi essere necessario attivare “Push Configuration TSE” più volte fino a quando tutti i client non avranno scaricato la configurazione.

Ogni client segnala al portale l’avvenuto recupero della configurazione. Viene visualizzata una notifica tramite l’icona a forma di campana (in alto a destra). La vista del dashboard “Sostituzione TSE” fornisce inoltre una panoramica dello stato della sostituzione del TSE (vedere l’articolo: Dashboard Germania – Informazioni TSE).

Funzionamento del servizio di fiscalizzazione Cloud

Come nell’installazione locale, anche in questo caso viene attivato un comando per aggiornare la configurazione sui client. Tuttavia, il comando viene trasmesso solo alla successiva invocazione della funzione «Cloud/Connect» da parte del client.

Il portale “memorizza” lo stato del comando (quale client non è attualmente connesso e quale ha già recuperato la configurazione).

Ciò implica che, con il Servizio di fiscalizzazione cloud, non è necessario riattivare la funzione “Push Configuration TSE”.

Notifiche

Le notifiche e i messaggi relativi alla sostituzione di un TSE vengono:

- visualizzate tramite l’icona a forma di campana nel portale (in alto a destra),
- riportate negli eventi di log (per ciascun terminal) e-
inviate tramite e-mail.

Campanello

L’icona a forma di campana visualizza i seguenti tipi di messaggi:

- L'hardware TSE non è disponibile sul sistema in questione (non collegato),
- Notifiche relative a PushConfiguration (la configurazione è stata recuperata dal client in questione oppure non è stato possibile eseguirla).

Eventi di log

È possibile accedere al registro «Eventi di log» tramite la voce di action item corrispondente su ciascun terminal. Esso contiene tutti gli eventi relativi alla sostituzione del TSE sul rispettivo terminal.

Notifiche via e-mail

I messaggi di successo e di errore possono essere inviati anche tramite e-mail. Le notifiche via e-mail vengono inviate solo se nel portale è stato selezionato un contatto tecnico (impostazione in Organizzazione: «Contatto tecnico»).

I messaggi vengono inviati in batch, con cadenza oraria.

Questo articolo è stato tradotto automaticamente.