Тази крайна точка позволява възстановяването на client в RetailForce Middleware с данни (включително информация за конфигурацията) от RetailForce Cloud.
Възстановяването на клиент може да се наложи в случай на смяна на хардуера на касовия апарат или при хардуерни дефекти.
Функцията POST /api/v1/management/clients/recovery/restoreByCloud/ID е по същество идентична с PUT /api/v1/management/clients/byCloud, но последната може да бъде изпълнена само веднъж по време на първоначалното пускане в експлоатация на client.
Резултат
Успешно извикване на крайната точка (200):
- Преизтегля обекта с конфигурацията за съответния client от Cloud системата и конфигурира клиента съответно.
- Възстановява клиент, който вече е пуснат в експлоатация в middleware-то, и му присвоява съответния uniqueClientId на терминала от RetailForce Cloud.
Употреба
Този краен пункт се използва, когато клиент, който вече е бил създаден веднъж и чийто clientId е известен, трябва да бъде възстановен (например в случай на смяна на хардуера).
Предпоставки
- The client must have been created at least once and the clientId must be known.
- Организационната структура и конфигурационният обект са създадени в RetailForce Cloud и са съответно присвоени.
- Инсталиран е Fiscal middleware.
- restoreByCloud може да се използва само ако:
- се използва съответната лицензия (лицензионен пакет, който включва „Cloud Archive Access“),
- в конфигурацията (Cloud) е активирана checkbox-та „Cloud Archive“,
- клиентът вече е прехвърлил данни в облачния архив (ПРЕДИ възстановяването).
- 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.
Полета във формуляра
Трябва да бъде предадена следната информация:
| Име | Описание | Примери |
| Тип |
Тип на идентификацията на компанията. Типът също трябва да бъде въведен и да съществува в RetailForce Cloud. Налични са следните типове: [0] = VatNumber, Вижте също: Идентификация на фирмата Препоръчваме да използвате тип [0] = VatNumber като основен ID във всички държави (ЕС), дори ако той не се използва като задължителен ID на фирмата в съответната държава. |
[0] = VatNumber |
| Идентификация | Самият идентификатор на дружеството. Той трябва да съответства на информацията, въведена в RetailForce Cloud. | ATU57780814 |
| storeNumber |
Номерът на магазина, в който се намира касовият апарат. Той трябва да съвпада с информацията, въведена в RetailForce Cloud.
ЗАБЕЛЕЖКА:
във Франция тук трябва да се посочи SIRET (разширение на SIREN с номера на магазина).
|
|
| 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 коментара
Влезте в услугата, за да оставите коментар.