Tento koncový bod umožňuje obnovení klienta v Middleware RetailForce s daty (včetně konfiguračních informací) z RetailForce Cloud.
Obnovení klienta může být nutné v případě výměny hardwaru pokladny nebo v případě hardwarových závad.
Funkce POST /api/v1/management/clients/recovery/restoreByCloud je v podstatě identická s funkcí PUT /api/v1/management/clients/byCloud, avšak ta druhá může být provedena pouze jednou při počátečním uvedení klienta do provozu.
Výsledek
Úspěšné volání koncového bodu (200):
- Znovu stáhne konfigurační objekt pro příslušného klienta z Cloud systému a klienta podle něj nakonfiguruje.
- Obnoví klienta, který již byl uveden do provozu v middlewaru, a přiřadí mu odpovídající uniqueClientId terminálu z RetailForce Cloud.
Použití
Tento koncový bod se používá, když je třeba obnovit klienta, který již byl jednou vytvořen a jehož ClientId je známé (například v případě výměny hardwaru).
Předpoklady
- Klient musí být již jednou vytvořen a jeho ClientId by mělo být známo.
- V RetailForce Cloud byly vytvořeny organizační struktura a konfigurační objekt a byly odpovídajícím způsobem přiřazeny.
- Hodnoty „storeNumber“ a „terminalNumber“ jsou známy.
- Je známo „LicenseConsumerId“.
- Je nainstalován Fiscal Middleware.
- Funkci RestoreByCloud lze použít pouze v případě, že:
- je použita odpovídající licence (licenční balíček, který zahrnuje „Cloud Archive Access“),
- je v konfiguraci (Cloud) zaškrtnuto políčko „Cloud Archive“,
- klient již přenesl data do cloudového archivu (PŘED obnovením).
- V Německu musí být v klientovi zaznamenáno a do cloudového archivu přeneseno alespoň jedno denní uzavření (v jakémkoli okamžiku v minulosti).
Poznámka: Funkce RestoreByCloud bude fungovat správně pouze v případě, že
- byl middleware nově nainstalován na systému PŘED spuštěním funkce RestoreByCloud,
- nebo (bez přeinstalace) byla před spuštěním funkce RestoreByCloud restartována fiskalizační služba (služba RetailForce).
Pole formuláře
Je nutné zadat následující informace:
| Jméno | Popis | Příklady |
| LicenseConsumerId | ID organizace. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Číslo pobočky, ve které se pokladna nachází. Musí odpovídat údajům zadaným v RetailForce Cloud. Údaje o zemi:
|
|
| číslo terminálu | Číslo pokladny. Musí odpovídat údajům zadaným v RetailForce Cloud. | 0010 |
| cloudApiKey | API klíč pro ověření komunikace s Cloudem | RFC_4a2abc... |
| cloudApiSecret | Tajný klíč API pro ověření komunikace s Cloudem | ypts7u5OU... |
Odpověď
Možné odpovědi:
| Kód | Popis | Příklad |
| 200 | Klient byl úspěšně obnoven a nakonfigurován. Objekt odpovědi vrací identifikátor uniqueClientId obnoveného klienta. Identifikátor uniqueClientId musí být uložen v pokladním systému a použit pro celý další proces komunikace týkající se daného klienta. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Typ zadaného identifikátoru společnosti není jedinečný. Zpracování chyby: Použijte jeden z následujících identifikátorů společnosti: [0] = VatNumber, |
- |
Tento článek byl přeložen automaticky.
Komentáře
0 komentářů
Prosím přihlaste se, abyste mohli napsat komentář.