Tento koncový bod umožňuje obnovenie klienta v prostredí RetailForce Middleware s údajmi (vrátane konfiguračných informácií) z RetailForce Cloud.
Obnovenie klienta môže byť potrebné v prípade výmeny hardvéru pokladnice alebo v prípade poruchy hardvéru.
Funkcia POST /api/v1/management/clients/recovery/restoreByCloud/ID je v podstate identická s funkciou PUT /api/v1/management/clients/byCloud, avšak táto funkcia sa môže vykonať len raz počas počiatočného uvedenia klienta do prevádzky.
Výsledok
Úspešné volanie koncového bodu (200):
- Znovu stiahne konfiguračný objekt pre príslušného klienta z Cloud systému a klienta podľa toho nakonfiguruje.
- Obnoví klienta, ktorý už bol uvedený do prevádzky v middleware, a priradí mu príslušné uniqueClientId terminálu z RetailForce Cloud.
Použitie
Tento koncový bod sa používa v prípade, ak je potrebné obnoviť klienta, ktorý už bol raz vytvorený a ktorého clientId je známy (napríklad v prípade zmeny hardvéru).
Predpoklady
- Klient musí byť už raz vytvorený a clientId by malo byť známe.
- V službe RetailForce Cloud boli vytvorené organizačná štruktúra a konfiguračný objekt a boli príslušne priradené.
- Nainštalovaný je Fiscal Middleware.
- Funkcia restoreByCloud sa dá použiť len vtedy, ak:
- sa používa príslušná licencia (licenčný balík, ktorý obsahuje „Cloud Archive Access“),
- je v konfigurácii (Cloud) zaškrtnutá checkbox „Cloud Archive“,
- client už preniesol údaje do cloudového archívu (PRED obnovením).
- V Nemecku musí byť v clientovom systéme zaznamenané aspoň jedno denné uzávierkové vyúčtovanie (z akéhokoľvek obdobia v minulosti) a prenesené do cloudového archívu.
Poznámka: Funkcia restoreByCloud bude fungovať správne len vtedy, ak
- middleware nanovo nainštalovaný v systéme PRED spustením funkcie restoreByCloud,
- alebo (bez preinštalovania) bola pred spustením funkcie restoreByCloud reštartovaná služba fiskalizácie (služba RetailForce).
Polia formulára
Musí sa odoslať nasledujúce informácie:
| Názov | Popis | Príklady |
| Typ |
Typ identifikácie spoločnosti. Typ sa musí tiež zadať a musí existovať v RetailForce Cloud. K dispozícii sú nasledujúce typy: [0] = VatNumber, Pozri tiež: Identifikácia spoločnosti Odporúčame používať typ [0] = VatNumber ako primárne ID vo všetkých krajinách (EÚ), aj keď sa v danej krajine nepoužíva ako povinný identifikátor spoločnosti. |
[0] = VatNumber |
| Identifikácia | Samotný identifikátor spoločnosti. Musí zodpovedať informáciám, ktoré boli zadané v RetailForce Cloud. | ATU57780814 |
| storeNumber |
Číslo predajne, v ktorej sa nachádza pokladňa. Musí zodpovedať informáciám zadaným v RetailForce Cloud.
POZNÁMKA:
vo Francúzsku by sa tu malo uviesť číslo SIRET (rozšírenie čísla SIREN o číslo predajne).
|
|
| terminalNumber | Číslo pokladnice. Musí sa zhodovať s informáciami, ktoré boli zadané v RetailForce Cloud. | 0010 |
| cloudApiKey | Kľúč API na overenie komunikácie s Cloudom | RFC_4a2abc... |
| cloudApiSecret | API Secret na overenie komunikácie s Cloudom | ypts7u5OU... |
Odpoveď
Možné odpovede:
| Kód | Popis | Príklad |
| 200 | Klient bol úspešne obnovený a nakonfigurovaný. Objekt odpovede vráti uniqueClientId obnoveného klienta. uniqueClientId musí byť uložený v pokladničnom systéme a používaný počas celého ďalšieho komunikačného procesu (týkajúceho sa klienta). | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Typ zadaného identifikátora spoločnosti nie je jedinečný. Riešenie chyby: Použite jeden z nasledujúcich identifikátorov spoločnosti: [0] = VatNumber, |
- |
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.