Тази крайна точка позволява възстановяването на client в RetailForce Middleware с данни (включително информация за конфигурацията) от RetailForce Cloud.
Възстановяването на клиент може да се наложи в случай на смяна на хардуера на касовия апарат или при хардуерни дефекти.
Функцията POST /api/v1/management/clients/recovery/restoreByCloud е по същество идентична с PUT /api/v1/management/clients/byCloud, но последната може да се изпълни само веднъж при първоначалното пускане в експлоатация на клиент.
Резултат
Успешно извикване на крайната точка (200):
- Преизтегля обекта с конфигурацията за съответния client от Cloud системата и конфигурира клиента съответно.
- Възстановява клиент, който вече е пуснат в експлоатация в middleware-то и му присвоява съответния uniqueClientId на терминала от RetailForce Cloud.
Употреба
Този краен пункт се използва, когато client, който вече е бил създаден веднъж и чийто clientId е известен, трябва да бъде възстановен (например в случай на смяна на хардуера).
Предпоставки
- Клиентът трябва да е бил създаден поне веднъж и clientId трябва да е известен.
- Организационната структура и конфигурационният обект са създадени в RetailForce Cloud и са присвоени съответно.
- „storeNumber“ и „terminalNumber“ са известни.
- „LicenseConsumerId“ е известен.
- Fiscal middleware е инсталиран.
- restoreByCloud може да се използва само ако:
- се използва съответната лицензия (лицензионен пакет, включващ „Cloud Archive Access“),
- в конфигурацията (Cloud) е активирана checkbox-та „Cloud Archive“,
- the client has already transferred data to the Cloud archive (PREVIOUS TO restoration).
- In Germany, in the client, there must be a record of at least one daily closure (in any previous moment) that has been transferred to the Cloud archive.
Забележка: restoreByCloud ще функционира правилно само ако
- middleware-ът е бил наскоро инсталиран на системата ПРЕДИ стартирането на restoreByCloud,
- или (без преинсталиране) услугата за фискализация (услугата RetailForce) е била рестартирана преди стартирането на restoreByCloud.
Полета във формуляра
Трябва да бъде подадена следната информация:
| Име | Описание | Примери |
| LicenseConsumerId | ID на организацията. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Номерът на клона, в който се намира касовият апарат. Трябва да съвпада с информацията, въведена в RetailForce Cloud. Данни за държавата:
|
|
| terminalNumber | Номер на касовия апарат. Трябва да съвпада с информацията, въведена в RetailForce Cloud. | 0010 |
| cloudApiKey | API ключ за удостоверяване на комуникацията с Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret за удостоверяване на комуникацията с Cloud | ypts7u5OU... |
Отговор
Възможни отговори:
| Код | Описание | Пример |
| 200 | Клиентът е успешно възстановен и конфигуриран. Обектът на отговора връща uniqueClientId на възстановения клиент. uniqueClientId трябва да бъде съхранен от касовата система и да се използва за целия по-нататъшен процес на комуникация, отнасящ се до клиента. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Типът на предоставения идентификатор на фирмата не е уникален. Обработка на грешки: Използвайте един от следните идентификатори на фирмата: [0] = VatNumber, |
- |
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.