CloudSync - Reenvio de dados

Esta documentação descreve como verificar e transferir documentos de fim de dia. Atualmente, esta função só é suportada na Alemanha.

Visão geral

O processo de sincronização na Cloud armazena de forma segura os seus documentos de Fim de Dia na Cloud e executa as seguintes tarefas:

1. verifica se todos os ficheiros de fim de dia necessários (o documento genérico de fim de dia e o arquivo TAR específico da Alemanha) se encontram no armazenamento na Cloud
2. transfere quaisquer ficheiros em falta do client local para a Cloud.

Pré-requisitos

• Autorização organizacional: esta deve estar ativada para reenviar dados. A ativação deve ser efetuada através do apoio técnico.
• País fiscal: atualmente disponível apenas para a Alemanha.
• Configuração: Os caminhos de armazenamento de ficheiros locais e na nuvem devem ser configurados no RetailForce portal

Configuração do portal

1. Inicie sessão no RetailForce portal.
2. Navegue até «Configuração» → «Configuração relevante»
3. Armazenamento de ficheiros
   1. Clique em + Storage path.
   2. O campo «Storage path» permanece em branco e não requer qualquer introdução de dados.
4. Armazenamento na Cloud
   1. Clique em + Storage path.
   2. O campo «Storage path» também se encontra inicialmente vazio.
5. Guarde as alterações.

Fluxo de trabalho do cliente

Após gerar e lançar um EOD baseado em transações no client, as seguintes chamadas à api devem ser efetuadas na ordem indicada:

• POST de atualização da configuração
  /api/v1/management/clients/byCloud/{clientId}
  Atualiza a configuração e garante que o middleware está a utilizar os caminhos atuais de armazenamento em ficheiro e na Cloud.
• POST do CloudConnect
  /api/v1/management/cloud/connect
  Estabelece uma ligação à Cloud.
• Criação de Fim
  de Dia ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Cria o documento local de fim de dia.
• POST de registo do fim
  do dia /api/v1/transactions/storeDocument
  Regista o documento de fim de dia criado.

• Verificar requisito
  de sincronização GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Determina se ainda existem ficheiros de fim de dia na fila de mensagens local.

  Erros possíveis

  • EndOfDay required – Não foi encontrado nenhum documento de fim de dia; gerar documento de fim de dia!
  • CloudConnect required – É necessária uma chamada ao CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Os ficheiros pendentes têm de ser carregados.
  • Terminal is not allowed to sync with cloud – O client não tem permissão.
  • Not implemented for country – Apenas compatível com a Alemanha.

  Resposta

  • false – Todos os ficheiros já se encontram na Cloud; não é necessária qualquer ação adicional.
  • true – É necessário enviar um ou mais ficheiros; avance para o passo seguinte.

• Iniciar transferência para a Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Inicia o carregamento assíncrono do ficheiro.

  Erros possíveis

  • Todos os erros provenientes de isSyncRequired.
  • Insufficient rights – O client não consegue escrever no armazenamento na Cloud.
  Nota: O sucesso indica que o processo de carregamento foi iniciado; não garante a transferência imediata.
• Verifique se está completo
  Repita a chamada isSyncRequired .
  • Se false: Upload concluído.
  • Se ainda true: Aguarde um pouco e tente novamente até que todos os ficheiros tenham saído da fila.

Condições de acionamento

Esta rotina de sincronização deve ser executada quando:

• Uma transação tiver sido processada e
• O armazenamento em ficheiros ou na Cloud não tiver sido previamente ativado (ou seja, configuração inicial) ou
• Uma tentativa de sincronização anterior falhou e deixou ficheiros na fila local.

Este artigo foi traduzido automaticamente.