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égessé válhat pénztárgép-hardver cseréje vagy hardverhibák esetén.
A POST /api/v1/management/clients/recovery/restoreByCloud/ID funkció lényegében megegyezik a PUT /api/v1/management/clients/byCloud funkcióval, azonban az utóbbi csak egyszer hajtható végre az ügyfél kezdeti üzembe helyezése során.
Eredmény
A végpont sikeres meghívása (200):
- Újra letölti a Cloud-rendszerből az érintett client konfigurációs objektumát, és ennek megfelelően konfigurálja a client-t.
- 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 kliens helyreállítására van szükség (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 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 the 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 másolni a Cloud-alapú archívumba.
Megjegyzés: restoreByCloud csak akkor fog megfelelően működni, ha
- a 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 továbbítani:
| Név | Leírás | Példák |
| Típus |
A vállalati azonosító típusa. A típust is meg kell adni, és annak szerepelnie kell a RetailForce Cloud rendszerben. A következő típusok állnak rendelkezésre: [0] = VatNumber, Lásd még: Vállalati azonosító Javasoljuk, hogy minden országban (EU) a [0] = VatNumber típust használja elsődleges ID-ként, még akkor is, ha az adott országban ez nem kötelező vállalati ID. |
[0] = VatNumber |
| Azonosító | Maga a vállalati azonosító. Meg kell egyeznie a RetailForce Cloudba bevitt adatokkal. | ATU57780814 |
| storeNumber |
Az a bolt száma, ahol a pénztárgép található. Ennek meg kell egyeznie a RetailForce Cloudba bevitt adatokkal.
MEGJEGYZÉS:
Franciaországban itt a SIRET-számot (a SIREN-szám az üzlet számával kiegészítve) kell megadni.
|
|
| terminalNumber | Pénztárgép száma. Ennek meg kell egyeznie a RetailForce Cloudba bevitt adatokkal. | 0010 |
| cloudApiKey | A Cloud-vel való kommunikáció hitelesítéséhez szükséges API-kulcs | RFC_4a2abc... |
| cloudApiSecret | A Cloud 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 a további kommunikációs folyamat során (az ügyféllel kapcsolatban) végig használnia kell. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
A megadott vállalati azonosító típusa nem egyedi típus. 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.