En este artículo se describe cómo configurar la sustitución automática del dispositivo técnico de seguridad certificado (TSE/TSS).

La sustitución de un TSE puede ser necesaria en determinadas circunstancias, tales como:

• si el certificado del TSE en uso está a punto de caducar,
  • y se prefiera cambiar a un fabricante de TSE diferente,
• si un TSE de hardware presenta una avería y ya no puede utilizarse,
• un Cloud TSE ha sido marcado como «defectuoso» por el fabricante correspondiente y ya no puede utilizarse.

RetailForce ofrece un servicio que permite sustituir un TSE de forma automática. La sustitución puede configurarse de modo que:

• se utilice como nuevo TSE uno del mismo fabricante o
• uno de otro fabricante se utilice como nuevo TSE.

El artículo «Prueba: sustitución automática de TSE» explica cómo validar la funcionalidad de sustitución automática de TSE.

Criterios para la sustitución de un TSE

Requisitos previos para la sustitución automática

El Servicio Fiscal solo puede llevar a cabo la sustitución bajo determinadas condiciones:

• Versión
  • Debe estar instalada la versión 1.11.18 del Fiscal Middleware.
• FiscalCountry
  • La sustitución automática del TSE solo es posible, por supuesto, en los sistemas alemanes.
• Configuración
  • La sustitución automática de TSE debe configurarse y activarse en el Client correspondiente.
• Disponibilidad
  • Si se va a utilizar un hardware TSE para la sustitución, también debe haber un nuevo hardware TSE disponible en el sistema (conectado);
  • Si se va a utilizar un Cloud TSE para la sustitución, debe ser posible establecer una conexión a Internet con el fabricante correspondiente.
• Transacciones abiertas
  • No deben existir transacciones abiertas (se ha ejecutado createDocument, pero la transacción aún no se ha finalizado mediante storeDocument o cancelDocument).
• Cierre diario (EndOfDay)
  • La sustitución automática solo se lleva a cabo tras un cierre diario (se ha contabilizado un documento de tipo: «[99] = EndOfDay»).
• Licencias
  • Licencia para el TSE actual;
  • Licencia para el nuevo TSE (si es diferente del TSE en uso actualmente);
  • Licencia para la sustitución del TSE («TSE Change»).

Atención: la sustitución automática del TSE no se ejecutará si no se cumple alguna de las condiciones previas. Para conocer las excepciones, consulte las secciones «Caducidad del certificado» y «TSE defectuoso».

Nota: para recibir notificaciones de estado por correo electrónico relacionadas con el cambio automático de TSE, le recomendamos que seleccione un «Contacto técnico» en el RetailForce Portal (configuración en «Organización»: «Contacto técnico»).

Licencias

Los parámetros de sustitución de un TSE pueden configurarse en cualquier momento; no obstante, para que el proceso se ejecute correctamente, deben asignarse las licencias adecuadas.

• Cambio de TSE: esta licencia es imprescindible para que la sustitución pueda llevarse a cabo,
• Licencias de TSE: asimismo, debe asignarse la licencia correspondiente a cada TSE configurado (TSE principal y secundario).

Desencadenante de la sustitución del TSE

Si se ha configurado y activado la sustitución automática de TSE, el sistema RetailForce intentará (!) llevar a cabo la sustitución automática cuando se produzcan los siguientes eventos:

• El certificado del TSE ha caducado o está a punto de caducar dentro de un intervalo de tiempo especificado,
• El TSE presenta una avería (por ejemplo, ha dejado de funcionar o ha sido marcado como «DEFECTUOSO» por el fabricante).

Caducidad del certificado

Se aplica la siguiente secuencia de eventos cuando caduca el certificado del TSE que se está utilizando actualmente y se ha habilitado la sustitución automática:

• 14 días antes de la caducidad del certificado: si no existen transacciones TSE pendientes, el Cliente Fiscal intenta ejecutar la sustitución automática tras un cierre diario (documento EndOfDay);
• si la sustitución no se ha podido llevar a cabo con éxito en los primeros 7 días (el periodo comprendido entre 14 y 7 días antes de que caduque el certificado):
  • a partir de los 7 días antes de la caducidad del certificado, el cliente cierra automáticamente las transacciones abiertas tras un EndOfDay y se intenta llevar a cabo la sustitución;
  • a partir de tres días antes, se intenta llevar a cabo la renovación tras cada documento (no solo tras un EndOfDay); las transacciones abiertas se cierran automáticamente;
  • si el certificado ya ha caducado: se intenta llevar a cabo la sustitución antes de cada CreateDocument.

Nota: Dentro del plazo de 14 días, el Cliente Fiscal comprueba con cada Cloud/conexión si se cumplen los criterios para una sustitución e intenta sustituir el TSE.

TSE defectuoso

Entre los TSE defectuosos se incluyen, por ejemplo, los TSE de hardware que el sistema ya no reconoce, o los casos en los que un fiskaly TSE ha pasado al estado «DEFECTUOSO» y ya no puede utilizarse.

A los TSE defectuosos se les aplican las mismas reglas que en el caso de que el certificado del TSE ya haya caducado. Antes de cada operación «createDocument», el client intenta sustituir el TSE defectuoso por uno nuevo.

Importante: En esta situación, las transacciones aún abiertas no podrán cerrarse, ya que no es posible generar firmas en el TSE antiguo y el nuevo TSE «desconoce las transacciones antiguas y abiertas» (puesto que dichas transacciones no se iniciaron en el nuevo TSE, sino en el antiguo).

En el caso de los TSE con el estado «DEFECTIVO», el Cliente Fiscal lleva a cabo la sustitución inmediatamente en cuanto se invoca el punto final cloud/connect (u otro punto final que implique la transmisión de cloudApiKey y cloudApiSecret).

Esto solo se aplica si la casilla «Habilitar sustitución automática de TSE» está marcada (véase el capítulo «Configuración»).

Nota: En el caso de TSE de fiskaly Cloud defectuosos, recomendamos realizar o probar primero la sustitución en un único sistema en producción (client).

Configuración

La sustitución automática de TSE se define a través de la configuración de Alemania.

Desde la release 1.11.18, las siguientes opciones de configuración están disponibles en el portal:

• Selección de TSE para la sustitución (TSE principal y TSE secundario)
  • «Utilizar para nuevos clientes»: cuando se inicializa un nuevo cliente por primera vez, se utiliza un TSE de este tipo;
  • «Utilizar para sustituciones»: cuando se vaya a realizar una sustitución, se utilizará un TSE de este tipo.
• Opción para habilitar la sustitución automática de TSE («Habilitar la sustitución automática de TSE»)

Importante: la sustitución automática de TSE solo se activa si además se marca la casilla «Habilitar la sustitución automática de TSE».

Selección de un TSE para sustitución

Para cada TSE definido en la configuración (TSE primario y TSE secundario), puede especificar cuál de estos TSE debe utilizarse durante la puesta en marcha inicial y para las sustituciones.

Posibles configuraciones

Son posibles las siguientes combinaciones:

El mismo TSE para la sustitución

En este caso, se utiliza el mismo TSE tanto durante la puesta en marcha inicial como en caso de sustitución. Para ello, debe:

• Configurar un TSE primario o un TSE secundario,
• y activar ambas opciones («Utilizar para nuevos clientes» y «Utilizar para sustituciones») para este TSE.

En el ejemplo siguiente, se configura un TSE secundario del tipo «[3] = Swissbit Cloud 2.0» como TSE secundario, con ambas opciones seleccionadas.

Esto implica que todos los terminales a los que se asigne esta configuración utilizarán el Swissbit Cloud TSE 2.0 durante la activación. Si, por ejemplo, caduca el certificado del TSE activado, se activará un nuevo Swissbit Cloud TSE 2.0.

Tal y como se ha descrito anteriormente, la sustitución solo tendrá lugar si también se marca la casilla «Habilitar sustitución automática de TSE».

TSE diferente para la sustitución

En este caso, se configura un TSE específico para la puesta en marcha inicial («Utilizar para nuevos clientes») y se configura un TSE de otro fabricante en caso de sustitución. Para ello, debe:

• configurar dos TSE, ambos
  • un TSE principal y
  • un TSE secundario
• establecer la opción «Utilizar para nuevos clientes» para una TSE, y 
• la opción «Utilizar para sustituciones» para el otro TSE

En el ejemplo que figura a continuación, los terminales se ponen en servicio utilizando el TSE secundario (Fiskaly Cloud TSE). Si se cumplen los criterios para la sustitución automática del TSE, se activará un nuevo TSE del tipo Swissbit Cloud TSE 2.0, que se utilizará a partir de ese momento.

Distribución de la configuración

Existen dos opciones disponibles para distribuir la nueva configuración a todos los clientes que ya están en funcionamiento:

• Iniciar la distribución automática desde el portal de Cloud mediante el botón «Enviar configuración a TSE», o
• Actualice la configuración del cliente mediante PUT /api/v1/management/clients/byCloud/{clientId}.

Con ambos métodos, la nueva configuración —que contiene las reglas para la sustitución del TSE— se transmite a los clientes.

Aplicar configuración TSE

Encontrará este botón como una acción en el menú «Configuración» una vez que haya seleccionado (haciendo clic en) la configuración correspondiente.

Al pulsar el botón, el comportamiento varía entre los clientes locales (instalación local del middleware) y los clientes del Servicio de Fiscalización en la Cloud:

Comportamiento en el caso de una instalación local del middleware

Este botón está destinado exclusivamente a distribuir la configuración y activar el intercambio automático de TSE.

Tras pulsar el botón, se envía un comando a todos los clientes conectados para que descarguen la configuración actual desde el portal. En este contexto, «conectados» significa: clientes a los que se ha asignado esta configuración de forma directa o indirecta (a través de una organización, empresa o tienda).

Los clientes que no dispongan de una conexión a la nube activa en ese momento (sin conexión activa al portal a través de «cloud/connect») NO recibirán la nueva configuración.

Por lo tanto, puede ser necesario activar «Push Configuration TSE» varias veces hasta que todos los clientes hayan recuperado la configuración.

Cada cliente notifica al portal que ha recuperado correctamente la configuración. Se muestra una notificación a través del icono de la campana (arriba a la derecha). La vista del panel de control «Sustitución de TSE» también ofrece una visión general del estado de la sustitución de TSE (véase el artículo: Panel de control Alemania – Información sobre TSE).

Comportamiento del servicio de fiscalización en la nube

Al igual que en la instalación local, aquí se activa un comando para actualizar la configuración en los clientes. Sin embargo, el comando solo se entrega la próxima vez que el cliente llame a la función «Cloud/Connect».

El portal «recuerda» el estado del comando (qué cliente no está conectado en ese momento y cuál ya ha recuperado la configuración).

Por tanto, con el Servicio de Fiscalización en la Nube no es necesario reactivar «Enviar configuración TSE».

Notificaciones

Las notificaciones y los mensajes relacionados con la sustitución de un TSE:

- se muestran a través del icono de la campana en el portal (arriba a la derecha),
- aparecen en el registro de eventos (para cada terminal) y-
se envían por correo electrónico.

Campana

El icono de la campana muestra los siguientes tipos de mensajes:

- El hardware TSE no está disponible en el sistema correspondiente (no está conectado),
- Notificaciones relacionadas con PushConfiguration (el client correspondiente ha recuperado la configuración o no se ha podido llevar a cabo).

Eventos de registro

El registro «Eventos de registro» es accesible mediante la acción correspondiente en cada terminal y contiene todos los eventos relacionados con la sustitución del TSE en la terminal respectiva.

Notificaciones por correo electrónico

Los mensajes de éxito y de error también pueden enviarse por correo electrónico. Las notificaciones por correo electrónico solo se envían si se ha seleccionado un contacto técnico (configuración en «Organización»: «Contacto técnico») en el portal.

Los mensajes se envían por lotes, cada hora.

Este artículo ha sido traducido automáticamente.