Acest punct final permite recuperarea unui client în RetailForce Middleware, cu date (inclusiv informații de configurare) din RetailForce Cloud.
Recuperarea unui client poate fi necesară în cazul schimbării hardware-ului casei de marcat sau al defectării acestuia.
Funcția POST /api/v1/management/clients/recovery/restoreByCloud este, în esență, identică cu PUT /api/v1/management/clients/byCloud, dar aceasta din urmă poate fi efectuată o singură dată, la punerea inițială în funcțiune a unui client.
Rezultat
Un apel reușit către punctul final (200):
- Re-descarcă obiectul de configurare pentru clientul respectiv din sistemul Cloud și configurează clientul în consecință.
- Restabilește un client care a fost deja pus în funcțiune în middleware și îi atribuie ID-ul unic al terminalului (uniqueClientId) corespunzător din RetailForce Cloud.
Utilizare
Acest punct final este utilizat atunci când un client, care a fost deja creat o dată și al cărui clientId este cunoscut, trebuie restaurat (de exemplu, în cazul schimbării hardware-ului).
Condiții preliminare
- Clientul trebuie să fi fost creat o dată, iar clientId-ul său trebuie să fie cunoscut.
- Structura organizațională și obiectul de configurare au fost create în RetailForce Cloud și atribuite corespunzător.
- „storeNumber” și „terminalNumber” sunt cunoscute.
- „LicenseConsumerId” este cunoscut.
- Fiscal Middleware este instalat.
- restoreByCloud poate fi utilizat numai dacă:
- se utilizează o licență corespunzătoare (pachet de licențe care include „Cloud Archive Access”),
- checkbox-ul „Cloud Archive” este bifat în configurație (Cloud),
- clientul a transferat deja date în arhiva Cloud (ÎNAINTE de restaurare).
- În Germania, cel puțin o închidere zilnică (din orice moment din trecut) trebuie să fi fost înregistrată în client și transferată în arhiva Cloud.
Notă: restoreByCloud va funcționa corect numai dacă
- middleware-ul a fost instalat recent pe sistem ÎNAINTE de rularea restoreByCloud,
- sau (fără reinstalare) serviciul de fiscalizare (serviciul RetailForce) a fost repornit înainte de rularea restoreByCloud.
Câmpuri ale formularului
Trebuie furnizate următoarele informații:
| Nume | Descriere | Exemple |
| LicenseConsumerId | ID-ul organizației. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Numărul sucursalei în care se află casa de marcat. Trebuie să corespundă informațiilor introduse în RetailForce Cloud. Detalii privind țara:
|
|
| terminalNumber | Numărul casei de marcat. Trebuie să corespundă informațiilor introduse în RetailForce Cloud. | 0010 |
| cloudApiKey | Cheie API pentru autentificarea comunicării cu Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret pentru autentificarea comunicării cu Cloud | ypts7u5OU... |
Răspuns
Răspunsuri posibile:
| Cod | Descriere | Exemplu |
| 200 | Clientul a fost restaurat și configurat cu succes. Obiectul de răspuns returnează uniqueClientId-ul clientului restaurat. UniqueClientId-ul trebuie stocat de sistemul de casă de marcat și utilizat pentru întregul proces de comunicare ulterioară referitor la client. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Tipul identificatorului companiei furnizat nu este un tip unic. Gestionarea erorilor: Utilizați unul dintre următorii identificatori de companie: [0] = VatNumber, |
- |
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.