CloudSync – duomenų persiuntimas

Šioje dokumentacijoje aprašomas dienos pabaigos dokumentų (End-of-Day Document) tikrinimas ir perdavimas. Ši funkcija šiuo metu palaikoma tik Vokietijoje.

Apžvalga

Debesų sinchronizavimo procesas užtikrina saugų jūsų dienos pabaigos dokumentų saugojimą mūsų debesyje ir atlieka šias užduotis:

1. Patikrina, ar debesų saugykloje yra visi reikalingi EOD failai (bendrasis EOD dokumentas ir Vokietijai būdingas TAR archyvas)
2. trūkstamų failų perkėlimas iš vietinio kliento į debesį.

Reikalavimai

• Organizacijos leidimas: norint pakartotinai siųsti duomenis, jis turi būti aktyvuotas. Aktyvuoti leidimą turi techninis palaikymas.
• Fiskalinė šalis : šiuo metu prieinama tik Vokietijoje.
• Konfigūracija : vietinės failų saugyklos ir debesų saugyklos keliai turi būti sukonfigūruoti „RetailForce“ portale.

Portalo konfigūracija

1. Prisijunkite prie „RetailForce“ portalo.
2. Navigacija į „Configuration“ → Atitinkama konfigūracija
3. „File storage“
   1. spustelėkite „+“ ir „Storage path“.
   2. Laukelis „Saugojimo kelias“ lieka tuščias ir nereikia įvesti jokių duomenų.
4. Debesų saugykla
   1. Spustelėkite „+“ ir „Saugojimo kelias“.
   2. Čia taip pat laukas „Saugojimo kelias“ iš pradžių yra tuščias.
5. Išsaugokite pakeitimus.

Kliento darbo eiga

Sukūrus ir užregistravus sandorių pagrįstą EOD kliente, reikia atlikti šiuos API iškvietimus nurodyta tvarka:

• Atnaujinti
  konfigūraciją POST /api/v1/management/clients/byCloud/{clientId}
  Atnaujina konfigūraciją ir užtikrina, kad tarpinė programinė įranga naudotų dabartinius failų ir debesies saugyklos kelius.
• „CloudConnect“
  POST /api/v1/management/cloud/connect
  Užmezga ryšį su debesimi.
• Sukurti
  dienos uždarymą GET /api/v1/closing/{clientId}/endofdayDocument
  Sukuria vietinį EoD dokumentą.
• Įrašyti
  dienos uždarymą POST /api/v1/transactions/storeDocument
  Įrašo sukurtą EoD dokumentą.

• Patikrinti
  sinchronizavimo užklausą GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Nustato, ar vietinėje pranešimų eilėje dar yra EoD failų.

  Galimos klaidos

  • EndOfDay required – EoD dokumento nerasta; sukurti EoD!
  • CloudConnect required – Reikia sėkmingo „CloudConnect“ iškvietimo.
  • Files are in Message Queue (cloudTemp folder) – Reikia įkelti laukiančius failus.
  • Terminal is not allowed to sync with cloud – Klientas neturi leidimo.
  • Not implemented for country – Palaikoma tik Vokietijoje.

  Atsakymas

  • false – Visi failai jau yra debesyje; jokių papildomų veiksmų nereikia.
  • true – Reikia išsiųsti vieną ar kelis failus; reikia pereiti prie kito žingsnio.

• Pradėti
  perdavimą į debesį POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Pradeda asinchroninį failų įkėlimą.

  Galimos klaidos

  • Visos „isSyncRequired“ klaidos.
  • Insufficient cloud-store rights – Klientas negali rašyti į debesų saugyklą.
  Pastaba: sėkmė reiškia, kad įkėlimo procesas buvo pradėtas; tai negarantuoja, kad perdavimas įvyks iš karto.
• Patikrinti
  išsamumą Pakartoti „isSyncRequired“ iškvietą.
  • Jei false: įkėlimas baigtas.
  • Jei dar true: trumpas laukimo laikas ir pakartotinis bandymas, kol visi failai išeis iš eilės.

Sąlygos

Ši sinchronizavimo procedūra turėtų būti vykdoma, jei:

• buvo apdorota transakcija ir
• Anksčiau nebuvo įjungtas failų saugojimas arba debesų saugojimas (t. y. pirminis nustatymas) arba
• Ankstesnis sinchronizavimo bandymas nepavyko ir failai liko vietinėje eilėje.