Šis galinis taškas leidžia atkurti klientą (paskyrą) „RetailForce“ tarpinėje programinėje įrangoje, naudojant duomenis (įskaitant konfigūracijos informaciją) iš „RetailForce“ debesies.
Kliento atkūrimas gali būti reikalingas, pavyzdžiui, keičiant kasos aparatūros įrangą arba jos gedimo atveju.
Funkcija POST /api/v1/management/clients/recovery/restoreByCloud iš esmės yra identiška PUT /api/v1/management/clients/byCloud, tačiau pastaroji gali būti vykdoma tik vieną kartą, pirmą kartą paleidžiant klientą.
Rezultatas
Sėkmingas galinio taško iškvietimas (200):
- Iš naujo atsisiunčia atitinkamo kliento konfigūracijos objektą iš debesų sistemos ir atitinkamai konfigūruoja klientą.
- Atkuria anksčiau paleistą klientą tarpinėje programinėje įrangoje ir jam priskiria atitinkamą terminalo uniqueClientId iš „RetailForce Cloud“.
Naudojimas
Šis galinis taškas naudojamas, kai reikia atkurti klientą, kuris jau buvo sukurtas ir kurio ClientId yra žinomas (pavyzdžiui, keičiant aparatinę įrangą).
Reikalavimai
- Klientas turi būti jau sukurtas, o jo „ClientId“ – žinomas.
- Organizacijos struktūra ir konfigūracijos objektas buvo sukurti „RetailForce Cloud“ ir atitinkamai priskirti.
- Įdiegta „Fiskal“ tarpinė programinė įranga.
- „RestoreByCloud“ galima naudoti tik tuomet, jei:
- naudojama atitinkama licencija (licencijų paketas, į kurį įeina „Cloud Archive Access“),
- konfigūracijoje (debesyje) pažymėtas langelis „Cloud Archive“,
- klientas (PRIEŠ atkūrimą) jau yra perkėlęs duomenis į debesų archyvą.
- Vokietijoje kliente turi būti užregistruotas bent vienas dienos uždarymas (bet kuriuo praeities momentu) ir perduotas į debesų archyvą.
Pastaba: „RestoreByCloud“ veikia tinkamai tik tuomet, jei
- PRIEŠ „RestoreByCloud“ sistemoje buvo iš naujo įdiegta tarpinė programinė įranga,
- arba (be naujos įdiegos) fiskalizacijos paslauga (RetailForce paslauga) buvo paleista iš naujo prieš vykdant „RestoreByCloud“.
Formos laukeliai
Turi būti perduota ši informacija:
| Pavadinimas | Aprašymas | Pavyzdžiai |
| Tipas |
Įmonės identifikavimo tipas. Tipas taip pat turi būti įvestas ir egzistuoti „RetailForce Cloud“ sistemoje. Galimi šie tipai: [0] = PVM kodas, Taip pat žr.: Įmonės identifikavimas Rekomenduojame visose šalyse (ES) kaip pagrindinį identifikatorių naudoti tipą [0] = PVM kodas, net jei jis nėra privalomas įmonės identifikatorius atitinkamoje šalyje. |
[0] = PVM kodas |
| Identifikacija | Pats įmonės identifikatorius. Turi atitikti informaciją, įvestą į „RetailForce Cloud“. | ATU57780814 |
| storeNumber |
Filialo, kuriame yra kasos aparatas, numeris. Turi sutapti su informacija, įvestą į „RetailForce Cloud“.
DĖMESIO:
Prancūzijoje čia reikia nurodyti SIRET (SIREN su filialo numeriu).
|
|
| terminalNumber | Kaso numeris. Turi sutapti su informacija, įvestą į „RetailForce Cloud“. | 0010 |
| cloudApiKey | API raktas, skirtas autentiškumui patvirtinti bendraujant su debesimi | RFC_4a2abc... |
| cloudApiSecret | API raktas, skirtas autentiškumui patvirtinti debesų ryšyje | ypts7u5OU... |
Atsakymas
Galimi atsakymai:
| Kodas | Aprašymas | Pavyzdys |
| 200 | Klientas buvo sėkmingai atkurtas ir sukonfigūruotas. Kaip atsakymo objektas grąžinamas atkurto kliento uniqueClientId. UniqueClientId turi būti išsaugotas kasos sistemoje ir naudojamas visam tolesniam komunikacijos procesui (susijusiam su klientu) kasos sistemoje. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Nurodyto įmonės identifikatoriaus tipas nėra unikalus. Klaidų tvarkymas: Naudokite vieną iš šių įmonės identifikatorių: [0] = PVM kodas, |
- |
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite