CloudSync – Omsändning av data

Denna dokumentation beskriver hur man verifierar och överför dokument vid dagens slut. För närvarande stöds denna funktion endast för Tyskland.

Översikt

Molnsynkroniseringsprocessen lagrar dina dokument vid dagens slut säkert i Cloud och utför följande uppgifter:

1. kontrollerar om alla nödvändiga EOD-filer (det generiska EOD-dokumentet och det Tysklandsspecifika TAR-arkivet) finns i Cloud-lagringen
2. överför eventuella saknade filer från den lokala clienten till Cloud.

Förutsättningar

• Organisationsbehörighet: Denna måste vara aktiverad för att data ska kunna skickas på nytt. Aktivering måste utföras via supporten.
• Skatteland: För närvarande endast tillgängligt för Tyskland.
• Konfiguration: Sökvägarna till det lokala filarkivet och molnlagringen måste konfigureras i RetailForce portalen

Portalkonfiguration

1. Logga in på RetailForce portalen.
2. Gå till Konfiguration → Relevant konfiguration
3. Fil lagring
   1. Klicka på + Storage path.
   2. Fältet Storage path förblir tomt och kräver ingen inmatning.
4. Cloud storage
   1. Klicka på + Storage path.
   2. Fältet Storage path är också tomt från början.
5. Spara ändringarna.

Client Workflow

Efter att ha genererat och bokfört en transaktionsbaserad EOD hos klienten måste följande api-anrop göras i angiven ordning:

• Uppdatera konfiguration
  POST /api/v1/management/clients/byCloud/{clientId}
  Uppdaterar konfigurationen och säkerställer att middleware använder de aktuella sökvägarna till fil- och Cloud-storage paths.
• CloudConnect
  POST /api/v1/management/cloud/connect
  Upprättar en anslutning till Cloud.
• Skapa End-of-Day
  GET /api/v1/closing/{clientId}/endofdayDocument
  Skapar det lokala EOD-dokumentet.
• Boka slutdokument
  POST /api/v1/transactions/storeDocument
  Bokför det skapade EOD-dokumentet.

• Kontrollera synkroniseringskrav
  GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Kontrollerar om det fortfarande finns EOD-filer i den lokala meddelandekön.

  Möjliga fel

  • EndOfDay required – Inget EOD-dokument hittades; generera EOD!
  • CloudConnect required – CloudConnect-anrop krävs.
  • Files are in Message Queue (cloudTemp folder) – Väntande filer måste laddas upp.
  • Terminal is not allowed to sync with cloud – Client har inte behörighet.
  • Not implemented for country – Stöds endast för Tyskland.

  Svar

  • false – Alla filer finns redan i Cloud; inga ytterligare åtgärder krävs.
  • true – En eller flera filer måste skickas; gå vidare till nästa steg.

• Starta överföring till Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Initierar den asynkrona filuppladdningen.

  Möjliga fel

  • Alla fel från isSyncRequired.
  • Insufficient rights – Clients kan inte skriva till molnlagringen.
  Obs: Ett lyckat resultat indikerar att uppladdningsprocessen har startat; det garanterar inte omedelbar överföring.
• Kontrollera att överföringen är fullständig
  Upprepa anropet till isSyncRequired .
  • Om false: Uppladdningen är klar.
  • Om det fortfarande true: Vänta en stund och försök igen tills alla filer har lämnat kön.

Utlösande villkor

Denna synkroniseringsrutin ska köras när:

• En transaktion har bearbetats och
• fil- eller Cloud-lagring inte var aktiverad tidigare (dvs. vid den första konfigurationen) eller
• Ett tidigare synkroniseringsförsök misslyckades och lämnade kvar filer i den lokala kön.

Den här artikeln har översatts automatiskt.