Cenários de recuperação – RetailForce

Durante o funcionamento normal da caixa registadora, poderá ser necessário restaurar dados, por exemplo, devido a avarias de hardware, para que se possa continuar a trabalhar com o sistema de registo.

Atenção: Em alguns países, os processos descritos abaixo para a restauração de clientes do serviço de fiscalização da RetailForce não são permitidos devido a regulamentações legais. Se o sistema de registo (caixas registadoras, etc.) estiver com defeito, não poderá ser efetuada qualquer recuperação de dados; em vez disso, deverá ser colocada em funcionamento uma nova caixa registadora. Para mais informações, consulte abaixo.

Restauração através da RetailForce Cloud

É possível efetuar uma restauração do sistema com base nos dados armazenados na RetailForce Cloud.

Pré-requisitos

Licença para arquivo na Cloud ativada,
licença GetConfiguration ativada,
opção de arquivo na Cloud ativada na configuração,
o diretório de dados do cliente a ser restaurado (por exemplo, em sistemas Windows: C:\ProgramData\RetailForce\Fiscal Webservice\{clientId} não deve existir,
a configuração do cliente a ser restaurado não pode estar contida no repositório de configuração (não deve existir qualquer entrada para o clientId correspondente no ficheiro fiscalService.config.json).

Atenção: A recuperação só pode ocorrer se o client correspondente já estivesse em funcionamento num momento anterior, ou seja, se os dados para a recuperação estiverem disponíveis. Se tiver ocorrido um erro durante o arranque inicial (antes da inicialização), a recuperação também falhará! Neste caso, só é possível um reinício completo. Verifique se os componentes de hardware necessários (TSE/TSS na Alemanha, módulo de segurança na Lituânia, etc.) já foram inicializados. Se for esse o caso, poderá ser necessário substituí-los!

Função

A recuperação de dados é efetuada através da chamada aos pontos finais:

Nota: Apenas os dados que já tenham sido transferidos para a RetailForce Cloud podem ser restaurados. Os dados que não tenham sido transferidos para o RetailForce Cloud system (dados que se encontravam na pasta \tempcloud e que, por exemplo, ainda não tenham sido transferidos para a nuvem devido a uma interrupção da rede) não podem ser restaurados e podem perder-se.

Importante: A recuperação do cliente utilizando as funções acima mencionadas só pode ser realizada com sucesso se, no passado, tiver sido guardado pelo menos um fecho diário (documento EndOfDay) para a caixa registadora (cliente/terminal) em questão e transferido para o arquivo na Cloud.

Reiniciar

Para continuar a trabalhar com as novas caixas registadoras, é necessário saber qual foi o último documento processado pelo cliente.

Este pode ser recuperado do armazenamento de documentos através do ponto de extremidade

GET /api/v1/transactions/document/{clientId}/last

No entanto, apenas é recuperada a JSON payload que o sistema de PDV enviou ao client, e não a resposta (fiscalResponse).

Para também chamar a fiscalResponse correspondente, o ponto de extremidade

GET /api/v1/transactions/document/{clientId}/{DocumentGuid}/response

deve ser utilizado, especificando os parâmetros

ClientId e
DocumentGuid (provenientes do objeto JSON que foi anteriormente devolvido ao chamar GET /api/v1/transactions/document/{clientId}/last)

Utilizando as informações contidas em payload e fiscalResponse, o sistema de PDV deverá poder prosseguir com o número de documento seguinte na sequência.

Recuperação através de dados de cópia de segurança

O serviço de fiscalização da RetailForce permite a criação de cópias de segurança locais dos dados. Estas podem ser geradas a qualquer momento através da chamada ao endpoint:

GET /api/v1/management/clients/recovery/{clientId}/backup

Isto cria um ficheiro zip contendo todos os dados mestre e de transação relevantes para o client que estavam disponíveis localmente (!) no momento em que o backup foi criado.

Em caso de falha do sistema (PC da caixa registadora avariado e que necessita de ser reinstalado), pode utilizar-se um ficheiro de cópia de segurança existente para restaurar o respetivo client através do ponto de extremidade

POST /api/v1/management/clients/recovery/restore

O conjunto de dados corresponde a cada criação de cópia de segurança. Não são descarregados dados da RetailForce Cloud (por exemplo, dados que tenham sido transferidos para a RetailForce Cloud após a criação do ficheiro de cópia de segurança).

O procedimento é idêntico ao utilizado para transferir um FiscalClient de um computador para outro.

Atenção: Para evitar discrepâncias de dados entre a caixa registadora e o arquivo da RetailForce Cloud, recomendamos que utilize esta função apenas para sistemas offline (por exemplo, se tiver sido selecionado um pacote de licenças SEM arquivo na nuvem).

Reinício

O reinício através da importação de um ficheiro de cópia de segurança local funciona exatamente da mesma forma que a restauração através da RetailForce Cloud. No entanto, tenha em atenção que, se o arquivo na nuvem de dados fiscais estiver ativado para o respetivo client, poderá existir uma discrepância de dados entre o ficheiro de cópia de segurança e o sistema na nuvem.

Para verificar isto, utilize as funções de exportação de dados do client em questão no RetailForce portal.

Nova instalação

Em alguns casos, a única solução consiste em configurar a caixa registadora completamente de raiz, sem recuperação de dados. A regulamentação legal nos respetivos países pode também exigir uma nova instalação; por exemplo, se o módulo de segurança lituano (hardware) estiver defeituoso, deve ser registada uma nova caixa registadora.

A nova instalação de um terminal/client é realizada de acordo com o procedimento habitual.

Países onde a recuperação do cliente não é permitida:

Lituânia

Este artigo foi traduzido automaticamente.