Erro de ligação ao TSE – RetailForce

A fiscalização na Alemanha exige a utilização de um «dispositivo técnico de segurança certificado» (TSE ou TSS na versão inglesa do regulamento). Caso sejam utilizados hardware TSEs, poderá ser apresentada a mensagem de erro «Erro de ligação ao TSE.» após a execução de createDocument.

Cenários possíveis:

O TSE não está ligado

O TSE não está ligado à caixa registadora (ao sistema no qual o RetailForce Middleware está instalado).

Resolução de problemas:

Ligue o TSE ao sistema.

TSE ligado – o teste indica «OK»

O erro é apresentado, mas o TSE está ligado ao sistema; realize também um autoteste

POST /api/v1/management/germany/TSE/{TseSerial}/selftest devolve
«200 - Sucesso»,

tal como acontece com um teste de ligação:

PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
«200 - Sucesso».

Possível causa:

O limite de transações abertas foi atingido! Devido a um requisito do BSI (Serviço Federal Alemão de Segurança da Informação) relativo ao TSE, os TSE têm de limitar o número de transações que podem estar abertas em simultâneo.

O hardware TSE da Swissbit pode gerir um máximo de 512,
Fiskaly Cloud TSE, 2 000 transações abertas.

Trata-se de transações que foram iniciadas com o comando «createDocument», mas que não foram concluídas corretamente posteriormente (com «storeDocument» ou «cancelDocument»). Isto pode ocorrer, por exemplo, se o sistema POS falhar após um «createDocument» e não tiver «lembrado» que ainda existem transações em aberto.

O número de transações em aberto pode ser consultado através do seguinte ponto de extremidade:

GET /api/v1/management/germany/TSE

As transações em aberto são apresentadas na resposta no campo «startedTransactions»:

[
   {
      ...
      "startedTransactions": 512,
      "maxStartedTransactions": 512,
      "createdSignatures": 2238,
      "maxSignatures": 20000000,
      ...
   }
]

Resolução de problemas:

Para corrigir o erro ou para permitir que o TSE volte a aceitar documentos («recibos») para processamento, as transações em aberto têm de ser encerradas.

Para tal, proceda da seguinte forma.

Opção 1:

Utilizando o

GET /api/v1/management/germany/{clientId}/TSE/listTransactions ,

são devolvidos, em pacotes, os fiscalDocumentNumbers das transações em aberto.

Exemplo:

As transações recuperadas através de listTransactions (=fiscalDocumentNumber) devem agora, de acordo com a situação real, ser encerradas através de:

Utilize POST /api/v1/transactions/storeDocument (como habitualmente) para concluir o documento quando tiver sido efetuada uma venda e POST /api/v1/transactions/cancelDocument para cancelar a transação (sem que a venda tenha sido bem-sucedida).

Atenção: tenha em conta que os cancelamentos de documentos são (devem ser) também registados no TSE. Por conseguinte, é igualmente necessário encerrar cada transação iniciada com PUT /api/v1/transactions/createDocument através de «storeDocument» ou «cancelDocument». No caso de cancelamentos frequentes de documentos, não podemos excluir a possibilidade de as autoridades fiscais poderem questionar os motivos dos cancelamentos no âmbito de uma inspeção à caixa registadora .

Nota: Para TSEs de TESTE/DESENVOLVIMENTO , poderá fazer mais sentido repor o TSE para as predefinições de fábrica, em vez de encerrar todas as transações. Encontrará mais informações sobre este assunto no artigo «SWISSBIT HARDWARE TSE ».

Opção 2:

DELETE /api/v1/management/germany/{clientId}/TSE/listTransactions

pode ser utilizado para encerrar todas as transações TSE em aberto de uma só vez. Certifique-se de que segue as instruções acima relativas aos cancelamentos de documentos antes de utilizar este endpoint! Após o encerramento de todas as transações em aberto, o TSE voltará a aceitar e a processar documentos.

Nota: Os TSEs devolverão transações em aberto apenas em pacotes (hardware TSE da Swissbit: 8 transações em aberto por pedido; TSEs na nuvem: 100 transações em aberto por pedido)! Terá de utilizar a função várias vezes.

Atenção: Independentemente da forma como o erro foi resolvido, recomendamos que analise cuidadosamente o motivo pelo qual as transações do TSE permanecem em aberto. No processo normal de encerramento, todas as transações em aberto devem ser encerradas antes do encerramento diário.

Este artigo foi traduzido automaticamente.