CloudSync – ponowne wysyłanie danych

Niniejsza dokumentacja opisuje sposób weryfikacji i przesyłania dokumentów podsumowujących dzień. Obecnie funkcja ta jest obsługiwana wyłącznie w Niemczech.

Przegląd

Proces synchronizacji w Cloud zapewnia bezpieczne przechowywanie Państwa dokumentów podsumowujących dzień w Cloud oraz wykonuje następujące zadania:

1. sprawdza, czy wszystkie wymagane pliki EOD (ogólny dokument EOD oraz archiwum TAR specyficzne dla Niemiec) znajdują się w pamięci chmurowej
2. przesyła wszelkie brakujące pliki z lokalnego klienta do Cloud.

Wymagania wstępne

• Uprawnienia organizacyjne: Muszą być włączone, aby umożliwić ponowne wysłanie danych. Aktywację należy przeprowadzić za pośrednictwem działu wsparcia technicznego.
• Kraj podatkowy: Obecnie funkcja ta jest dostępna wyłącznie dla Niemiec.
• Konfiguracja: Należy skonfigurować ścieżki do lokalnej pamięci plików oraz pamięci w chmurze w portalu RetailForce

Konfiguracja portalu

1. Zaloguj się do RetailForce portalu.
2. Przejdź do sekcji Konfiguracja → Odpowiednia konfiguracja
3. Magazyn plików
   1. Proszę kliknąć przycisk + Storage path.
   2. Pole „Storage path” pozostaje puste i nie wymaga wprowadzania danych.
4. Przechowywanie w chmurze
   1. Proszę kliknąć przycisk „+ Storage path”.
   2. Pole „Storage path” jest początkowo również puste.
5. Zapisz zmiany.

Przebieg operacji po stronie klienta

Po wygenerowaniu i zaksięgowaniu raportu EOD opartego na transakcjach u klienta należy wykonać następujące wywołania api w podanej kolejności:

• POST aktualizacji konfiguracji
  /api/v1/management/clients/byCloud/{clientId}
  Aktualizuje konfigurację i zapewnia, że middleware korzysta z aktualnych ścieżek do magazynu plików i magazynu w chmurze.
• POST do CloudConnect
  /api/v1/management/cloud/connect
  Nawiązuje połączenie z Cloud.
• Utwórz raport na koniec
  dnia ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Tworzy lokalny dokument podsumowania dnia.
• Zapisanie dokumentu podsumowania
  dnia – POST /api/v1/transactions/storeDocument
  Księguje utworzony dokument EOD.

• Sprawdź wymóg
  synchronizacji (GET) /api/v1/cloudsync/{clientId}/isSyncRequired
  Sprawdza, czy w lokalnej kolejce komunikatów nadal znajdują się pliki EOD.

  Możliwe błędy

  • EndOfDay required – Nie znaleziono dokumentu EOD; należy wygenerować dokument EOD!
  • CloudConnect required – Wymagane wywołanie CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Należy przesłać pliki oczekujące.
  • Terminal is not allowed to sync with cloud – Client nie posiada uprawnień.
  • Not implemented for country – Obsługiwane wyłącznie w Niemczech.

  Odpowiedź

  • false – Wszystkie pliki znajdują się już w Cloud; nie są wymagane żadne dalsze działania.
  • true – Należy przesłać jeden lub więcej plików; proszę przejść do następnego kroku.

• Rozpocznij przesyłanie do Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Rozpoczyna asynchroniczne przesyłanie plików.

  Możliwe błędy

  • Wszystkie błędy z isSyncRequired.
  • Insufficient rights – Client nie może zapisywać danych w pamięci w chmurze.
  Uwaga: Pomyślny wynik oznacza, że proces przesyłania został rozpoczęty; nie gwarantuje to jednak natychmiastowego przesłania danych.
• Sprawdź kompletność
  Powtórz wywołanie funkcji isSyncRequired .
  • Jeśli false: Przesyłanie zakończone.
  • Jeśli nadal true: Proszę chwilę poczekać i ponawiać próbę, aż wszystkie pliki opuszczą kolejkę.

Warunki uruchomienia

Ta procedura synchronizacji powinna zostać wykonana, gdy:

• Transakcja została przetworzona oraz
• przechowywanie plików lokalne lub w Cloud nie było wcześniej włączone (tj. podczas wstępnej konfiguracji) lub
• Poprzednia próba synchronizacji zakończyła się niepowodzeniem i pozostawiła pliki w kolejce lokalnej.

Ten artykuł został przetłumaczony automatycznie.