Este artigo descreve como configurar a substituição automática do dispositivo técnico de segurança certificado (TSE/TSS).

A substituição de um TSE pode ser necessária em determinadas circunstâncias, tais como:

• se o certificado do TSE em utilização estiver prestes a expirar,
  • e para preferível mudar para um fabricante de TSE diferente,
• se um hardware TSE estiver avariado e já não puder ser utilizado,
• um Cloud TSE tiver sido marcado como «defeituoso» pelo fabricante em questão e já não puder ser utilizado.

RetailForce disponibiliza um serviço que permite a substituição automática de um TSE. A substituição pode ser configurada de modo a que:

• um TSE do mesmo fabricante ou
• um TSE de outro fabricante seja utilizado como o novo TSE.

O artigo «Teste – Substituição automática de TSE» explica como testar a função de substituição automática de TSE.

Critérios para a substituição de um TSE

Pré-requisitos para a substituição automática

O Fiscal Service só pode efetuar a substituição sob determinadas condições:

• Versão
  • A versão 1.11.18 do middleware fiscal deve estar instalada.
• FiscalCountry
  • A substituição automática do TSE só é, naturalmente, possível para sistemas alemães.
• Configuração
  • A substituição automática do TSE deve ser configurada e ativada no client em questão.
• Disponibilidade
  • Caso se pretenda utilizar um hardware TSE para a substituição, deve também estar disponível no sistema um novo hardware TSE (ligado);
  • Se for utilizado um Cloud TSE na nuvem para a substituição, deve ser possível estabelecer uma ligação à Internet com o fabricante em questão.
• Transações em aberto
  • Não devem existir transações em aberto (a função createDocument foi executada, mas a transação ainda não foi finalizada através das funções storeDocument ou cancelDocument).
• Fim do dia (EndOfDay)
  • A substituição automática só é efetuada após um encerramento diário (foi lançado um documento do tipo: «[99] = EndOfDay»).
• Licenças
  • Licença para o TSE atual;
  • Licença para o novo TSE (caso seja diferente do TSE atualmente em utilização);
  • Licença para a substituição do TSE («Alteração do TSE»).

Atenção: a substituição automática do TSE não será efetuada se **algum dos pré-requisitos** não for cumprido. Para exceções, consulte as secções «Caducidade do certificado» e «TSE defeituoso».

Nota: para receber notificações de estado por e-mail relativas à substituição automática do TSE, recomendamos que selecione um «Contacto técnico» no RetailForce portal (configuração em Organização: «Contacto técnico»).

Licenças

As definições para a substituição de um TSE podem ser configuradas a qualquer momento. No entanto, para que tal ocorra efetivamente, devem ser atribuídas as licenças corretas.

• Substituição do TSE: esta licença é necessária para que a substituição possa ocorrer,
• Licenças TSE: deve também ser atribuída uma licença correspondente a cada TSE que tenha sido configurado (TSE primário e secundário).

Desencadeador da substituição do TSE

Se a substituição automática do TSE estiver configurada e ativada, o RetailForce system tentará (!) efetuar a substituição automática quando ocorrerem os seguintes eventos:

• O certificado do TSE expirou ou está prestes a expirar dentro de um intervalo de tempo especificado,
• O TSE está com defeito (por exemplo, já não funciona, foi marcado como «DEFECTUOSO» pelo fabricante).

Caducidade do certificado

A seguinte sequência de eventos aplica-se quando o certificado do TSE atualmente utilizado expira e a substituição automática tiver sido ativada:

• 14 dias antes do vencimento do certificado: se não houver transações TSE em aberto, o Cliente Fiscal tenta efetuar a substituição automática após um fecho diário (documento EndOfDay);
• se a substituição não tiver sido realizada com sucesso nos primeiros 7 dias (o período entre 14 e 7 dias antes do termo de validade do certificado):
  • a partir de 7 dias antes do vencimento do certificado, as transações em aberto são encerradas automaticamente pelo client após um EndOfDay e é feita uma tentativa de efetuar a substituição;
  • a partir de 3 dias antes, é feita uma tentativa de efetuar a substituição após cada documento (e não apenas após um EndOfDay); quaisquer transações em aberto são encerradas automaticamente;
  • se o certificado já tiver expirado: é feita uma tentativa de efetuar a substituição antes de cada createDocument.

Nota: Durante o período de 14 dias, o Cliente Fiscal verifica junto de cada Cloud/ligação se os critérios para a substituição estão preenchidos e tenta substituir o TSE.

TSE com avaria

Os TSEs defeituosos incluem, por exemplo, hardware TSEs que já não são reconhecidos pelo sistema, ou casos em que um fiskaly TSE foi definido com o estado «DEFECTUOSO» e já não pode ser utilizado.

Aplicam-se aos TSE com defeito as mesmas regras que no caso em que o certificado do TSE já tenha expirado. Antes de cada operação «createDocument», o client tenta substituir o TSE com defeito por um novo.

Atenção: Neste caso, as transações ainda em aberto já não podem ser encerradas, uma vez que já não é possível gerar assinaturas no antigo TSE e o novo TSE «desconhece as transações antigas em aberto» (uma vez que estas transações não foram iniciadas no novo TSE, mas sim no antigo).

No caso de TSEs com o estado «DEFECTIVE», o Client Fiscal efetua a substituição imediatamente assim que for chamado o endpoint cloud/connect (ou outro endpoint que implique a transmissão de cloudApiKey e cloudApiSecret).

Isto só se aplica se a checkbox «Ativar substituição automática de TSE» estiver marcada (consulte o capítulo «Configuração»).

Nota: No caso de TSEs da fiskaly Cloud com defeito, recomendamos que a substituição seja primeiro realizada ou testada num único sistema em produção (client).

Configuração

A substituição automática de TSE é definida através da configuração para a Alemanha.

Desde a release 1.11.18, as seguintes opções de configuração estão disponíveis no portal:

• Seleção do TSE para substituição (TSE primário e TSE secundário)
  • «Utilizar para novos clientes» – quando um novo client é inicializado pela primeira vez, é utilizado um TSE deste tipo,
  • «Utilizar para substituições» – quando for necessário efetuar uma substituição, é utilizado um TSE deste tipo.
• Opção para ativar a substituição automática de TSE («Ativar substituição automática de TSE»)

Atenção: a substituição automática de TSE só é ativada após a checkbox «Ativar substituição automática de TSE» também ter sido assinalada!

Seleção de um TSE para substituição

Para cada TSE definido na configuração (TSE Primário e TSE Secundário), pode especificar qual destes TSEs deve ser utilizado durante a colocação em serviço inicial e para substituições.

Configurações possíveis

São possíveis as seguintes combinações:

O mesmo TSE para substituição

Neste caso, é utilizado o mesmo TSE tanto durante a colocação em serviço inicial como em caso de substituição. Para tal, deve:

• Configurar um TSE Primário ou um TSE Secundário,
• e definir ambas as opções («Utilizar para novos clientes» e «Utilizar para substituições») para este TSE.

No exemplo abaixo, um TSE secundário do tipo «[3] = Swissbit Cloud 2.0» está configurado como TSE secundário, com ambas as opções selecionadas.

Isto significa que todos os terminais aos quais esta configuração foi atribuída utilizam o Swissbit Cloud TSE 2.0 durante a ativação. Se, por exemplo, o certificado do TSE ativado expirar, será ativado um novo Swissbit Cloud TSE 2.0.

Conforme descrito acima, a substituição só ocorrerá se a caixa de seleção «Ativar substituição automática do TSE» também estiver marcada!

TSE diferente para substituição

Neste caso, é configurado um TSE específico para a colocação em serviço inicial («Utilizar para novos clientes») e um TSE de um fabricante diferente é configurado em caso de substituição. Para tal, deve:

• configurar dois TSE, ambos
  • um TSE primário e
  • um TSE secundário
• definir a opção «Utilizar para novos clientes» para um TSE e 
• a opção «Utilizar para substituições» para o outro TSE

No exemplo abaixo, os terminais são colocados em funcionamento utilizando o TSE secundário (Fiskaly Cloud TSE). Se os critérios para a substituição automática do TSE forem cumpridos, será ativado um novo TSE do tipo Swissbit Cloud TSE 2.0, que passará a ser utilizado a partir desse momento.

Distribuição da configuração

Existem duas opções disponíveis para distribuir a nova configuração a todos os clients que já se encontram em funcionamento:

• Acionar a distribuição automática a partir do Portal da Cloud utilizando o botão «Enviar configuração para o TSE», ou
• Atualize a configuração do cliente utilizando PUT /api/v1/management/clients/byCloud/{clientId}.

Com ambos os métodos, a nova configuração — que contém regras para a substituição do TSE — é transmitida ao(s) client(s).

Enviar configuração TSE

Encontrará este botão como um action item no menu «Configuração» depois de ter selecionado (clicado em) a configuração relevante.

Quando o botão é premido, o comportamento difere entre clientes locais (instalação local de middleware) e clientes no Serviço de Fiscalização na Cloud:

Comportamento para instalação local do middleware

Este botão destina-se exclusivamente a distribuir a configuração e a ativar a troca automática de TSE!

Após premir o botão, é enviado um comando a todos os clientes ligados para descarregarem a configuração atual a partir do portal. Neste contexto, «ligados» significa: clientes aos quais esta configuração está atribuída direta ou indiretamente (através da organização, empresa ou loja).

Os clientes que não tenham uma ligação à Cloud ativa nesse momento (sem ligação ativa ao portal através de «Cloud/Connect») NÃO receberão a nova configuração.

Por conseguinte, poderá ser necessário acionar a opção «Push Configuration TSE» várias vezes até que todos os clientes tenham obtido a configuração.

Cada cliente comunica ao portal que a recuperação da configuração foi bem-sucedida. É apresentada uma notificação através do ícone do sino (canto superior direito). A vista do painel de controlo «Substituição do TSE» também fornece uma visão geral do estado da substituição do TSE (ver artigo: Painel de controlo Alemanha – Informações sobre o TSE).

Comportamento do Serviço de Fiscalização na Cloud

Tal como na instalação local, é aqui acionado um comando para atualizar a configuração nos clientes. No entanto, o comando só é entregue na próxima vez que o cliente chamar a função «Cloud/Connect».

O portal «lembra-se» do estado do comando (qual o client que não está atualmente ligado e qual o que já recuperou a configuração).

Isto significa que, com o Serviço de Fiscalização na Cloud, não é necessário reativar a opção «Enviar configuração TSE».

Notificações

As notificações e mensagens relacionadas com a substituição de um TSE são:

- apresentadas através do ícone do sino no portal (canto superior direito),
- exibidas nos registos de eventos (para cada terminal) e-
enviadas por e-mail.

Sino

O ícone do sino apresenta os seguintes tipos de mensagens:

- O hardware TSE não está disponível no sistema em questão (não está ligado),
- Notificações relacionadas com o PushConfiguration (a configuração foi recuperada pelo client em questão ou não foi possível efetuá-la).

Registo de Eventos

É possível aceder ao registo «Eventos de registo» através da action item correspondente em cada terminal. Este contém todos os eventos relacionados com a substituição do TSE no respetivo terminal.

Notificações por e-mail

As mensagens de sucesso e de erro também podem ser enviadas por e-mail. As notificações por e-mail só são enviadas se tiver sido selecionado um contacto técnico (configuração em «Organização»: «Contacto Técnico») no portal.

As mensagens são enviadas em lotes, de hora a hora.

Este artigo foi traduzido automaticamente.