Cet article décrit comment configurer le remplacement automatique du dispositif technique de sécurité certifié (TSE/TSS).

Le remplacement d’un TSE peut s’avérer nécessaire dans certaines circonstances, notamment :

• si le certificat du TSE en service est sur le point d’expirer,
  • ou si l’on souhaite changer de fournisseur de TSE,
• si un TSE matériel est défectueux et ne peut plus être utilisé,
• si un Cloud TSE a été signalé comme « défectueux » par le fabricant concerné et ne peut plus être utilisé.

RetailForce propose un service permettant de remplacer automatiquement un TSE. Le remplacement peut être configuré de manière à ce que :

• un TSE du même fabricant ou
• un TSE d’un autre fabricant soit utilisé comme nouveau TSE.

L’article « Test – Remplacement automatique d’un TSE » explique comment tester la fonction de remplacement automatique d’un TSE.

Critères de remplacement d’un TSE

Conditions préalables au remplacement automatique

Le service fiscal ne peut procéder au remplacement que sous certaines conditions :

• Version
  • La version 1.11.18 du Fiscal Middleware doit être installée.
• FiscalCountry
  • Le remplacement automatique du TSE n’est bien sûr possible que pour les systèmes allemands.
• Configuration
  • Le remplacement automatique du TSE doit être configuré et activé dans le client concerné.
• Disponibilité
  • Si un TSE matériel doit être utilisé pour le remplacement, un nouveau TSE matériel doit également être disponible sur le système (branché) ;
  • si un Cloud TSE doit être utilisé pour le remplacement, il doit être possible d’établir une connexion réseau avec le fabricant concerné.
• Transactions en cours
  • Il ne doit exister aucune transaction en cours (la fonction createDocument a été exécutée, mais la transaction n’a pas encore été finalisée à l’aide de storeDocument ou de cancelDocument).
• Fin de journée (EndOfDay)
  • Le remplacement automatique n’est effectué qu’après une clôture journalière (un document de type : « [99] = EndOfDay » a été enregistré).
• Licences
  • Licence pour le TSE actuel ;
  • Licence pour le nouveau TSE (si différent du TSE actuellement utilisé) ;
  • Licence pour le remplacement du TSE (« TSE Change »).

Attention : le remplacement automatique du TSE ne sera pas effectué si **l’une des conditions préalables** n’est pas remplie. Pour les exceptions, veuillez consulter les sections « Expiration du certificat » et « TSE défectueux ».

Remarque : pour recevoir des notifications par e-mail concernant le changement automatique de TSE, nous vous recommandons de désigner un « Contact technique » dans le RetailForce Portal (paramètre dans Organisation : « Contact technique »).

Licences

Les paramètres de remplacement d’un TSE peuvent être configurés à tout moment. Toutefois, pour que ce remplacement puisse effectivement avoir lieu, les licences appropriées doivent être attribuées.

• Remplacement du TSE : cette licence est indispensable pour que le remplacement puisse avoir lieu,
• Licences TSE : une licence correspondante doit également être attribuée à chaque TSE configuré (TSE principal et secondaire).

Déclencheur de remplacement du TSE

Si le remplacement automatique du TSE est configuré et activé, le système RetailForce tentera d’effectuer le remplacement automatique lorsque les événements suivants se produiront :

• Le certificat du TSE a expiré ou est sur le point d’expirer dans un délai spécifié,
• Le TSE est défectueux (par exemple, il est inopérant ou a été signalé comme « DÉFECTUEUX » par le fabricant).

Expiration du certificat

La séquence d’événements suivante s’applique lorsque le certificat du TSE actuellement utilisé arrive à expiration et que le remplacement automatique a été activé :

• 14 jours avant l’expiration du certificat : en l’absence de transactions TSE en cours, le client fiscal tente d’effectuer le remplacement automatique après une clôture journalière (document « EndOfDay ») ;
• si le remplacement n’a pas pu être effectué avec succès au cours des 7 premiers jours (période comprise entre 14 et 7 jours avant l’expiration du certificat) :
  • à partir de 7 jours avant l’expiration du certificat, les transactions ouvertes sont clôturées automatiquement par le client à la suite d’un document EndOfDay et une tentative de remplacement est effectuée ;
  • à partir de 3 jours avant l’expiration, une tentative de remplacement est effectuée après chaque document (et pas uniquement après un EndOfDay) ; toutes les transactions ouvertes sont clôturées automatiquement ;
  • si le certificat est déjà expiré : une tentative de remplacement est effectuée avant chaque opération « createDocument ».

Remarque : au cours de cette période de 14 jours, le client fiscal interroge chaque Cloud/connect afin de s’assurer que les prérequis techniques sont satisfaits et tente de remplacer le TSE.

TSE défectueux

Sont considérés comme TSE défectueux, par exemple, les TSE matériels qui ne sont plus reconnus par le système, ou les cas où un fiskaly TSE a été mis en état « DEFECTIVE » et ne peut plus être utilisé.

Les mêmes règles s’appliquent aux TSE défectueux que dans le cas où le certificat du TSE a déjà expiré. Avant chaque opération « createDocument », le client tente de remplacer le TSE défectueux par un nouveau.

Attention : dans ce cas, les transactions encore en cours ne peuvent plus être clôturées, car il n’est plus possible de générer de signatures sur l’ancien TSE et le nouveau TSE « n’a pas connaissance des anciennes transactions en cours » (celles-ci n’ayant pas été initiées sur le nouveau TSE, mais sur l’ancien).

Pour les TSE présentant le statut « DEFECTIVE », le client fiscal procède au remplacement immédiatement dès que le point de terminaison cloud/connect (ou tout autre point de terminaison impliquant la transmission de cloudApiKey et cloudApiSecret) est appelé.

Cette opération ne s’exécute que si la case à cocher « Activer le remplacement automatique des TSE » est cochée (voir le chapitre « Configuration »).

Remarque : dans le cas de TSE fiskaly Cloud défectueux, nous vous recommandons d’effectuer ou de tester d’abord le remplacement sur un seul système en production (client).

Configuration

Le remplacement automatique des TSE est défini via la configuration pour l’Allemagne.

Depuis la release 1.11.18, les options de configuration suivantes sont disponibles dans le portail :

• Sélection du TSE à remplacer (TSE principal et TSE secondaire)
  • « Utiliser pour les nouveaux clients » : lors de la première initialisation d’un nouveau client, un TSE de ce type est utilisé,
  • « Utiliser pour les remplacements » : lorsqu’un remplacement doit être effectué, un TSE de ce type est utilisé.
• Option permettant d’activer le remplacement automatique du TSE (« Activer le remplacement automatique du TSE »)

Attention : le remplacement automatique du TSE n’est activé que si la case à cocher « Activer le remplacement automatique du TSE » est également cochée.

Sélection d’un TSE pour le remplacement

Pour chaque TSE défini dans la configuration (TSE principal et TSE secondaire), vous pouvez préciser lequel de ces TSE doit être utilisé lors de la mise en service initiale et pour les remplacements.

Paramètres possibles

Les combinaisons suivantes sont possibles :

Même TSE pour le remplacement

Dans ce cas, le même TSE est utilisé aussi bien lors de la mise en service initiale qu’en cas de remplacement. Pour ce faire, vous devez :

• soit configurer un TSE principal ou un TSE secondaire,
• et activer les deux options (« Utiliser pour les nouveaux clients » et « Utiliser pour les remplacements ») pour ce TSE.

Dans l’exemple ci-dessous, un TSE secondaire de type « [3] = Swissbit Cloud 2.0 » est configuré en tant que TSE secondaire, les deux options étant sélectionnées.

Concrètement, chaque terminal auquel cette configuration est affectée utilise le Swissbit Cloud TSE 2.0 lors de son activation. Si, par exemple, le certificat du TSE activé arrive à expiration, un nouveau Swissbit Cloud TSE 2.0 est activé.

Comme décrit ci-dessus, le remplacement n’aura lieu que si la case « Activer le remplacement automatique du TSE » est également cochée !

TSE différent pour le remplacement

Dans ce cas, un TSE spécifique est configuré pour la mise en service initiale (« Utiliser pour les nouveaux clients ») et un TSE d’un autre fabricant est configuré en cas de remplacement. Pour ce faire, vous devez :

• configurer deux TSE, tous deux
  • un TSE principal et
  • un TSE secondaire
• activer l’option « Utiliser pour les nouveaux clients » pour l’un des TSE, et 
• l’option « Utiliser pour les remplacements » pour l’autre TSE

Dans l’exemple ci-dessous, les terminaux sont mis en service à l’aide du TSE secondaire (Fiskaly Cloud TSE). Si les critères de remplacement automatique du TSE sont remplis, un nouveau TSE de type Swissbit Cloud TSE 2.0 sera activé et utilisé à partir de ce moment-là.

Diffusion de la configuration

Deux options s’offrent à vous pour distribuer la nouvelle configuration à tous les clients déjà en service :

• Lancer la diffusion automatique depuis le portail Cloud à l’aide du bouton « Push Configuration TSE », ou
• Mettez à jour la configuration du client à l’aide de la requête PUT /api/v1/management/clients/byCloud/{clientId}.

Avec ces deux méthodes, la nouvelle configuration – qui contient les règles relatives au remplacement du TSE – est transmise au(x) client(s).

Push Configuration TSE

Vous trouverez ce bouton parmi les action items disponibles dans le menu « Configuration » une fois que vous aurez sélectionné (cliqué sur) la configuration concernée.

Lorsque vous cliquez sur ce bouton, le comportement diffère selon que les clients sont locaux (installation locale du middleware) ou qu’ils se trouvent dans le service de fiscalisation dans le Cloud :

Comportement pour une installation locale du middleware

Ce bouton est exclusivement destiné à la distribution de la configuration et à l’activation du remplacement automatique du TSE !

Une fois le bouton actionné, une commande est envoyée à tous les clients connectés afin qu’ils téléchargent la configuration actuelle depuis le portail. Dans ce contexte, le terme « connectés » désigne les clients auxquels cette configuration est attribuée directement ou indirectement (via une organisation, une entreprise ou un magasin).

Les clients dépourvus d’une connexion cloud active au moment de l’opération (aucune session ouverte vers le portail via « cloud/connect ») ne recevront PAS la nouvelle configuration.

Il peut donc s’avérer nécessaire de déclencher plusieurs fois l’opération « Push Configuration TSE » jusqu’à ce que tous les clients aient récupéré la configuration.

Chaque client signale au portail que la récupération de la configuration s’est déroulée avec succès. Une notification s’affiche via l’icône en forme de cloche (en haut à droite). La vue du tableau de bord « Remplacement TSE » fournit également un aperçu de l’état d’avancement du remplacement du TSE (voir l’article : Tableau de bord Allemagne – Informations TSE).

Comportement du service de fiscalisation dans le Cloud

Comme pour l’installation locale, une commande est ici déclenchée pour mettre à jour la configuration sur les clients. Cependant, la commande n’est transmise que lors du prochain appel de la fonction « Cloud/Connect » par le client.

Le portail « mémorise » l’état de la commande (quel client n’est actuellement pas connecté et lequel a déjà récupéré la configuration).

Cela signifie qu’avec le service de fiscalisation dans le Cloud, il n’est pas nécessaire de réactiver la fonction « Push Configuration TSE ».

Notifications

Les notifications et messages relatifs au remplacement d’un TSE sont :

- affichées via l’icône en forme de cloche dans le portail (en haut à droite),
- répertoriées dans le journal des événements (pour chaque terminal), et-
envoyées par e-mail.

Icône de cloche

L’icône en forme de cloche affiche les types de messages suivants :

- Le composant matériel TSE n’est pas disponible sur le système concerné (non branché),
- Les notifications relatives à PushConfiguration (la configuration a été récupérée par le client concerné ou n’a pas pu être effectuée).

Journal des événements

Le journal « Événements du journal » est accessible via l’action item correspondante sur chaque terminal. Il contient tous les événements liés au remplacement du TSE sur le terminal concerné.

Notifications par e-mail

Les messages de réussite et d’erreur peuvent également être acheminés par e-mail. Les notifications par e-mail ne sont envoyées que si un contact technique (paramètre dans « Organisation » : « Contact technique ») a été défini dans le portail.

Les messages sont envoyés par lots, toutes les heures.

Cet article a été traduit automatiquement.