CloudSync – Opětovné odeslání dat

Tato dokumentace popisuje, jak ověřovat a přenášet dokumenty na konci dne. V současné době je tato funkce podporována pouze pro Německo.

Přehled

Proces synchronizace v Cloudu bezpečně ukládá vaše dokumenty na konci dne do Cloudu a provádí následující úkoly:

1. zkontroluje, zda jsou v cloudovém úložišti přítomny všechny požadované soubory EOD (obecný dokument EOD a archiv TAR specifický pro Německo)
2. přenese chybějící soubory z lokálního klienta do Cloudu.

Předpoklady

• Organizační oprávnění: Pro opětovné odeslání dat musí být toto oprávnění povoleno. Aktivaci je nutné provést prostřednictvím podpory.
• Daňová země: V současné době je k dispozici pouze pro Německo.
• Konfigurace: V portálu RetailForce je nutné nakonfigurovat cesty k lokálnímu úložišti souborů a k cloudovému úložišti

Konfigurace portálu

1. Přihlaste se do portálu RetailForce.
2. Přejděte do části Konfigurace → Příslušná konfigurace
3. Úložiště souborů
   1. Klikněte na + Cesta k úložišti.
   2. Pole Cesta k úložišti zůstává prázdné a nevyžaduje žádný vstup.
4. Úložiště v cloudu
   1. Klikněte na + Cesta k úložišti.
   2. Pole Cesta k úložišti je zpočátku také prázdné.
5. Uložte změny.

Pracovní postup klienta

Po vygenerování a zaúčtování transakčního EOD na straně klienta je nutné provést následující volání API v daném pořadí:

• POST pro aktualizaci konfigurace
  /api/v1/management/clients/byCloud/{clientId}
  Aktualizuje konfiguraci a zajistí, že middleware používá aktuální cesty k úložišti souborů a Cloudu.
• CloudConnect
  POST /api/v1/management/cloud/connect
  Naváže připojení k Cloudu.
• Vytvoření EOD
  ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Vytvoří místní dokument EOD.
• Zaúčtování dokumentu na konci
  dne ( POST) /api/v1/transactions/storeDocument
  Zaúčtuje vytvořený dokument EOD.

• Zkontroluje požadavky
  na synchronizaci (GET) /api/v1/cloudsync/{clientId}/isSyncRequired
  Zjistí, zda se v místní frontě zpráv stále nacházejí soubory EOD.

  Možné chyby

  • EndOfDay required – Nebyl nalezen žádný dokument EOD; vygenerujte EOD!
  • CloudConnect required – Je nutné volání CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Je třeba nahrát soubory čekající na zpracování.
  • Terminal is not allowed to sync with cloud – Klient nemá oprávnění.
  • Not implemented for country – Podporováno pouze pro Německo.

  Odpověď

  • false – Všechny soubory jsou již v Cloudu; není třeba provádět žádné další kroky.
  • true – Je třeba odeslat jeden nebo více souborů; pokračujte dalším krokem.

• Spustit přenos do Cloudu
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Spustí asynchronní nahrávání souboru.

  Možné chyby

  • Všechny chyby z isSyncRequired.
  • Insufficient rights – Klient nemůže zapisovat do cloudového úložiště.
  Poznámka: Úspěšný výsledek znamená, že proces nahrávání byl zahájen; nezaručuje však okamžitý přenos.
• Ověření úplnosti
  Zopakujte volání isSyncRequired .
  • Pokud false: Nahrávání dokončeno.
  • Pokud stále true: Chvíli počkejte a zkuste to znovu, dokud všechny soubory neopustí frontu.

Podmínky spuštění

Tato synchronizační rutina by měla být spuštěna, když:

• Byla zpracována transakce a
• nebylo dříve povoleno ukládání souborů nebo ukládání do Cloudu (tj. při počátečním nastavení) nebo
• předchozí pokus o synchronizaci selhal a v místní frontě zůstaly soubory.

Tento článek byl přeložen automaticky.