CloudSync – Повторно изпращане на данни

Настоящата документация описва как да се проверяват и прехвърлят документи в края на деня. Към момента тази функция се поддържа само за Германия.

Общ преглед

Процесът на синхронизация в Cloud съхранява безопасно вашите документи за края на деня в Cloud и изпълнява следните задачи:

1. проверява дали всички необходими файлове за края на деня (общият документ за края на деня и специфичният за Германия TAR архив) са налице в облачното хранилище
2. прехвърля липсващите файлове от локалния client в Cloud.

Предпоставки

• Организационно разрешение: То трябва да бъде активирано, за да се изпращат данни повторно. Активирането трябва да се извърши чрез отдела за поддръжка.
• Държава за данъчни цели: Към момента е налично само за Германия.
• Конфигурация: Пътищата към локалното хранилище на файлове и към облачното хранилище трябва да бъдат конфигурирани в портала на RetailForce

Конфигурация на портала

1. Влезте в RetailForce portal.
2. Отидете в „Конфигурация“ → „Съответна конфигурация“
3. Съхранение на файлове
   1. Кликнете върху + Storage path.
   2. Полето „Storage path“ остава празно и не изисква въвеждане на данни.
4. Съхранение в облак
   1. Кликнете върху „+ Storage path“.
   2. Полето „Storage path“ също е празно в началото.
5. Запазете промените.

Работен поток на клиента

След генериране и публикуване на EOD на базата на транзакции от страна на клиента, трябва да бъдат извършени следните api повиквания в посочения ред:

• POST за актуализиране на конфигурацията
  /api/v1/management/clients/byCloud/{clientId}
  Актуализира конфигурацията и гарантира, че middleware-ът използва текущите Storage paths към файловото и Cloud хранилище.
• CloudConnect
  POST /api/v1/management/cloud/connect
  Установява връзка с Cloud.
• Създаване на EOD
  GET /api/v1/closing/{clientId}/endofdayDocument
  Създава локалния документ за края на деня.
• Записване на „Край
  на деня“ ( POST) /api/v1/transactions/storeDocument
  Записва създадения документ за края на деня.

• Проверява изискването
  за синхронизация GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Проверява дали все още има файлове за края на деня в локалната опашка за съобщения.

  Възможни грешки

  • EndOfDay required – Не е намерен документ „EOD“; генерирайте „EOD“!
  • CloudConnect required – Необходимо е извикване на CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Файловете в очакване трябва да бъдат качени.
  • Terminal is not allowed to sync with cloud – The client does not have permission.
  • Not implemented for country – Поддържа се само за Германия.

  Отговор

  • false – Всички файлове вече са в Cloud; не се изискват допълнителни действия.
  • true – Един или повече файлове трябва да бъдат изпратени; преминете към следващата стъпка.

• Започнете прехвърляне към Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Започва асинхронното качване на файлове.

  Възможни грешки

  • Всички грешки от isSyncRequired.
  • Insufficient rights – Клиентът не може да записва в облачното хранилище.
  Забележка: Успехът показва, че процесът на качване е започнал; това не гарантира незабавен трансфер.
• Проверка за пълнота
  Повторете извикването на isSyncRequired .
  • Ако false: Качването е завършено.
  • Ако все още true: Изчакайте малко и опитайте отново, докато всички файлове не напуснат опашката.

Условия за задействане

Тази рутина за синхронизация трябва да се изпълни, когато:

• Транзакцията е била обработена и
• съхранението на файлове или съхранението в Cloud не е било активирано преди това (т.е. при първоначалната настройка) или
• Предишен опит за синхронизация е завършил неуспешно и е оставил файлове в локалната опашка.

Тази статия е преведена автоматично.