Ez a végpont lehetővé teszi egy client helyreállítását a RetailForce Middleware-ben a RetailForce Cloudból származó adatokkal (beleértve a konfigurációs információkat is).
A client visszaállítása szükséges lehet a pénztárgép hardverének cseréje vagy hardverhibák esetén.
A POST /api/v1/management/clients/recovery/restoreByCloud funkció lényegében megegyezik a PUT /api/v1/management/clients/byCloud funkcióval, de az utóbbi csak egyszer hajtható végre, az ügyfél kezdeti üzembe helyezésekor.
Eredmény
A végpont sikeres meghívása (200):
- Újra letölti a vonatkozó client konfigurációs objektumát a Cloud-rendszerből, és ennek megfelelően konfigurálja a klienst.
- Visszaállítja a middleware-ben már üzembe helyezett klienst, és hozzárendeli hozzá a RetailForce Cloudból származó terminal megfelelő uniqueClientId azonosítóját.
Használat
Ezt a végpontot akkor használjuk, ha egy már egyszer létrehozott, és clientId-je ismert clienst vissza kell állítani (például hardvercsere esetén).
Előfeltételek
- Az ügyfelet korábban már létre kellett hozni, és a clientId-nek ismertnek kell lennie.
- A szervezeti struktúrát és a konfigurációs objektumot létrehozták a RetailForce Cloudban, és azokat megfelelően hozzárendelték.
- A „storeNumber” és a „terminalNumber” értékek ismertek.
- A „LicenseConsumerId” ismert.
- A Fiscal middleware telepítve van.
- RestoreByCloud csak akkor használható, ha:
- megfelelő licencet használnak (olyan licenccsomagot, amely tartalmazza a „Cloud Archive Access” elemet),
- a konfigurációban (Cloud) be van jelölve a „Cloud Archive” checkbox,
- the client already transferred data to the cloud archive (before the restoration).
- In Germany, legalább egy napi zárást (a múlt bármely időpontjából) regisztrálni kellett a clientnél, és azt át kellett vinni a Cloud-archívumba.
Megjegyzés: restoreByCloud csak akkor fog megfelelően működni, ha
- restoreByCloud futtatása ELŐTT újra telepítették a middleware-t a rendszerre,
- vagy (újratelepítés nélkül) a fiskalizációs szolgáltatást (RetailForce szolgáltatás) újraindították a restoreByCloud futtatása előtt.
Űrlapmezők
A következő információkat kell megadni:
| Név | Leírás | Példák |
| LicenseConsumerId | A szervezet ID-ja. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
A pénztárgép helye szerinti fiók száma. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal. Országadatok:
|
|
| terminalNumber | Pénztárgép száma. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal. | 0010 |
| cloudApiKey | A Cloud-kommunikáció hitelesítéséhez szükséges API-kulcs | RFC_4a2abc... |
| cloudApiSecret | A felhőalapú kommunikáció hitelesítéséhez szükséges API Secret | ypts7u5OU... |
Válasz
Lehetséges válaszok:
| Kód | Leírás | Példa |
| 200 | Az ügyfél visszaállítása és konfigurálása sikeresen megtörtént. A válaszobjektum visszaadja a visszaállított client uniqueClientId azonosítóját. Az uniqueClientId azonosítót a pénztárgép-rendszernek el kell mentenie, és azt az ügyféllel kapcsolatos további kommunikáció során végig használnia kell. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
A megadott vállalati azonosító típusa nem egyedi. Hibakezelés: Használja az alábbi cégazonosítók egyikét: [0] = VatNumber, |
- |
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.