CloudSync – Retrimiterea datelor

Această documentație descrie modul de verificare și transfer al documentelor de sfârșit de zi. În prezent, această funcție este disponibilă numai pentru Germania.

Prezentare generală

Procesul de sincronizare în Cloud stochează în siguranță documentele de sfârșit de zi în Cloud și efectuează următoarele sarcini:

1. verifică dacă toate fișierele EOD necesare (documentul EOD generic și arhiva TAR specifică Germaniei) sunt prezente în spațiul de stocare din Cloud
2. transferă orice fișiere lipsă de pe clientul local în Cloud.

Cerințe preliminare

• Permisiune organizațională: aceasta trebuie activată pentru a retrimite datele. Activarea trebuie efectuată prin intermediul serviciului de asistență.
• Țara fiscală: În prezent, este disponibilă doar pentru Germania.
• Configurare: Căile de stocare a fișierelor locale și în Cloud trebuie configurate în RetailForce portal

Configurarea portalului

1. Conectați-vă la RetailForce portal.
2. Accesați Configurație → Configurație relevantă
3. Stocare fișiere
   1. Faceți clic pe + Storage path.
   2. Câmpul Storage path rămâne gol și nu necesită introducerea niciunui conținut.
4. Stocare în cloud
   1. Faceți clic pe + Storage path.
   2. Câmpul „Storage path” este, de asemenea, gol inițial.
5. Salvați modificările.

Fluxul de lucru al clientului

După generarea și înregistrarea unui EOD bazat pe tranzacții la client, trebuie efectuate următoarele apeluri api în ordinea indicată:

• POST de actualizare a configurației
  /api/v1/management/clients/byCloud/{clientId}
  Actualizează configurația și se asigură că middleware-ul utilizează căile curente de stocare în fișiere și în Cloud.
• CloudConnect
  POST /api/v1/management/cloud/connect
  Stabilește o conexiune la Cloud.
• Creare document de sfârșit
  de zi ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Creează documentul local de sfârșit de zi.
• Înregistrare sfârșit de zi
  POST /api/v1/transactions/storeDocument
  Înregistrează documentul EOD creat.

• Verifică cerințele
  de sincronizare GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Determină dacă mai există fișiere EOD în coada de mesaje locală.

  Erori posibile

  • EndOfDay required – Nu s-a găsit niciun document EOD; generați un document EOD!
  • CloudConnect required – Este necesar un apel CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Fișierele în așteptare trebuie încărcate.
  • Terminal is not allowed to sync with cloud – Clientul nu are permisiune.
  • Not implemented for country – Suportat numai pentru Germania.

  Răspuns

  • false – Toate fișierele se află deja în Cloud; nu este necesară nicio acțiune suplimentară.
  • true – Unul sau mai multe fișiere trebuie trimise; treceți la pasul următor.

• Începeți transferul către Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Inițiază încărcarea asincronă a fișierului.

  Erori posibile

  • Toate erorile din isSyncRequired.
  • Insufficient rights – Clientul nu poate scrie în spațiul de stocare din Cloud.
  Notă: Succesul indică faptul că procesul de încărcare a început; acesta nu garantează transferul imediat.
• Verificarea completitudinii
  Repetați apelul isSyncRequired .
  • Dacă false: Încărcarea s-a finalizat.
  • Dacă totuși true: Așteptați puțin și încercați din nou până când toate fișierele au ieșit din coadă.

Condiții de declanșare

Această rutină de sincronizare trebuie executată atunci când:

• A fost procesată o tranzacție și
• stocarea în fișiere sau stocarea în Cloud nu a fost activată anterior (adică, configurarea inițială) sau
• O încercare anterioară de sincronizare a eșuat și a lăsat fișiere în coada locală.

Acest articol a fost tradus automat.